ReferenceAPI
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 <= 100Default
50cursor?
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/jsonOne entry per principal, logins and private-key principals alike.