# AgentTokenUpdate

> The AgentTokenUpdate 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/) |  |
| `approval_channel` | array of [ApprovalChannel](/docs/api/objects/approval-channel/) |  |

\* always present

## Example

```json
{
  "name": "string",
  "description": "string",
  "scopes": [
    "deploy:staging"
  ],
  "projects": [
    "string"
  ],
  "environments": [
    "string"
  ],
  "budget": {
    "spend_increase_per_day": {
      "amount": "7.42",
      "currency": "GBP",
      "display": "£7.42"
    },
    "max_deploys_per_hour": 1
  },
  "approval_channel": [
    "push"
  ]
}
```

## Used by

- [Change an agent token's scopes, environments, budget or channel](/docs/api/agent-tokens/#change-an-agent-tokens-scopes-environments-budget-or-channel)