API Reference
Getting Started
Core Concepts
Backend API — Guides
Frontend API — Guides
OAuth & OpenID Connect — Guides
Enterprise: SSO & SCIM — Guides
Webhooks — Guides
SDKs
Backend API (BAPI)
Frontend API (FAPI)
Dashboard API
Public API
SCIM
OIDC
Platform

Permissions

AdminUpdated Sep 11, 2026

Permissions

Dashboard API — authenticated by an Atlas console (platform-instance) session, not a key.

3 routes. Each row is one endpoint with its explanation and whether it honours the Idempotency-Key header.

Method & path

Idem

Explanation

POST /v1/dashboard/accounts/:accountId/instances/:instanceId/permissions

Define a custom permission key.

PATCH /v1/dashboard/accounts/:accountId/instances/:instanceId/permissions/:permissionId

Update a custom permission's name/description (the key is immutable). System permissions are refused.

DELETE /v1/dashboard/accounts/:accountId/instances/:instanceId/permissions/:permissionId

Delete a permission no role grants. Refused with the granting roles named.

Was this page helpful?