# EnvironmentCreate

> The EnvironmentCreate object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `name` * | string |  |
| `kind` | `production`, `staging`, `preview`, `development` |  |
| `branch` | string |  |
| `clone_from` | string | Environment to copy services, plain variables and settings from. Secrets are not copied. |
| `pull_requests` | boolean |  |
| `ttl` | string |  |
| `protection` | [EnvironmentProtection](/docs/api/objects/environment-protection/) |  |
| `databases_mode` | `new`, `branch`, `branch-masked` |  |
| `spend_cap` | [Money](/docs/api/objects/money/) |  |

\* always present

## Example

```json
{
  "name": "string",
  "kind": "production",
  "branch": "string",
  "clone_from": "string",
  "pull_requests": false,
  "ttl": "string",
  "protection": {
    "require_approval": false,
    "approver_roles": [
      "owner",
      "admin"
    ],
    "allowed_branches": [
      "string"
    ]
  },
  "databases_mode": "new",
  "spend_cap": {
    "amount": "7.42",
    "currency": "GBP",
    "display": "£7.42"
  }
}
```

## Used by

- [Create an environment](/docs/api/environments/#create-an-environment)
