Skip to main content
POST
Plan or apply a provider-owned permission profile to subjects

Body

application/json
profile
string
required

Permission profile/tag name, with or without permission- prefix

agent
string

Comma-separated executor agents whose runtime ceiling must include the profile capabilities

apply
boolean

Apply the planned provider-owned mutations

capabilities
string

Comma-separated capabilities, e.g. mutate:image:generate,execute:executable:curl

chat
string

Scope contact grants to one chat (canonical chat id, platform chat id, or 'current'). Threads inherit their chat.

chatTag
string

Scope contact grants to every chat carrying this chat tag

description
string

Description when creating/updating the profile tag

force
boolean

Explicitly use the global (all chats) contact scope. Prefer --chat; ask the human before going global.

label
string

Human label when creating/updating the profile tag

to
string

Comma-separated subjects to receive the profile: agent: (identity ceiling) or contact: (user overlay; requires --chat, --chat-tag or --force).

Response

Success — body conforms to the @Returns schema.

agentCeilings
string[]
required
capabilities
object[]
required
changedCount
number
required
confirmation
object
required
dryRun
boolean
required
force
boolean
required
hints
string[]
required
label
string
required
operations
object[]
required
profile
string
required
scopes
object[]
required
tagSlug
string
required
targets
object[]
required
description
string
nextCommand
string