Msgs

Queue Receive

Receives messages from a topic as competing consumers.

Messages are individually leased for the specified duration. Multiple consumers can receive different messages from the same topic concurrently. Leased messages are skipped until they are acked or their lease expires.

post/api/v1.msgs.queue.receive

Request body

namespacestring nullable

topicstring required

consumer_groupstring required

batch_sizeinteger

lease_duration_msinteger

batch_wait_msinteger nullable

Maximum time (in milliseconds) to wait for messages before returning.

Example request

{
  "namespace": "some_namespace",
  "topic": "some_topic_name",
  "consumer_group": "some_consumer_group"
}

Response

Changes

Changed in 9 of the 53 revisions of this API.141926

Apr 28, 2026a542ced3f5931212See the full diff
- ●
  added the new invalid-input enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid-input enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid-input enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new invalid-input enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new operation-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new operation-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new operation-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new operation-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new server-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new server-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new server-error enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new server-error enum value to the response property for the response status
  response-property-enum-value-added
- ○
  removed the invalid_input enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_input enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_input enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the invalid_input enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the operation_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the operation_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the operation_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the operation_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the server_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the server_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the server_error enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the server_error enum value from the response property for the response status
  response-property-enum-value-removed
Apr 28, 2026b1d873e9a6e44See the full diff
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 21, 2026c3022218176815See the full diff
- ▲
  the response's property type changed from array to string for status
  response-property-type-changed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Apr 14, 20267f5edfb12f871See the full diff
- ▲
  the request property's minLength was increased from 0 to 1
  request-property-min-length-increased
Apr 14, 202614bcce06404b11See the full diff
- ▲
  added the pattern ^[a-zA-Z0-9\-/_.=+]+$ to the request property
  request-property-pattern-added
- ●
  the request property's maxLength was set to 256
  request-property-max-length-set
Apr 13, 2026e6c44b12ecfb2See the full diff
- ▲
  the // response's property type changed from string to integer, and format from date-time to uint64 for status
  response-property-type-changed
- ▲
  the // response's property type changed from string to integer, and format from date-time to uint64 for status
  response-property-type-changed
Apr 10, 20264bfee3499c4c2See the full diff
- ○
  the response property // became required for the status
  response-property-became-required
- ○
  the response's property default value {} was removed for the status
  response-property-default-value-removed
Mar 31, 2026cb1523fc3cdd2See the full diff
- ●
  the request property's min was set to 0.00
  request-property-min-set
- ●
  the request property's min was set to 0.00
  request-property-min-set
Mar 31, 2026f62be26d2a53943See the full diff
- ▲
  the response property // became optional for the status
  response-property-became-optional
- ▲
  the response's property type changed from string to array for status
  response-property-type-changed
- ▲
  the // response's property type changed from integer to string, and format from uint64 to date-time for status
  response-property-type-changed
- ▲
  the // response's property type changed from integer to string, and format from uint64 to date-time for status
  response-property-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ○
  the request property's minLength was decreased from 1 to 0
  request-property-min-length-decreased
- ○
  removed the pattern ^[a-zA-Z0-9\-/_.=+]+$ from the request property
  request-property-pattern-removed
- ○
  the response's property default value {} was added for the status
  response-property-default-value-added
This revision also has 35 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history