AIMEAT · Schema
DirectMessageWire
The message payload carried in a federation delivery (subset of the record).
Artificial IntelligenceDemoPlatformOpen SourceProductivity
Properties
| Name | Type | Description |
|---|---|---|
| id | string | |
| conversationId | string | |
| senderGhii | string | |
| recipientGhii | string | |
| body | string | |
| attachments | array | |
| interactive | object | |
| replyToId | string | |
| createdAt | string |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-direct-message-wire-schema.json",
"title": "DirectMessageWire",
"description": "The message payload carried in a federation delivery (subset of the record).",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/aimeat-io-federation-api-openapi.yml#/components/schemas/DirectMessageWire",
"type": "object",
"properties": {
"id": {
"type": "string",
"format": "uuid"
},
"conversationId": {
"type": "string"
},
"senderGhii": {
"type": "string"
},
"recipientGhii": {
"type": "string"
},
"body": {
"type": "string"
},
"attachments": {
"type": "array",
"items": {
"$ref": "#/$defs/DirectMessageAttachment"
}
},
"interactive": {
"$ref": "#/$defs/InteractivePayload"
},
"replyToId": {
"type": "string",
"format": "uuid"
},
"createdAt": {
"type": "string",
"format": "date-time"
}
},
"$defs": {
"DirectMessageAttachment": {
"type": "object",
"description": "A media object referenced by a direct message (inline via cid:{id} or appended).",
"properties": {
"id": {
"type": "string"
},
"inline": {
"type": "boolean"
},
"storageKey": {
"type": "string"
},
"ownerGhii": {
"type": "string"
},
"originNodeId": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"reference",
"duplicate"
],
"description": "duplicate = recipient's local copy (the norm); reference = transient (pending/awaiting quota)."
},
"localKey": {
"type": "string"
},
"version": {
"type": "string",
"description": "The sent file's createdAt at the send, stamped by the sending node. A copy or a storage grant serves this version only. Absent on attachments stored before 2026-10-22."
},
"mime": {
"type": "string"
},
"size": {
"type": "integer"
},
"name": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"image",
"audio",
"video",
"file"
]
},
"durationSeconds": {
"type": "number",
"description": "Playing length of audio/video, measured when it was recorded. Lets a thread show \"0:14\" before any bytes are fetched.\n"
},
"transcript": {
"type": "object",
"description": "Text of a spoken attachment. `by: sender` arrived WITH the message and is identical in both mailbox copies (so the recipient reads it without paying). `by: recipient` was produced locally with the reader's own key and exists ONLY in their copy — updateMessageAttachments is owner-keyed, so there is no path back to the sender.\n",
"properties": {
"text": {
"type": "string",
"maxLength": 20000
},
"by": {
"type": "string",
"enum": [
"sender",
"recipient"
],
"description": "Server-set on send; a client claim of `recipient` is overwritten with `sender`."
},
"model": {
"type": "string"
},
"lang": {
"type": "string"
},
"seconds": {
"type": "number"
},
"at": {
"type": "string",
"format": "date-time"
}
}
}
}
},
"InteractivePayload": {
"type": "object",
"description": "Structured AskUserQuestion payload on a direct message. role=questions → an agent asks the human a set of option-based questions (rendered as an inline form in the inbox: radio for single-select, checkboxes for multiSelect, plus an always-available \"Other\" freeform). role=answers → the human's reply, with machine-readable picks keyed by question id (the message body still carries a human-readable summary so the thread reads naturally on any peer).",
"required": [
"role"
],
"properties": {
"role": {
"type": "string",
"enum": [
"questions",
"answers"
]
},
"v": {
"type": "integer",
"default": 1
},
"questions": {
"type": "array",
"description": "Present when role=questions.",
"items": {
"type": "object",
"required": [
"id",
"header",
"prompt",
"options"
],
"properties": {
"id": {
"type": "string"
},
"header": {
"type": "string",
"description": "Short chip label (≈ ≤12 chars)."
},
"prompt": {
"type": "string"
},
"multiSelect": {
"type": "boolean",
"default": false
},
"allowOther": {
"type": "boolean",
"default": true
},
"required": {
"type": "boolean",
"default": false
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"label"
],
"properties": {
"id": {
"type": "string"
},
"label": {
"type": "string"
}
}
}
}
}
}
},
"submitLabel": {
"type": "string",
"description": "Optional submit-button label (role=questions)."
},
"answersFor": {
"type": "string",
"description": "The question message id this answers (role=answers)."
},
"answers": {
"type": "object",
"description": "Map of question id → { selected:[optionId], other } (role=answers).",
"additionalProperties": {
"type": "object",
"properties": {
"selected": {
"type": "array",
"items": {
"type": "string"
}
},
"other": {
"type": [
"string",
"null"
]
}
}
}
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aimeat-io-direct-message-wire"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.