curl --request POST \
--url 'https://api.stateset.com/api/v1/a2a/messages' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"from_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message_type": "string",
"payload": {},
"to_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"attempts": 1,
"conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"created_at": "2026-08-31T14:22:05Z",
"from_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message_type": "string",
"sequence_number": 1001,
"status": "pending",
"to_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Send a message
Send a message
POST
/
api
/
v1
/
a2a
/
messages
curl --request POST \
--url 'https://api.stateset.com/api/v1/a2a/messages' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"from_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message_type": "string",
"payload": {},
"to_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"attempts": 1,
"conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"created_at": "2026-08-31T14:22:05Z",
"from_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message_type": "string",
"sequence_number": 1001,
"status": "pending",
"to_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Request body
SendMessageRequest
string,null
string
required
string
required
object
required
string
required
Response
MessageResponse
integer (int32)
required
string
required
string
required
string
required
string
required
string
required
integer (int64)
required
string
required
string
required
Status codes
| Code | Meaning |
|---|---|
201 | — |
400 | — |
curl --request POST \
--url 'https://api.stateset.com/api/v1/a2a/messages' \
--header "Authorization: Bearer $STATESET_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"from_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message_type": "string",
"payload": {},
"to_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}'
{
"attempts": 1,
"conversation_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"created_at": "2026-08-31T14:22:05Z",
"from_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"message_type": "string",
"sequence_number": 1001,
"status": "pending",
"to_agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
}
Last modified on August 31, 2026