Skip to main content
POST
Create a role

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
allow
(string | object)[]
required
Maximum array length: 32
Maximum string length: 176
Pattern: ^tool:(\*|(builtin|managed|workspace):(\*|[a-z0-9][a-z0-9_-]{0,31}\.\*|[a-z0-9][a-z0-9_-]{0,31}\.[A-Za-z0-9][A-Za-z0-9_.-]{0,127}))$
name
string
required
Maximum string length: 128
deny
string[] | null

Bare built-in tool patterns removed from broader allows. Each pattern must name built-in tools; tool:builtin:* is allowed, while tool:* and external sources are not deniable.

Maximum array length: 32
Maximum string length: 176
Pattern: ^tool:(\*|(builtin|managed|workspace):(\*|[a-z0-9][a-z0-9_-]{0,31}\.\*|[a-z0-9][a-z0-9_-]{0,31}\.[A-Za-z0-9][A-Za-z0-9_.-]{0,127}))$
description
string
Maximum string length: 1024

Response

Replayed role creation.

role
object
required