AI Agents

Signup

Creates a new Pulumi Cloud account programmatically, without human intervention, and returns an access token plus a claim URL. The caller must first obtain a challenge from GET /api/agents/signup/challenge and submit the computed proof of work here. Intended for agent contexts: a CLI that detects it is running on behalf of an agent and finds no local credentials issues the challenge call, solves it, then calls this endpoint, writes the returned access token to its credentials file, and surfaces the claim URL to its human so the human can take ownership of the account later. The account is a Pulumi Individual Account in a pre-claim state; operations that require a verified email (such as creating agent tasks) are unavailable until the account is claimed.

post/api/agents/signup

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/signup
  • Auth: none declared

Request body

challengeIDstring required

An ID identifying the challenge issued by GET /api/agents/signup/challenge.

challengeResultstring required

Output of the proof-of-work computation over the challengeData returned by GET /api/agents/signup/challenge.

Response

OK

accessTokenstring required

The Pulumi access token to use for authenticating future API requests as the new user.

accessTokenValidUntilstring date-time required

When the temporary access token expires.

claimTokenstring required

An opaque single-use token the human submits to claim ownership of the account. The CLI surfaces a claim URL embedding this token to the human; the path is a CLI/UI concern.

claimTokenValidUntilstring date-time required

When the claim token expires.

Changes

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