Skip to main content
GET
Get organization
Primary IAM action: workspace:GetOrganization. Human organization members can read their organization without this action. Service accounts and assumed roles require this organization permission. See WORKSPACE permissions for policy examples.

Authorizations

Authorization
string
header
required

An OAuth 2.0 bearer token, sent as Authorization: Bearer <token>. This is the recommended way to authenticate.

Get one by exchanging a service account's access key pair at POST /v1/oauth/token with grant_type=client_credentials. It is the standard client-credentials grant, so any OAuth-aware library will obtain and refresh it for you.

Tokens last an hour by default. The same access key pair is separately your AWS SigV4 credential for the S3-compatible object endpoint, which speaks nothing else.

Path Parameters

organization_id
string<uuid>
required

Organization ID

Response

Organization details

organization
object