chat.yakka.postMessage
Write a message to the author's own repo, under their OAuth grant (Law 4: write admission belongs to the author's PDS, never to the appview). The appview is the caller's agent here, not an authority — a refusal from the PDS is reported as one rather than absorbed. Resolves once the record is ingested and sequenced, by which time the client has already shown a provisional copy and will reconcile on (uri, cid) (ADR 0011).
Details · procedure
| Kind | procedure |
|---|---|
| Authority | yakka.chat |
| Indexed |
Checks
Validunlimited-stringdefs.input.properties.channelNo maxLength, maxGraphemes or format limits this string.
{
"$type": "com.atproto.lexicon.schema",
"defs": {
"input": {
"properties": {
"body": {
"description": "The message text, in the same spelling the view returns it (chat.yakka.defs#messageView). The record it becomes calls the field `text`.",
"maxGraphemes": 2000,
"maxLength": 10000,
"type": "string"
},
"channel": {
"type": "string"
},
"replyTo": {
"description": "The message being replied to. Display order of a thread still comes from the view sequence.",
"format": "at-uri",
"type": "string"
}
},
"required": [
"channel",
"body"
],
"type": "object"
},
"main": {
"description": "Write a message to the author's own repo, under their OAuth grant (Law 4: write admission belongs to the author's PDS, never to the appview).\n\nThe appview is the caller's agent here, not an authority — a refusal from the PDS is reported as one rather than absorbed. Resolves once the record is ingested and sequenced, by which time the client has already shown a provisional copy and will reconcile on (uri, cid) (ADR 0011).",
"errors": [
{
"name": "ChannelNotFound"
},
{
"description": "The mint declined for this viewer (ADR 0007).",
"name": "ChannelForbidden"
},
{
"description": "The author's own PDS refused the write. Theirs to explain, not ours to override.",
"name": "WriteRefused"
},
{
"description": "The record was written and the appview has not yet seen it come back through the sync path.\n\nThe write SUCCEEDED. Do not retry it — a retry writes a second record, and the two are different messages with different URIs, not one message sent twice. The message will arrive over the socket or on the next timeline read; a client should leave its provisional copy in place rather than marking it failed.\n\nThis is separate from WriteRefused because the two call for opposite responses, and a client that conflated them would double-post every time ingest ran slow.",
"name": "WriteUnconfirmed"
}
],
"input": {
"encoding": "application/json",
"schema": {
"ref": "#input",
"type": "ref"
}
},
"output": {
"encoding": "application/json",
"schema": {
"ref": "chat.yakka.defs#messageView",
"type": "ref"
}
},
"type": "procedure"
}
},
"id": "chat.yakka.postMessage",
"lexicon": 1
}