Skip to main content
Pulumi logo Pulumi logo
  1. Docs
  2. Reference
  3. REST API Docs
  4. Agent Integration Catalog

Agent Integration Catalog

    List Agent Integrations

    ▼
    GET /api/console/orgs/{orgName}/agents/integrations

    Returns the full MCP integration catalog for an organization, with each entry annotated with its configured state. Includes catalog metadata (name, description, credential fields) and configuration status (configured, configuredBy, timestamps). The response is not paginated and the operation has no filter parameter. To find connected integrations, select returned entries whose configured field is true. Credential field definitions are returned, but credential values are not. Returns 404 if the integration catalog is not enabled for the organization.

    Request Parameters

    • orgName string path required
      The organization name

    Responses

    200 OK
    • integrations array[AgentIntegrationResponse] required
      All available integrations, each annotated with configured state.
    • ↳ integrationId string required
      The integration ID (e.g. ‘datadog’, ‘sentry’).
    • ↳ name string required
      Human-readable display name.
    • ↳ description string required
      Short description of what this integration provides.
    • ↳ type string required
      The integration type, for example, ‘mcp’.
    • ↳ credentialFields array[CredentialFieldResponse] required
      The credential fields required to configure this integration.
    • ↳ configured boolean required
      Whether this integration has been configured for the organization.
    • ↳ configuredBy UserInfo optional
      The user who configured this integration.
    • ↳ created string optional
      ISO 8601 timestamp of when the integration was configured.
    • ↳ modified string optional
      ISO 8601 timestamp of when the integration was last modified.
    Errors: 403 Caller has no role in the organization 404 Organization not found or integration catalog not enabled

    List Agent CLI Integrations

    ▼
    GET /api/console/orgs/{orgName}/agents/integrations/cli

    Returns the CLI integration catalog for an organization, with each connected instance annotated with its ESC environment reference and configuration metadata. The catalog also includes all available CLI integration types regardless of whether they have any connected instances. The response is not paginated. The integrations array contains only connected instances; the catalog array lists available types. ESC environment references are returned, but credential values are not. Returns 404 if the CLI integration catalog is not enabled for the organization.

    Request Parameters

    • orgName string path required
      The organization name

    Responses

    200 OK
    • integrations array[AgentCLIIntegrationResponse] required
      The organization’s connected CLI integration instances.
    • ↳ id string required
      Server-generated unique identifier for this integration instance.
    • ↳ catalogId string required
      The catalog entry ID this instance is based on (e.g. ‘aws’).
    • ↳ catalogName string required
      Human-readable display name from the catalog (e.g. ‘AWS’).
    • ↳ description string required
      Short description of what this integration provides.
    • ↳ name string required
      User-chosen name for this integration instance (e.g. ‘aws-prod’).
    • ↳ escEnvRef string required
      Reference to the Pulumi ESC environment containing the credentials, in the format ‘/’. The organization is implicit (the row’s org).
    • ↳ notes string optional
      Admin-authored notes describing when the agent should use this integration. Null when not set. Up to 3000 characters.
    • ↳ configuredBy UserInfo optional
      The user who configured this integration.
    • ↳ created string required
      ISO 8601 timestamp of when the integration was connected.
    • ↳ modified string required
      ISO 8601 timestamp of when the integration was last modified.
    • catalog array[AgentCLICatalogEntry] required
      All available CLI integration types from the catalog.
    • ↳ id string required
      Unique identifier for this catalog entry (e.g. ‘aws’).
    • ↳ name string required
      Human-readable display name (e.g. ‘AWS’).
    • ↳ description string required
      Short description of the integration. Includes the environment variables the linked ESC environment is expected to emit.
    Errors: 403 Caller has no role in the organization 404 Organization not found or CLI integration catalog not enabled

      The infrastructure platform for humans and agents.