Skip to content
PrefactorPrefactorPrefactor Docs

Deployments tab

The Deployments tab manages deployment-scoped API tokens for this agent — credentials scoped to one 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 for this agent.

Version pins (which version is current in each environment) live on the deployment snapshot on the Agent page, not in this tab. See agent deployment for how those records work.

Deployment tokens table

Section titled “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

Section titled “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.

Token actions

Section titled “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.
Section titled “Related”