Issuers

Create Federation Issuer

POST/v1/organizations/federation_issuers

List Federation Issuers

GET/v1/organizations/federation_issuers

Get Federation Issuer

GET/v1/organizations/federation_issuers/{federation_issuer_id}

Update Federation Issuer

POST/v1/organizations/federation_issuers/{federation_issuer_id}

Archive Federation Issuer

POST/v1/organizations/federation_issuers/{federation_issuer_id}/archive

Models

BetaFederationIssuer object{ id, archived_at, archived_by_actor_id, 12 more }

Registered external OIDC identity provider.

Records an external IdP the organization trusts for the RFC 7523 jwt-bearer grant. The issuer_url must match the JWT iss claim exactly.

BetaFederationIssuerPollStatus object{ consecutive_failures, last_fetched_at, next_poll_at }

Status of automatic JWKS polling for a federation issuer.

Anthropic periodically fetches the issuer's signing keys in the background. These fields summarize the most recent fetches so the health of the JWKS endpoint can be monitored.

consecutive_failures: number

Consecutive fetch failures since the last success.

last_fetched_at: string or null

When the last successful fetch completed.

formatdate-time

next_poll_at: string or null

When the next fetch is scheduled. Null if paused.

formatdate-time

BetaJWKSDiscovery object{ type, ca_cert_pem, discovery_base }

JWKS via the issuer's OIDC discovery document.

type: "discovery"

ca_cert_pem: optional string or null

Optional custom CA (PEM) for TLS verification of the JWKS fetch.

maxLength8192

discovery_base: optional string or null

Set when the discovery URL differs from issuer_url.

BetaJWKSExplicitURL object{ type, url, ca_cert_pem }

JWKS fetched from a fixed endpoint.

type: "explicit_url"

url: string

JWKS endpoint.

minLength1

ca_cert_pem: optional string or null

Optional custom CA (PEM) for TLS verification of the JWKS fetch.

maxLength8192

BetaJWKSInline object{ keys, type }

JWKS supplied directly; no network fetch.

keys: array of map[unknown]

Inline JWK objects.

minItems1

type: "inline"