Organizations

An Organization is the top-level account entity in Keme. All workspaces, applications, agents, and users belong to an organization. When a studio signs up for Keme, a single Organization record is provisioned on their behalf. Every subsequent API call is scoped to the organization identified by your API key.

GET/v1/organizations/:id🔒 Auth required

Retrieve the full details of an organization by its ID. Requires the organization:read scope.

Path Parameters
ParameterTypeRequiredDescription
idstringRequiredOrganization ID
Response
200
json
1{
2  "id": "org_xxxx",
3  "name": "Awesome Game Studio",
4  "slug": "awesome-game-studio",
5  "plan": "growth",
6  "createdAt": "2026-01-01T00: 00: 00Z",
7  "membersCount": 24,
8  "workspacesCount": 3
9}
PATCH/v1/organizations/:id🔒 Auth required

Update mutable fields on an organization. Only members with the owner or admin role can update organization settings.

Path Parameters
ParameterTypeRequiredDescription
idstringRequiredOrganization ID
Request Body
ParameterTypeRequiredDescription
namestringOptionalDisplay name for the organization.
logoUrlstringOptionalPublicly accessible URL to the organization logo image.
timezonestringOptionalIANA timezone string (e.g. America/New_York). Used for report scheduling and SLA calculations.
localestringOptionalBCP 47 locale code (e.g. en-US). Sets the default language for outbound communications.
Response
200
json
1{
2  "id": "org_xxxx",
3  "name": "Updated Studio Name",
4  "slug": "awesome-game-studio",
5  "plan": "growth",
6  "createdAt": "2026-01-01T00: 00: 00Z",
7  "membersCount": 24,
8  "workspacesCount": 3
9}
GET/v1/organizations/:id/members🔒 Auth required

Returns a paginated list of all members belonging to the organization. Results can be filtered by role.

Path Parameters
ParameterTypeRequiredDescription
idstringRequiredOrganization ID
Query Parameters
ParameterTypeRequiredDescription
rolestringOptionalFilter members by role. Accepted values: owner, admin, agent, viewer.
limitintegerOptionalMaximum number of records per page. Defaults to 20, maximum 100.
offsetintegerOptionalZero-based offset for pagination.
Response
200
json
1{
2  "total": 24,
3  "data": [
4    {
5      "id": "usr_xxxx",
6      "email": "agent@studio.com",
7      "role": "admin",
8      "joinedAt": "2026-01-15T00: 00: 00Z"
9    }
10  ]
11}
GET/v1/organizations/:id/usage🔒 Auth required

Returns current-period usage metrics for the organization including ticket volume, agent seat consumption, and storage utilization.

Path Parameters
ParameterTypeRequiredDescription
idstringRequiredOrganization ID
Response
200
json
1{
2  "ticketsThisMonth": 1842,
3  "agentSeats": {
4    "used": 12,
5    "limit": 25
6  },
7  "storageGb": {
8    "used": 4.2,
9    "limit": 50
10  }
11}

Organization Object

  • id — string — Keme-assigned organization ID. Prefixed org_.
  • name — string — Display name of the organization.
  • slug — string — URL-safe identifier. Immutable after creation.
  • plan — string — Current subscription plan: starter, growth, or enterprise.
  • createdAt — ISO 8601 — Timestamp when the organization was created.
  • membersCount — integer — Number of active members.
  • workspacesCount — integer — Number of workspaces under this organization.
Last updated: June 15, 2026Edit this page
PreviousAuthenticationNextApplications