Skip to content
UltimateTeam.ai Docs

Publish a new intention

POST
/api/v1/coordination/intentions
curl --request POST \
  --url https://api.ultimateteam.ai/api/v1/coordination/intentions \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <X-API-Key>' \
  --data '{ "agent_role": "example", "details": {}, "expires_at": "2026-04-15T12:00:00Z", "intention_type": "example", "planned_at": "2026-04-15T12:00:00Z", "target": "example", "target_audience": {} }'

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

Authorizations

Section titled “Authorizations”

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
PublishIntentionRequest

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

Agent role publishing the intention

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

Category of the intention

string
planned_at
required
Planned At

When the action is planned

string format: date-time
target
required
Target

Target of the intention

string
target_audience
Any of:
object
key
additional properties
any
Examplegenerated
{
  "agent_role": "example",
  "details": {},
  "expires_at": "2026-04-15T12:00:00Z",
  "intention_type": "example",
  "planned_at": "2026-04-15T12:00:00Z",
  "target": "example",
  "target_audience": {}
}

Responses

Section titled “ Responses ”

201

Section titled “201”

Successful Response

Media typeapplication/json
PublishIntentionResponse

Response for publishing a new intention.

object
conflicts
required
Conflicts
Array<object>
object
key
additional properties
any
intention
required
Intention
object
key
additional properties
any
Examplegenerated
{
  "conflicts": [
    {}
  ],
  "intention": {}
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}