Skip to content
Subako Docs
English
Esc
↑↓navigate↵open⌘Jpreview

Get the workspace's workload identity

The issuer and subject a cloud account, an Anthropic organization, or an OpenAI organization trusts so that a model provider can authenticate as this workspace, with no long-lived credential handed over. A role whose trust policy, a federation rule whose match, or a mapping whose sub pins this subject admits this workspace and no other.

GET/v1/workload-identity
Authorization
AuthorizationBearer token · headerrequired
Header parameters
Kikuvi-Workspacestring<uuid>
Workspace to read. Required for a user caller; implied by the key for an API key caller.
Responses
200The workspace's issuer and subject.
anthropicAnthropicWorkloadIdentityBodyrequired
What an Anthropic organization needs beyond the issuer and subject.
Show properties
audiencestringrequired
The `aud` of tokens exchanged at the Claude API, and the `audience` a federation rule's match checks.
awsAwsWorkloadIdentityBodyrequired
What an AWS account needs beyond the issuer and subject.
Show properties
audiencestringrequired
The audience (client id) to register the issuer under in IAM, and the `aud` a role's trust policy checks.
issuerstringrequired
The OpenID Connect issuer every workspace token names. Register it as an identity provider in your cloud account or your OpenAI organization, or as a federation issuer in your Anthropic organization; its discovery document is at `{issuer}/.well-known/openid-configuration`.
openaiOpenaiWorkloadIdentityBodyrequired
What an OpenAI organization needs beyond the issuer and subject.
Show properties
audiencestringrequired
The `aud` of tokens exchanged at OpenAI, and the audience to give the workload identity provider.
subjectstringrequired
The `sub` claim of this workspace's tokens, and of no other workspace's: the value a role's trust policy, a federation rule's `subject_prefix`, or an OpenAI mapping's `sub` pins.
400A malformed workspace header, or a user caller with no workspace header.
errorErrorDetailrequired
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
401Missing, malformed, or invalid bearer token.
errorErrorDetailrequired
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
403Caller lacks model_provider.read, or an API key's Kikuvi-Workspace header names another workspace.
errorErrorDetailrequired
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
404No such workspace, the caller cannot see it, or this deployment issues no workload identity.
errorErrorDetailrequired
What went wrong: a `code` to branch on and a `message` to show. The message is written for a person and may change; the code will not.
Show properties
codeErrorCoderequired
The machine-readable half of an error response, and the field a client branches on. Closed: every error carries exactly one of these.
Allowed:unauthorizedforbiddennot_foundinvalid_requestconflictclient_outdatedprecondition_failedtoo_many_requestsinternal
messagestringrequired
Try it
Server
Authorization
Parameters
Request
curl -X GET "https://api.us.cloud.subako.ai/v1/workload-identity" \
  -H "Authorization: Bearer YOUR_TOKEN"
Response
{
  "anthropic": {
    "audience": "string"
  },
  "aws": {
    "audience": "string"
  },
  "issuer": "string",
  "openai": {
    "audience": "string"
  },
  "subject": "string"
}