Grant a login access to the workspace, or create a private-key principal and issue its key.
curl -X POST "https://api.nevia.cloud/v1/workspaces/01d4cnjjq40hnnh0nwmkg35nv2h/access" \
-H "Authorization: Bearer $TOKEN" \
-H "Idempotency-Key: 8f1c2a7e-3b4d-4c5e-9f0a-1b2c3d4e5f60" \
-H "Content-Type: application/json" \
-d '{
"email": "dana@example.com",
"role": "editor"
}'{
"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"
},
"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_file": {
"principal": "01d4cnjmn4fbb1r5btxb5mypv62",
"subject": "393890846249869905",
"key_id": "393890846384085404",
"audience": "https://auth.example.com",
"token_url": "https://api.example.com/v1/auth/token",
"private_key": "string"
},
"operations": [
"01d4cnjm89yk0r3xtv80dy0x7by"
]
}Authorization
bearerAuth Send the token in the Authorization: Bearer <token> header. See Authenticate.
In: header
Path Parameters
Workspace id: 27 lowercase letters and digits.
^[A-Za-z0-9_-]{1,64}$Header Parameters
Retry key. A retry with the same key and body replays the first response
1 <= length <= 255Request Body
application/json
Login or private-key principal to grant access to
Login by email
Behavior
Access takes effect at once. The key and key file are returned once, and an idempotent replay answers key_file: null.
Response
application/jsonThe access added, with a new private-key principal's key and key file.
Created access, with its key and key file