Grant permission to a user or make public

Grant a role to a user for a resource, or grant public access by using ”*” as userId. Only owners can grant permissions. Public access is allowed only for writer and reader roles.

POST /api/v1/authorization/llm/grant

Python (SDK)

Python

from mka1 import SDK


with SDK(
    bearer_auth="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    sdk.permissions.llm.grant(resource_type="completion", resource_id="my-completion-123", user_id="user-abc456", role="writer")

    # Use the SDK ...

Authorizations

Authorization · string · header · required

Gateway auth: send Authorization: Bearer <mka1-api-key>. For multi-user server-side integrations, you can also send X-On-Behalf-Of: <external-user-id>.

Headers

X-On-Behalf-Of · string

Optional external end-user identifier forwarded by the API gateway.

Body

application/json

resourceType · enum<string> · required

Type of LLM resource

Available options: completion, file, vector_store, conversation, response, skill

resourceId · string · required

Unique identifier for the resource

Minimum string length: 1

Pattern: ^(\*|[a-zA-Z0-9_-]+)$

userId · string · required

Unique identifier for the user, or "*" to grant/revoke public access

Minimum string length: 1

Pattern: ^(\*|[a-zA-Z0-9_-]+)$

role · enum<string> · required

Permission role for the resource (owner > writer > reader)

Available options: owner, writer, reader

Response

204

Permission granted successfully