# AIMEAT Direct Messages API

**Canonical:** https://apis.io/apis/aimeat-io/aimeat-io-direct-messages-api/  
**Provider:** AIMEAT — https://apis.io/providers/aimeat-io/  
**Base URL:** https://aimeat-finland-001-genesis.overscalesolutions.com  
**Documentation:** https://aimeat.io/v1/spec

AIMEAT Direct Messages API is one of 100 APIs that [AIMEAT](https://apis.io/providers/aimeat-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Direct Messages. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Human↔human (GHII↔GHII) direct messaging with first-contact consent, federation delivery, and media attachments

## Operations (29)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/messages/groups` | Open a group chat with its first message |
| GET | `/v1/messages/groups/invitations` | Group chats the caller is invited to and has not answered |
| GET | `/v1/messages/groups/{conversationId}` | The members of a group chat, for a member |
| POST | `/v1/messages/groups/{conversationId}/members` | The manager adds and removes members |
| POST | `/v1/messages/groups/{conversationId}/leave` | Leave a group chat |
| POST | `/v1/messages/groups/{conversationId}/invitation` | Accept or decline an invitation to a group chat |
| POST | `/v1/messages/as-owner` | An agent sends a direct message in its owner's name |
| POST | `/v1/messages` | Send a direct message |
| POST | `/v1/messages/broadcast` | Send one message to many (broadcast / announcement / poll) |
| GET | `/v1/messages/broadcast/{id}` | Aggregated broadcast results |
| GET | `/v1/messages/agent-inbox` | List federated DMs addressed to the calling agent (recipient = the agent) |
| GET | `/v1/messages/agent-thread/{conversationId}` | Full DM thread as the calling agent sees it (sent + received) |
| GET | `/v1/messages/inbox` | List inbox (inbound messages from accepted contacts) |
| GET | `/v1/messages/conversations` | List conversation threads (accepted) |
| GET | `/v1/messages/overview` | The whole inbox mount in one call (requests + conversations + flags + tracked +… |
| GET | `/v1/messages/conversations/{conversationId}` | Get a full conversation thread |
| POST | `/v1/messages/conversations/{conversationId}/read` | Mark a conversation read (fires read receipts) |
| PATCH | `/v1/messages/{id}/read` | Mark a single message read (fires a read receipt) |
| POST | `/v1/messages/{id}/reactions` | Acknowledge one message with a mark instead of a reply |
| DELETE | `/v1/messages/{id}/reactions` | Take your own mark back |
| POST | `/v1/messages/{id}/attachments/{attId}/transcribe` | Turn a voice attachment into text |
| DELETE | `/v1/messages/{id}` | Delete a message from the owner's mailbox |
| GET | `/v1/messages/organize` | How the owner's Messages list is organised |
| PUT | `/v1/messages/organize` | Change how the owner's Messages list is organised |
| POST | `/v1/messages/organize/archive` | Archive conversations, or bring them back |
| GET | `/v1/messages/requests` | List pending first-contact requests |
| POST | `/v1/messages/requests/{contactId}/accept` | Accept a first-contact request |
| POST | `/v1/messages/contacts/{contactId}/block` | Block a contact (or proactively hard-block) |
| GET | `/v1/messages/contacts` | List contacts and their states |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-direct-messages-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-def-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-schedule-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-ai-provenance-declaration-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-app-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-memory-write-schema.json

## Other AIMEAT APIs (12)

- [AIMEAT A2A API](https://apis.io/apis/aimeat-io/aimeat-io-a2a-api/)
- [AIMEAT Actions API](https://apis.io/apis/aimeat-io/aimeat-io-actions-api/)
- [AIMEAT Admin API](https://apis.io/apis/aimeat-io/aimeat-io-admin-api/)
- [AIMEAT Agent Crew API](https://apis.io/apis/aimeat-io/aimeat-io-agent-crew-api/)
- [AIMEAT Agent Directives API](https://apis.io/apis/aimeat-io/aimeat-io-agent-directives-api/)
- [AIMEAT Agent Goals API](https://apis.io/apis/aimeat-io/aimeat-io-agent-goals-api/)
- [AIMEAT Agent Integration API](https://apis.io/apis/aimeat-io/aimeat-io-agent-integration-api/)
- [AIMEAT Agent Messages API](https://apis.io/apis/aimeat-io/aimeat-io-agent-messages-api/)
- [AIMEAT Agent Onboarding API](https://apis.io/apis/aimeat-io/aimeat-io-agent-onboarding-api/)
- [AIMEAT Agent Tasks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-tasks-api/)
- [AIMEAT Agent Telemetry API](https://apis.io/apis/aimeat-io/aimeat-io-agent-telemetry-api/)
- [AIMEAT Agent Webhooks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-webhooks-api/)

## Tags

Direct Messages

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/aimeat-io/aimeat-io-direct-messages-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/aimeat-io/.