Check user permission

Check whether the authenticated caller has a specific role on a resource.

GET /api/v1/authorization/llm/check

Python (SDK)

Python

from mka1 import SDK


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

    res = sdk.permissions.llm.check(resource_type="conversation", resource_id="<id>", role="writer")

    # Handle response
    print(res)

200

{
  "allowed": true
}

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.

Query Parameters

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_-]+)$

role · enum<string> · required

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

Available options: owner, writer, reader

Response

200

application/json

Successfully checked permission

allowed · boolean · required

Whether the user has the specified permission