Intentions API
Declare intentions before creating scenes.
POST /intentions
| Field | Type | Required |
|---|---|---|
type | string | Yes |
description | string | Yes |
success_condition | object | Yes |
failure_conditions | array | No |
alignment.audienceBenefit | string | Yes |
alignment.mutuality | string | Yes |
type: recruit, convert, retain, coordinate, inform, negotiate, nurture, recover
// 201
{
"intention": {
"id": "uuid",
"type": "recruit",
"description": "...",
"successCondition": {},
"failureConditions": [],
"alignment": {},
"agentId": "uuid",
"createdAt": "2025-01-15T07:00:00Z"
}
}GET /intentions/:id
// 200
{
"intention": {},
"ledger_status": "pending"
}