channels

Post into a thread — markdown renders natively per platform [write]

Changed on

File parts use owned Files API assets and require capabilities.files. Long replies are split into complete platform-sized messages. Supply idempotency_key to avoid duplicate sends on retry; an uncertain or partial send must be inspected before choosing a new key. done and failed are mutually exclusive.

post/channels/threads/{id}/messages

Request

  • Base URL
    https://api.agentsky.dev/v1
  • URL
    https://api.agentsky.dev/v1/channels/threads/{id}/messages
  • Auth
    HTTP bearer

Path parameters

idstring required

The thread id (from message.received or channel events)

Request body

idempotency_keystring

Durable replay key scoped to the persisted owner, connection and thread, independent of bearer token scope. Same-content replays return the accepted receipt even after disconnect; changed content or an unconfirmed send returns 409 without resending.

doneboolean

Resolves the working marker as successful; cannot be true with failed

failedboolean

Resolves the working marker as failed; cannot be true with done

Response

Created

message_idstring
thread_idstring

Changes