Skip to main content
POST
Submit pact for approval

Headers

X-API-Key
string | null

Body

application/json

Request body for POST /pacts/submit.

wallet_id
string<uuid>
required

Target wallet UUID.

intent
string
required

Natural language description of the task.

Required string length: 1 - 2000
spec
PactSpec · object
required

The pact specification.

original_intent
string | null

Raw user input that originated this pact request. For multi-turn conversations, messages are concatenated.

name
string | null

Human-readable pact name. Derived from intent if absent.

Required string length: 1 - 255
recipe_slugs
string[] | null

Slugs of recipes (from the recipes table) to associate with this pact.

Response

Already exists (idempotent). Successful Response

result
PactSubmitResponse · object
required

Response for POST /pacts/submit.

success
boolean
default:true
suggestion
string
default:""
message
string
default:""
meta
PaginationMeta · object | null

Pagination metadata for list responses.

Supports both legacy offset-based and cursor-based pagination. Cursor fields (has_more, after, before) are populated for cursor-paginated endpoints. Legacy fields (offset, limit) are populated when the caller uses the deprecated offset parameter.