---
title: Deployments tab
description: Manage deployment-scoped API tokens for an agent.
editUrl: true
head: []
template: doc
sidebar:
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

Each deployment-scoped token grants programmatic access for this agent in one environment, with the agent identity built in — SDK calls authenticated with one of these tokens can omit the agent identifier. The tokens listed here cover all [agent deployments](/platform/concepts/agent-deployment) for this agent.

## Deployment tokens table

Each row shows:

- **Token** -- the token's scope, status badge, and the deployment it belongs to (agent name and environment).
- **Created** / **Expires** / **Last used** / **Created by** -- token metadata.
- A row action menu, scoped to the token's current state.

## Creating a deployment token

1. Open the agent's **Deployments** tab.
2. Select **Create deployment token**.
3. Pick the target environment.
4. Confirm to create the token. Copy the value when shown -- it is only displayed once.

Tokens created here are deployment-scoped. To create an account-wide token instead, see [Account › API tokens tab](/admin-ui/account/api-tokens).

## Token actions

Available actions depend on the token's current state:

- **Suspend** -- on an active token. Disables it without deleting it.
- **Activate** -- on a suspended token. Re-enables it.
- **Revoke** -- on an active or suspended token. Permanently invalidates it. A revoked token cannot be re-enabled.
- **Delete** -- on a revoked token. Removes the row from the table.

## Related

- [Configuration and environment variables](/sdks/configuration) — set `PREFACTOR_API_TOKEN` to use a deployment-scoped token from the SDK.
- [Account › API tokens tab](/admin-ui/account/api-tokens) — account-wide tokens for general API access.