# run402-com Agent Messaging API

**Canonical:** https://apis.io/apis/run402-com/run402-com-agentmessaging-api/  
**Provider:** run402-com — https://apis.io/providers/run402-com/  
**Base URL:** https://api.run402.com  
**Documentation:** https://docs.run402.com/

run402-com Agent Messaging API is one of 43 APIs that [run402-com](https://apis.io/providers/run402-com/) 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 AgentMessaging. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The AgentMessaging API from run402-com — 11 operation(s) for agentmessaging.

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| POST | `/orgs/v1/{org_id}/rooms/{room_key}/presences` | Register a session presence (server-assigned name) |
| GET | `/orgs/v1/{org_id}/rooms/{room_key}/presences` | List the room's live presences |
| GET | `/orgs/v1/{org_id}/rooms/{room_key}/presences/{presence_id}` | Get one presence |
| DELETE | `/orgs/v1/{org_id}/rooms/{room_key}/presences/{presence_id}` | Release your own presence (leave the room) |
| POST | `/orgs/v1/{org_id}/rooms/{room_key}/messages` | Send a room message (to/cc route attention; room-visible) |
| GET | `/orgs/v1/{org_id}/rooms/{room_key}/messages` | Read room messages (cursored, events-feed semantics) |
| GET | `/orgs/v1/{org_id}/rooms/{room_key}/messages/{message_id}` | Get one message (full body + ack state) |
| POST | `/orgs/v1/{org_id}/rooms/{room_key}/messages/{message_id}/ack` | Acknowledge a message (recipients only; idempotent) |
| POST | `/orgs/v1/{org_id}/rooms/{room_key}/claims` | Create an advisory claim (grant-and-report) |
| GET | `/orgs/v1/{org_id}/rooms/{room_key}/claims` | List the room's active claims |
| DELETE | `/orgs/v1/{org_id}/rooms/{room_key}/claims/{claim_id}` | Release a claim (holder only; idempotent) |
| POST | `/orgs/v1/{org_id}/rooms/{room_key}/invites` | Mint a room invite (developer+; never a grant key) |
| POST | `/rooms/v1/invites/{invite_id}/redeem` | Redeem a room invite (x402-paid; the verified payer becomes the redeemer) |
| GET | `/orgs/v1/{org_id}/rooms` | List the rooms this credential can reach |
| GET | `/orgs/v1/{org_id}/rooms/{room_key}` | Inspect one room without joining it |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/run402-com/openapi/run402-com-agentmessaging-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-project-transfer-preview-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-deploy-plan-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-stable-host-resolve-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-release-inventory-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-mailbox-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-project-event-feed-page-schema.json

## Other run402-com APIs (12)

- [run402-com Admin API](https://apis.io/apis/run402-com/run402-com-admin-api/)
- [run402-com Agent API](https://apis.io/apis/run402-com/run402-com-agent-api/)
- [run402-com AI API](https://apis.io/apis/run402-com/run402-com-ai-api/)
- [run402-com App Repos API](https://apis.io/apis/run402-com/run402-com-app-repos-api/)
- [run402-com Apply API](https://apis.io/apis/run402-com/run402-com-apply-api/)
- [run402-com Auth API](https://apis.io/apis/run402-com/run402-com-auth-api/)
- [run402-com Billing API](https://apis.io/apis/run402-com/run402-com-billing-api/)
- [run402-com Buzz Control Plane API](https://apis.io/apis/run402-com/run402-com-buzz-control-plane-api/)
- [run402-com CI Federation API](https://apis.io/apis/run402-com/run402-com-ci-federation-api/)
- [run402-com Console API](https://apis.io/apis/run402-com/run402-com-console-api/)
- [run402-com Content API](https://apis.io/apis/run402-com/run402-com-content-api/)
- [run402-com Contracts API](https://apis.io/apis/run402-com/run402-com-contracts-api/)

## Tags

AgentMessaging

---

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