Organization Endpoints

Get Organization

GET /api/v1/orgs/{slug}

org:read

curl https://api.boxowl.me/api/v1/orgs/acme \
  -H "X-API-Key: boxlive_01h455..."

Response 200 OK:

{
  "id": "org_01h455vb4pex5vsknk084sn02q",
  "slug": "acme",
  "name": "Acme Corp",
  "plan": "organization",
  "memberCount": 3,
  "connectionCount": 1240,
  "vaultCount": 1240,
  "createdAt": "2026-01-15T00:00:00Z"
}

List Members

GET /api/v1/orgs/{slug}/members

org:read

curl https://api.boxowl.me/api/v1/orgs/acme/members \
  -H "X-API-Key: boxlive_01h455..."

Response 200 OK:

{
  "members": [
    {
      "id": "mem_01h455...",
      "userId": "usr_01h455...",
      "email": "admin@acme.com",
      "role": "OWNER",
      "joinedAt": "2026-01-15T00:00:00Z"
    },
    {
      "id": "mem_01h456...",
      "userId": "usr_01h456...",
      "email": "dev@acme.com",
      "role": "DEVELOPER",
      "joinedAt": "2026-02-01T00:00:00Z"
    }
  ]
}

List Connections

GET /api/v1/orgs/{slug}/connections

connections:read

curl "https://api.boxowl.me/api/v1/orgs/acme/connections?cursor=csr_01h455&limit=50" \
  -H "X-API-Key: boxlive_01h455..."

Response 200 OK:

{
  "connections": [
    {
      "id": "con_01h455...",
      "userId": "usr_01h455...",
      "handle": "alice",
      "email": "alice@example.com",
      "consentStatus": "active",
      "connectedAt": "2026-03-01T00:00:00Z",
      "lastAccessAt": "2026-04-27T08:30:00Z"
    }
  ],
  "cursor": "csr_01h456...",
  "hasMore": true,
  "total": 1240
}

Remove Connection

DELETE /api/v1/orgs/{slug}/connections/{connectionId}

connections:write

curl -X DELETE https://api.boxowl.me/api/v1/orgs/acme/connections/con_01h455... \
  -H "X-API-Key: boxlive_01h455..."

Response 204 No Content. The customer must re-authorize your app to reconnect.

Member Roles

Organization members have one of three roles:

Role	Permissions
`OWNER`	Full org control: billing, settings, all API keys, all members
`DEVELOPER`	Manage API keys, view connections, read audit logs
`VIEWER`	Read-only access to org details and connections