ReferenceAPI

List access

List everyone who has access to the workspace.

GET https://api.nevia.cloud/v1/workspaces/{ws}/access
curl -X GET "https://api.nevia.cloud/v1/workspaces/01d4cnjjq40hnnh0nwmkg35nv2h/access" \
  -H "Authorization: Bearer $TOKEN"
{
  "access": [
    {
      "principal": {
        "id": "01d4cnjmn4fbb1r5btxb5mypv62",
        "auth": "email",
        "email": "string",
        "name": "string"
      },
      "role": "editor",
      "description": "string",
      "key": {
        "id": "01d4cnjq8r0tvwxyb3c4d5f6g7h",
        "principal": "01d4cnjmn4fbb1r5btxb5mypv62",
        "byok": true,
        "created_by": "01d4cnjmn4fbb1r5btxb5mypv62",
        "expires_at": "2026-09-10T12:34:56Z",
        "last_used_at": "2026-09-10T12:34:56Z",
        "created_at": "2026-09-10T12:34:56Z",
        "revoked_at": "2026-09-10T12:34:56Z"
      },
      "key_state": "active",
      "created_at": "2026-09-10T12:34:56Z"
    }
  ],
  "next_cursor": "string",
  "has_more": true
}

Authorization

bearerAuth
Authorization Bearer <token>

Send the token in the Authorization: Bearer <token> header. See Authenticate.

In: header

Path Parameters

ws* string

Workspace id: 27 lowercase letters and digits.

Match ^[A-Za-z0-9_-]{1,64}$

Query Parameters

limit? integer

Page size

Range 1 <= value <= 100
Default 50
cursor? string

next_cursor from the previous page

Behavior

A principal holds one role per workspace. Each entry's principal.auth tells a login from a private-key principal.

Response

application/json

One entry per principal, logins and private-key principals alike.