Get a tenant by ID
Retrieves a tenant by its canonical id or by the external_id:<value> form the customer asserted it under.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Workspace ID.
"workspace_01HXKD2E5NQM3T9AYWCF133E3Q"
Tenant ID. Accepts the canonical tenant_… form or the
external_id:<value> form.
Query Parameters
When true, the info field is populated.
Response
OK
Tenant is the customer's organization as a readable record rather than an
echo. It carries no spec: a tenant is never configured, only asserted, so
everything about it lives in the metadata envelope — external_id is the key
the customer asserted it under, name is the most recent name they asserted,
and updated_at is therefore when the tenant was last asserted.
Standard metadata for persistent, named resources (e.g., agents, tools, prompts)
The current lifecycle state of the tenant. Output only.
STATE_UNSPECIFIED, STATE_ACTIVE, STATE_ERASING TenantInfo provides read-only server-derived data about a tenant.