Skip to main content
PATCH
Edit or enable an Agent conversation rule

Authorizations

Authorization
string
header
required

A Contact Button scoped bearer key. Send Authorization: Bearer <token>. Token abilities are enforced independently of workspace membership; both checks must pass. Interactive MCP clients use registered OAuth applications, Authorization Code + PKCE, audience-bound tokens, and explicit workspace grants. Personal Sanctum tokens remain supported.

Headers

Idempotency-Key
string

Stable 8–120 character key for safe mutation retries.

Required string length: 8 - 120

Path Parameters

workspace
string<uuid>
required
agent
string<uuid>
required
rule
string<uuid>
required

Stable Agent rule public ID.

Body

application/json
version
integer
required

Current rule-set version returned by the latest read. A stale version returns HTTP 409.

Required range: x >= 0
title
string | null
Maximum string length: 120
template_key
enum<string> | null
Available options:
unsupported_topics,
sensitive_questions,
commitments,
escalation,
promoted_services,
null
instruction
string
Maximum string length: 4000
enabled
boolean

Response

Successful data envelope.

data
any
required
meta
object
required