mirror of
https://github.com/logos-messaging/logos-delivery-rest-api.git
synced 2026-07-23 19:53:16 +00:00
23059b7c0b
Document the high-level messaging client REST surface following the
existing per-endpoint-file structure:
- POST/DELETE /messaging/v1/subscriptions (subscribe by content topic)
- POST /messaging/v1/messages (send a MessageEnvelope -> requestId)
- GET /messaging/v1/events/send[/{requestId}] (poll send events)
- GET /messaging/v1/events/received (poll received messages)
Adds the messaging schemas to schemas/apitypes.yaml (MessagingJsonEnvelope,
MessagingSendResponse, SendEventRecord, SendStatus, ReceivedMessageRecord,
list wrappers) and wires the paths + a `messaging` tag into openapi.yaml.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
17 lines
642 B
YAML
17 lines
642 B
YAML
# /messaging/v1/events/send:
|
|
get: # get_messaging_v1_events_send
|
|
summary: Poll all buffered send events
|
|
description: Returns all buffered send events grouped by request id, then clears them (evict-after-poll). Send events are buffered because REST is a poll-based surface over the interactive MessagingClient events.
|
|
operationId: getMessagingSendEvents
|
|
tags:
|
|
- messaging
|
|
responses:
|
|
'200':
|
|
description: The buffered send events, grouped by request id.
|
|
content:
|
|
application/json:
|
|
schema:
|
|
$ref: './schemas/apitypes.yaml#/SendStatusList'
|
|
'5XX':
|
|
description: Unexpected error.
|