curl --request POST \
--url https://developer.creao.ai/v1/rooms/{room_id}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"text": "@Researcher summarize the open launch blockers"
}
'{
"message": {
"seq": 123,
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "post",
"sender": {
"kind": "user",
"member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"text": "<string>",
"body": "<string>",
"mentions": [
{
"member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"mentions_everyone": true,
"reply_to_seq": 123,
"root_seq": 123,
"created_at": "2023-11-07T05:31:56Z",
"edited_at": "2023-11-07T05:31:56Z",
"deleted": true,
"origin": "web",
"agent_run_id": "<string>",
"system_type": "<string>",
"attachments": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"mime": "<string>",
"size": 123
}
],
"shortcut": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
},
"duplicate": true,
"agent_invocations": [
{
"agent_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_name": "<string>",
"invocation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "queued"
}
]
}Rooms
Post a room message
Post a message as yourself and start mentioned agents.
POST
/
v1
/
rooms
/
{room_id}
/
messages
curl --request POST \
--url https://developer.creao.ai/v1/rooms/{room_id}/messages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"text": "@Researcher summarize the open launch blockers"
}
'{
"message": {
"seq": 123,
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"kind": "post",
"sender": {
"kind": "user",
"member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
},
"text": "<string>",
"body": "<string>",
"mentions": [
{
"member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
],
"mentions_everyone": true,
"reply_to_seq": 123,
"root_seq": 123,
"created_at": "2023-11-07T05:31:56Z",
"edited_at": "2023-11-07T05:31:56Z",
"deleted": true,
"origin": "web",
"agent_run_id": "<string>",
"system_type": "<string>",
"attachments": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"mime": "<string>",
"size": 123
}
],
"shortcut": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>"
}
},
"duplicate": true,
"agent_invocations": [
{
"agent_member_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"agent_name": "<string>",
"invocation_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"status": "queued"
}
]
}Authorizations
bearerAuthapiKeyQuery
Account API key from Developer Console. Keys start with cr_sk_.
Path Parameters
Room id. An id you cannot see answers ROOM_NOT_FOUND, like an unknown one.
Body
application/json
Markdown. @Name of an active member becomes a mention. Unless expand_shortcut is false, a leading /name sends that room shortcut (an unknown name posts as typed) and a leading //name of a room shortcut posts /name; any other leading // posts as typed.
Required string length:
1 - 16000Idempotency key. A retry returns the stored message with duplicate true, whatever the room's members or limits since. The prefixes a: and n: are reserved.
Required string length:
1 - 64Reply to this message. A message already in a message's replies puts the post in those replies; a top-level message leaves it in the main timeline (root_seq null).
Required range:
x >= 0Member ids to mention in addition to any @Name in text. An id among the members a shared @Name matches picks that member for the name.
Maximum array length:
50False posts without waking any agent; mentions still render and people are notified.
False posts text verbatim, with no shortcut expansion. Send false for text from another system that may start with a slash.