For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Log inBook a demo
GuidesAPI Reference
GuidesAPI Reference
  • API Reference
      • GETGet Current Organization
      • GETGet Organizations
      • POSTCreate Organization
      • GETGet Organization
      • PUTUpdate Organization
      • DELDelete Organization
Logo
Log inBook a demo
API ReferenceOrganization

Get Current Organization

GET
https://app.polytomic.com/api/organization
GET
/api/organization
$curl https://app.polytomic.com/api/organization \
> -H "Authorization: Bearer <token>"
1{
2 "data": {
3 "id": "string",
4 "issuer": "https://example.com",
5 "name": "My Organization",
6 "sso_domain": "example.com",
7 "sso_org_id": "123456"
8 }
9}
Returns the organization the caller is authenticated against. This endpoint is the safest way to discover the effective organization for a user-scoped or organization-scoped credential. It does not let callers inspect arbitrary organizations; it only returns the organization implied by the credential that authenticated the request. If you need to enumerate or look up organizations across a partner account, use [`GET /api/organizations`](../../api-reference/organization/list) or [`GET /api/organizations/{id}`](../../api-reference/organization/get) instead.
Was this page helpful?
Previous

Get Organizations

Next

Returns the organization the caller is authenticated against.

This endpoint is the safest way to discover the effective organization for a user-scoped or organization-scoped credential. It does not let callers inspect arbitrary organizations; it only returns the organization implied by the credential that authenticated the request.

If you need to enumerate or look up organizations across a partner account, use GET /api/organizations or GET /api/organizations/{id} instead.

Authentication

AuthorizationBearer
Bearer user API key
OR
AuthorizationBasic

Basic organization-scoped API key

Headers

X-Polytomic-VersionstringOptional

Response

OK
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error