Skip to content
GitmoapAPIBeta
Schema

ProviderConnectionResponse

A provider connection. Credentials are never included.

Shape

  • auth_modeConnectionAuthModestatic_credentialsoidc_federationHow this connection authenticates.
  • created_atstring
  • created_byActorSummary
  • idConnectionId (string · uuid)
  • nameProviderConnectionName (string)
  • provider_idProviderId (string)
  • scope_idstring
  • scope_typeScopeTypegrouprepository
  • secret_refsobjectThe names of the stored credential fields, each with a reference to where it is stored. Never the values. Empty for an oidc_federation connection.
  • config_overridesobjectoptional
  • federation_targetOidcFederationTarget or nulloptionalThe cloud role the connection assumes. Present only when auth_mode is oidc_federation.
    • The OidcFederationTarget schema
    • cloudaws
    • role_arnRoleArn (string)The IAM role the pipeline assumes.
    • audiencestring or nulloptionalThe audience of the identity token. Defaults to sts.amazonaws.com.
    • regionAwsRegion (string) or nulloptionalThe AWS region for the provider's calls.
  • last_rotated_atstring or nulloptional

Example

Synthesized example
{
"auth_mode": "static_credentials",
"created_at": "2026-10-11T07:42:14Z",
"created_by": {
"email": "lin@acme.example",
"id": "id-427d",
"username": "mara",
"avatar_url": "https://gitmoap.example/acme/874c7fc9"
},
"id": "439a2c4c-c44b-4067-b92c-e1f34b2ed6b6",
"name": "payments-api",
"provider_id": "0ba91852-8912-4337-8184-8d53ce25f351",
"scope_id": "b4b81a2e-ff17-46de-9f0f-72ea10f70a24",
"scope_type": "group",
"secret_refs": {
"secret_refs": "secret-refs-9544"
},
"config_overrides": {},
"federation_target": {
"cloud": "aws",
"role_arn": "role-arn-d59c",
"audience": "audience-f1f2",
"region": "region-dccb"
},
"last_rotated_at": "2026-10-16T11:13:42Z"
}

Graph

Used inside
Contains

Used by

Sent by 0 operations

No operation takes it as a request body.

Returned by 8 operations