Docs API Reference Access Request/bff/access-request/create

/bff/access-request/create

Creates a pending row in cas__access_request and dispatches a notification e-mail via writeLog to every active root member of the org. Idempotent — a second call for the same (member, permission) while a request is still pending returns the existing id.

AccessRequestpostBffAccess-requestCreate

Parameters

JSON body

Request body

application/json

permissionCodestringRequired

Permission code the caller is asking for (e.g. module-newsletter).

Examplemodule-newsletter

justificationstringRequired

Free-form explanation supplied by the caller (10..1000 characters).

ExamplePotřebuji odeslat kampaň zákazníkovi X. Přiřazený projekt: Y.

Response schema

1 status code documented

200Success

idstringRequired

16-char external id of the created (or existing) request.

alreadyPendingbooleanRequired

True when a pending request for the same permission already existed — the id points to that row.

Response example

application/json

{
  "id": "example_id",
  "alreadyPending": false
}

Request example

POST /bff/access-request/create

post

curl -X POST "https://api.bizkithub.com/bff/access-request/create" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
  "permissionCode": "module-newsletter",
  "justification": "Potřebuji odeslat kampaň zákazníkovi X. Přiřazený projekt: Y."
}'

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key