Open Caven

Reference

Organization

Your organization, its members, teams and folders

1 min read

All endpoints on this page need the organization:read scope. They are meant for organization keys. A personal key reads the organization you belong to, and returns 404 NO_ORGANIZATION if you don't belong to one.

Organization

GET /organization
{
  "data": {
    "id": "cmosioqps0002ugawapstnrwy",
    "name": "Acme Legal",
    "slug": "acme-legal",
    "description": "...",
    "industry": "legal",
    "tier": "ENTERPRISE",
    "subscriptionStatus": "ACTIVE",
    "currentPeriodEnd": "2026-10-30T11:42:19.000Z",
    "seatLimit": 8,
    "website": "https://acme.example",
    "companyFocus": "...",
    "specializedJargon": "...",
    "createdAt": "2026-05-05T11:00:26.560Z",
    "updatedAt": "2026-10-05T17:19:35.732Z"
  }
}

Policies

GET /organization/policies

The organization's template policies:

{
  "data": {
    "policyOnlyOrgAdminsCanPublishOrgTemplates": true,
    "policyPersonalTemplatesInAutoDetection": true,
    "policyTeamAdminsCanPublishTeamTemplates": true,
    "policyUsersCanCreatePrivateTemplates": true,
    "policyUsersCanShareTemplatesWithTeams": true,
    "policyEnforceDefaultTemplate": false
  }
}

Members

GET /organization/users
GET /organization/users/:userId
ParameterDescription
roleADMIN or MEMBER
statusactive or inactive
limit, offsetPagination
{
  "data": [
    {
      "id": "cmlf10mkm0000ppip93jkxm89",
      "name": "Jane Doe",
      "email": "[email protected]",
      "image": null,
      "role": "ADMIN",
      "isActive": true,
      "joinedAt": "2026-05-05T16:34:04.360Z",
      "updatedAt": "2026-09-30T12:04:58.648Z",
      "teams": [{ "id": "cmosrt5lb0001ugf85l0bmfns", "name": "Litigation", "role": "MEMBER" }]
    }
  ],
  "meta": { "total": 2, "limit": 20, "offset": 0 }
}

The id is the user ID. Pass it as ?userId= on other endpoints to read one member's data.

Teams

GET /organization/teams
GET /organization/teams/:teamId
GET /organization/teams/:teamId/members

/teams accepts search (on the name). /members accepts role (ADMIN or MEMBER). Both support limit and offset.

{
  "data": {
    "id": "cmosjnwx00001ug0o3nf9negk",
    "name": "Litigation",
    "description": null,
    "memberCount": 2,
    "defaultTemplateId": null,
    "folders": [{ "id": "cmosjnwzi0003ug0ozomlw89f", "name": "Cases" }],
    "createdAt": "2026-05-05T11:27:47.554Z",
    "updatedAt": "2026-06-22T13:51:31.774Z"
  }
}

A team member:

{
  "membershipId": "cmosioqsk0004ugaw3di310p8",
  "userId": "cmjal5xyj0000vaz4po9spv16",
  "name": "Jane Doe",
  "email": "[email protected]",
  "image": null,
  "orgRole": "ADMIN",
  "teamRole": "MEMBER",
  "joinedAt": "2026-06-22T13:51:33.371Z"
}

Folders

GET /organization/folders
GET /organization/folders/:folderId

/folders accepts teamId, search, limit and offset.

{
  "data": {
    "id": "cmosjnwzi0003ug0ozomlw89f",
    "name": "Cases",
    "description": "Client case recordings",
    "minRole": "MEMBER",
    "teamId": null,
    "teamName": null,
    "recordingCount": 13,
    "createdAt": "2026-05-05T11:27:47.647Z",
    "updatedAt": "2026-05-18T12:40:59.190Z"
  }
}

minRole is the lowest organization role that can see the folder.

© 2026 Caven BV. All rights reserved. Built in Belgium.EU · GDPR · AI Act · Privacy-first · ISO 27001

On this page