Skip to main content
POST
Plan or revoke a contact permission profile grant in a chat scope

Body

application/json
profile
string
required

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

apply
boolean

Apply the planned provider-owned mutations

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

force
boolean

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

to
string

Comma-separated contact: subjects to revoke the profile from

Response

Success — body conforms to the @Returns schema.

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