Get organizations

Get list of organizations with pagination and filtering. See Platform Overview.

GET /organizations

Get organizations

cURL

curl --request GET \
  --url https://api.galtea.ai/organizations \
  --header 'Authorization: Bearer <token>'

200

[
  {
    "id": "org_123",
    "name": "Example Organization",
    "remainingSubscriptionCredits": 1000,
    "extraCredits": 500,
    "lastWarningAt": "2023-11-07T05:31:56Z",
    "warningAt": 100,
    "stripeCustomerId": "cus_123",
    "samlEntrypointUrl": "<string>",
    "samlEntityId": "<string>",
    "samlIssuerId": "<string>",
    "samlPublicCertificate": "<string>",
    "samlSignedResponse": true,
    "samlSignedAssertions": true,
    "samlForcePasswordAuth": true,
    "samlTeamSlug": "<string>",
    "enforceMfa": false,
    "createdAt": "2023-11-07T05:31:56Z",
    "deletedAt": "2023-11-07T05:31:56Z",
    "otelProductKey": [
      "service.namespace",
      "service.name"
    ],
    "otelVersionAttributes": [
      "service.version",
      "app.agent.model"
    ],
    "otelInputSourceRule": {
      "spanName": "ExecuteActivity:add_user_message",
      "attribute": "app.arguments",
      "path": "$[0].message.content",
      "predicate": {
        "path": "$[0].message.role",
        "equals": "user"
      }
    },
    "otelOutputSourceRule": {
      "spanName": "ExecuteActivity:save_reply",
      "attribute": "app.arguments",
      "path": "$[0].message.content",
      "predicate": {
        "path": "$[0].message.role",
        "equals": "assistant"
      }
    }
  }
]

Authorizations

Authorization · string · header · required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Query Parameters

ids · string[]

Filter by organization IDs

name · string

Filter by organization name

sort · string[]

Sort instructions (field and direction pairs)

limit · integer

Maximum number of results

offset · integer

Number of results to skip

Response

200

application/json

Organizations retrieved successfully

id · string

Example:

"org_123"

name · string

Example:

"Example Organization"

remainingSubscriptionCredits · integer | null

Example:

1000

extraCredits · integer

Example:

500

lastWarningAt · string<date-time> | null

warningAt · integer | null

The credit balance below which members get a low-credit warning, from 0 up to the monthly credits of the plan. Null turns the warning off.

Example:

100

stripeCustomerId · string | null

Example:

"cus_123"

samlEntrypointUrl · string | null

samlEntityId · string | null

samlIssuerId · string | null

samlPublicCertificate · string | null

samlSignedResponse · boolean | null

samlSignedAssertions · boolean | null

samlForcePasswordAuth · boolean | null

samlTeamSlug · string | null

enforceMfa · boolean · default: false

When true, every member of the organization must complete an MFA challenge to sign in. Settable by Owners (via update) and Admins (via create or update).

createdAt · string<date-time>

deletedAt · string<date-time> | null

otelProductKey · string[]

The resource attributes that identify a product of this organization, 1 to 10 names. Each product gives its own value for each of them. A name cannot start with "galtea." or be "customer.id". Changing the set of names is refused while a product that uses this key holds values. It cannot be null.

Example:

["service.namespace", "service.name"]

otelVersionAttributes · string[]

The resource attributes whose values make up a version, up to 32 names. A trace that carries no galtea.version.id and no galtea.version.fact.* gets the version built from the listed attributes it carries. Each fact keeps the attribute name as its key. A name cannot start with "galtea." or be "customer.id". An empty list turns this off. A product can replace the list with its own.

Example:

["service.version", "app.agent.model"]

otelInputSourceRule · object | null

Recovers a turn's input from a non-LLM span for every product with no rule of its own. A version rule wins over a product rule, and a product rule over this one. Null clears it.

Show child attributes

otelOutputSourceRule · object | null

Recovers a turn's output from a non-LLM span for every product with no rule of its own. A version rule wins over a product rule, and a product rule over this one. Null clears it.

Show child attributes