# AgentTokenCreate

> The AgentTokenCreate object in the Guv API.

## Fields

| Field | Type | Description |
| --- | --- | --- |
| `name` * | string |  |
| `description` | string |  |
| `scopes` * | array of [Scope](/docs/api/objects/scope/) |  |
| `projects` | array of string or null |  |
| `environments` * | array of string |  |
| `budget` | [AgentTokenBudget](/docs/api/objects/agent-token-budget/) |  |
| `expires_in` | string | Lifetime, at most 365d. Default `30d`. |
| `approval_channel` | array of [ApprovalChannel](/docs/api/objects/approval-channel/) | Default `["push","email"]`. |

\* always present

## Example

```json
{
  "name": "claude-code-on-stewart-laptop",
  "scopes": [
    "projects:read",
    "deploy:preview",
    "deploy:staging",
    "logs:read",
    "secrets:write-only",
    "db:branch"
  ],
  "environments": [
    "preview",
    "staging"
  ],
  "budget": {
    "spend_increase_per_day": {
      "amount": "10.00",
      "currency": "GBP"
    }
  },
  "expires_in": "30d",
  "approval_channel": [
    "push",
    "email"
  ]
}
```

## Used by

- [Create an agent token](/docs/api/agent-tokens/#create-an-agent-token)