Skip to main content
POST
Python (SDK)

Authorizations

Authorization
string
header
required

Send Authorization: Bearer , using an MKA1 API key for automation or an OAuth API access token for a signed-in application. Use a dynamic security callback to refresh OAuth access tokens. Browser session-only operations still require their declared cookie.

Headers

X-On-Behalf-Of
string

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

Path Parameters

skill_id
string
required

The ID of the skill.

Body

application/json

Grants a role on the resource, replacing any role the principal already holds. grantee_type defaults to user.

grantee_type
any
required

Grants to one principal.

user_id
string
required

A member's user id, or the end-user id a request is delegated to with X-On-Behalf-Of. May not contain / or whitespace, and may not be ., .., * or team.

Minimum string length: 1
role
enum<string>
required

The role to grant. writer includes reader.

Available options:
writer,
reader

Response

200 - application/json

OK

A role held on a skill by a principal, or by every member of the skill's team.

object
any
required

The object type, which is always 'skill.permission'.

skill_id
string
required

The ID of the skill.

grantee_type
enum<string>
required

Who the permission applies to: one principal (user), or every member of the resource's team (team).

Available options:
user,
team
user_id
string | null
required

The principal the permission applies to: a member's user id, or the end-user id a request is delegated to with X-On-Behalf-Of. null when the permission applies to the skill's team.

role
enum<string>
required

The role held on the resource. owner is the resource's creator and cannot be granted; writer includes reader.

Available options:
owner,
writer,
reader