AI Agents

Claim

Previews the agent claim (dryRun=true) or starts its commit. The response shape is identical in both cases. Commit transfers the agent's stacks to the destination organization, soft-deletes the agent's organization, and soft-deletes the agent's access token. If there are unresolved conflicts or failures, it returns them and does not perform any state mutations.

post/api/agents/{orgName}/claim

Request

  • Base URL: https://api.pulumi.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.pulumi.com/api/agents/{orgName}/claim
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Query parameters

dryRunboolean

If set, perform a dry run without committing changes

Request body

claimTokenstring required

The opaque single-use claim token embedded in the claim URL the agent surfaces to its human. Returned by /api/agents/signup as part of the claim URL.

Response

OK (preview, successful commit, or commit blocked); inspect conflicts and failures to distinguish

claimExpiresAtstring date-time required

When the claim window closes. After this time the claim token expires and the claim cannot complete.

transferTokenstring

On successful start of a claim, the token needed to check for progress.

Changes

No recorded changes to this operation across all 1 revision of this API.