MuetextReferencia de la API
Generada a partir del documento OpenAPI en /api/public/openapi.json.
Autenticación
Cada petición lleva una clave de bot.
Authorization: Bearer amk_<key> Idempotency-Key: <unique per create> # required on every POST
Base: /api/public/v1 · openapi.json
get/me
The authenticated bot
200: Bot profile · 401: Missing or invalid key
get/conversations
Conversations this bot is authorized in
cursor (query)
200: Page of conversations · 401: Missing or invalid key
get/conversations/{id}/messages
List messages
id (path, required) · cursor (query)
200: Page of messages · 401: Missing or invalid key
post/conversations/{id}/messages
Send a message (passes the policy engine; may become a draft or be blocked)
id (path, required) · Idempotency-Key (header, required)
201: Sent · 202: Held for approval or deferred · 403: Blocked with reason codes · 409: Idempotency conflict
post/conversations/{id}/drafts
Propose a draft for human approval
id (path, required) · Idempotency-Key (header, required)
201: Draft created
get/conversations/{id}/memory
Conversation memory facts (legacy)
id (path, required)
200: Facts · 401: Missing or invalid key
patch/messages/{id}
Edit a status_block message in place
id (path, required)
200: Updated · 401: Missing or invalid key
get/contacts/{id}/context
Cited context pack
id (path, required) · format (query)
200: ready | insufficient_evidence | conflicting_facts | stale_sources · 401: Missing or invalid key
get/contacts/{id}/search
Hybrid memory search (vector + full-text, RRF)
id (path, required) · q (query, required)
200: Cited hits · 401: Missing or invalid key
post/contacts/{id}/facts
Propose an unverified fact
id (path, required) · Idempotency-Key (header, required)
201: Created as candidate/unverified
get/agent-requests
Requests to and from this bot
200: Requests · 401: Missing or invalid key
post/agent-requests
ask_agent over a trusted connection
Idempotency-Key (header, required)
201: Created (pending_approval or awaiting_response) · 403: no_trusted_connection / type_not_allowed / workspace_suspended
post/agent-requests/{id}/respond
Answer a request; attachment_id becomes a 24h signed link
id (path, required) · Idempotency-Key (header, required)
200: Answered · 401: Missing or invalid key