Skip to main content
POST
/
access_decisions
Explain an access decision
curl --request POST \
  --url https://api.akua.dev/v1/access_decisions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "resource": {
    "offer_channel_id": "<string>",
    "product_id": "<string>",
    "target_workspace_id": "<string>"
  },
  "subject": {
    "user_id": "<string>",
    "organization_id": "<string>",
    "workspace_id": "<string>"
  },
  "context": {
    "selected_organization_id": "<string>"
  }
}
'
{
  "decision": {},
  "action": {
    "id": "<string>",
    "name": "<string>"
  },
  "reasons": [
    {
      "key": "<string>",
      "source": "<string>",
      "message": "<string>",
      "metric": "<string>",
      "limit": 123,
      "usage": 123,
      "remaining": 123,
      "resourceId": "<string>",
      "resourceType": "<string>",
      "relationship": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

workspace API token (sk_akua_...) or OAuth2 JWT. Create tokens at https://akua.dev/developers/api-tokens

Body

application/json
permission
enum<string>
required
Available options:
offers.create_via_channel
resource
object
required
subject
object
context
object

Response

Access decision explanation

decision
object
required
action
object
required
reasons
object[]
required