VCS Integrations

CreateCustomVCSIntegration

Creates a new custom VCS integration for an organization. Custom VCS integrations allow connecting self-hosted or third-party version control systems (e.g. Gitea, Forgejo, Bitbucket Server) to Pulumi Deployments. Credentials are managed via ESC environments, and deployments are triggered by inbound webhooks. Returns the created integration including its webhook URL and HMAC secret for signature verification.

post/api/console/orgs/{orgName}/integrations/custom

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/console/orgs/{orgName}/integrations/custom
  • Auth: none declared

Path parameters

orgNamestring required

The organization name

Request body

baseUrlstring required

URL prefix for repositories covered by this integration (e.g. 'https://gitea.example.com/myorg'). Used to match repositories to integrations.

environmentstring required

ESC environment reference in 'project/envName' format containing VCS credentials (e.g. SSH keys, access tokens) used for repository operations

namestring required

Human-readable name for the integration, unique within the organization (e.g. 'Gitea Production')

vcsType'git' | 'hg'

Version control system type. Defaults to 'git' if not specified.

Response

Created

baseUrlstring required

URL prefix for repositories covered by this integration

createdstring required

ISO 8601 timestamp of when the integration was created

environmentstring required

ESC environment reference in 'project/envName' format containing VCS credentials

idstring required

Unique identifier (UUID) for this integration

modifiedstring required

ISO 8601 timestamp of when the integration was last modified

namestring required

Human-readable name for the integration

vcsType'git' | 'hg' required

Version control system type

webhookSecretstring

HMAC secret for webhook signature verification. Only returned on integration creation; subsequent GET requests omit this field.

webhookUrlstring

Full webhook endpoint URL that the external VCS should POST events to. This URL is generated by the service and includes the integration ID.

Changes

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