Skip to content

Publish a new intention

POST
/api/v1/coordination/intentions

Publish an agent intention to the shared board with conflict detection.

Authorizations

Request Body required

Request body for publishing a new intention.

Attributes: agent_role: Role of the publishing agent. intention_type: Category — outreach, campaign, purchase, content, strategy. target: Who or what is targeted. details: Free-form detail payload. planned_at: When the action is planned. target_audience: Optional audience segment details. expires_at: Optional expiry for the intention.

object
agent_role
required

Agent role publishing the intention

string
details
object
key
additional properties
any
expires_at
Any of:
string format: date-time
intention_type
required

Category of the intention

string
planned_at
required

When the action is planned

string format: date-time
target
required

Target of the intention

string
target_audience
Any of:
object
key
additional properties
any

Responses

201

Successful Response

Response for publishing a new intention.

object
conflicts
required
Array<object>
object
key
additional properties
any
intention
required
object
key
additional properties
any

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string