Skip to main content
POST
Resolve a gap or create an owner-reviewed improvement

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
gap
string<uuid>
required

Stable knowledge-gap public ID.

Body

application/json
action
enum<string>
required
Available options:
add_q_and_a,
add_knowledge,
add_rule,
dismiss,
mark_resolved
title
string | null
Maximum string length: 160
content
string | null

Required for Q&A, knowledge, and rule drafts. It is never published or enabled automatically.

Maximum string length: 10000

Response

Successful data envelope.

data
any
required
meta
object
required