Workflows
DeploymentRunners

CreateOrgAgentPool

Creates a new agent pool for an organization. Agent pools enable self-hosted deployment agents, allowing organizations to run Pulumi Deployments on their own infrastructure rather than Pulumi-managed infrastructure. This is useful for accessing private networks, meeting compliance requirements, or using custom execution environments. The response includes an access token (agent pool secret) that self-hosted agents use to authenticate when polling for deployment work. This token is only returned once at creation time and cannot be retrieved later.

post/api/orgs/{orgName}/agent-pools

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/orgs/{orgName}/agent-pools
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Request body

descriptionstring required

The description

namestring required

The name

Response

OK

idstring required

The unique identifier

tokenValuestring required

The token value

Changes

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