logos-delivery-rest-api/api-spec/messagingapi_events_send_by_id.yaml

28 lines
971 B
YAML
Raw Permalink Normal View History

# /messaging/v1/events/send/{requestId}:
get: # get_messaging_v1_events_send_by_id
summary: Poll the send events for one request id
description: Returns the buffered send events for a single request id, then removes them (evict-after-poll). The request id is the value returned by POST /messaging/v1/messages.
operationId: getMessagingSendEventsById
tags:
- messaging
parameters:
- in: path
name: requestId # Note the name is the same as in the path
required: true
schema:
type: string
description: The request id returned by the send endpoint.
responses:
'200':
description: The buffered send events for the request id.
content:
application/json:
schema:
$ref: './schemas/apitypes.yaml#/SendStatus'
'404':
description: No send events buffered for the given request id.
'4XX':
description: Bad request.
'5XX':
description: Unexpected error.