SOsolana
API Keys

Create API-key policy revision

Appends an immutable rule snapshot to an API-key control profile without activating it.

post/v1/api-keys/{keyId}/policy-profiles/{profileId}/revisions

Request

  • Base URL
    http://localhost:8787
  • URL
    http://localhost:8787/v1/api-keys/{keyId}/policy-profiles/{profileId}/revisions
  • Auth
    HTTP bearer

Path parameters

keyIdstring required

API key identifier.

Example:key_example
profileIdstring required

Headers

x-project-idstring

Selects the active project for this request. Required for Clerk (dashboard) callers. Ignored when authenticating with an API key, whose scope is fixed to the key's project.

Example:prj_example

Request body

defaultAction'allow' | 'deny' | 'approval_required' | 'review' required

Decision used when no rule matches.

Example request

{
  "defaultAction": "deny"
}

Response

API-key control profile revision created

Example response

{
  "data": {
    "revision": {
      "createdAt": "2025-01-01T00:00:00.000Z",
      "activatedAt": "2025-01-01T00:00:00.000Z"
    }
  },
  "meta": {
    "requestId": "req_example",
    "timestamp": "2025-01-01T00:00:00.000Z"
  }
}

Changes