--- title: Messages --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Queues](https://developers.cloudflare.com/api/python/resources/queues) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Messages ##### [Push Message](https://developers.cloudflare.com/api/python/resources/queues/subresources/messages/methods/push) queues.messages.push(strqueue\_id, MessagePushParams\*\*kwargs) -> [MessagePushResponse]() POST/accounts/{account\_id}/queues/{queue\_id}/messages ##### [Acknowledge + Retry Queue Messages](https://developers.cloudflare.com/api/python/resources/queues/subresources/messages/methods/ack) queues.messages.ack(strqueue\_id, MessageAckParams\*\*kwargs) -> [MessageAckResponse]() POST/accounts/{account\_id}/queues/{queue\_id}/messages/ack ##### [Pull Queue Messages](https://developers.cloudflare.com/api/python/resources/queues/subresources/messages/methods/pull) queues.messages.pull(strqueue\_id, MessagePullParams\*\*kwargs) -> [MessagePullResponse]() POST/accounts/{account\_id}/queues/{queue\_id}/messages/pull ##### [Push Message Batch](https://developers.cloudflare.com/api/python/resources/queues/subresources/messages/methods/bulk_push) queues.messages.bulk\_push(strqueue\_id, MessageBulkPushParams\*\*kwargs) -> [MessageBulkPushResponse]() POST/accounts/{account\_id}/queues/{queue\_id}/messages/batch ##### [Peek Queue Messages](https://developers.cloudflare.com/api/python/resources/queues/subresources/messages/methods/peek) queues.messages.peek(strqueue\_id, MessagePeekParams\*\*kwargs) -> [MessagePeekResponse]() POST/accounts/{account\_id}/queues/{queue\_id}/messages/peek ##### [Purge Peeked Queue Messages](https://developers.cloudflare.com/api/python/resources/queues/subresources/messages/methods/purge) queues.messages.purge(strqueue\_id, MessagePurgeParams\*\*kwargs) -> [MessagePurgeResponse]() POST/accounts/{account\_id}/queues/{queue\_id}/messages/purge ##### ModelsExpand Collapse

class MessagePushResponse: …

metadata: Optional\[Metadata]

metrics: Optional\[MetadataMetrics] Best-effort metrics for the queue. Values may be approximate due to the distributed nature of queues.

backlog\_bytes: float The size in bytes of unacknowledged messages in the queue. Link to this property backlog\_count: float The number of unacknowledged messages in the queue. Link to this property oldest\_message\_timestamp\_ms: float Unix timestamp in milliseconds of the oldest unacknowledged message in the queue. Returns 0 if unknown. Link to this property

Link to this property

[Link to this property](<#(resource)%20queues.messages%20%3E%20(model)%20message_push_response%20%3E%20(schema)>)

class MessageAckResponse: …

ack\_count: Optional\[float] The number of messages that were succesfully acknowledged. Link to this property retry\_count: Optional\[float] The number of messages that were succesfully retried. Link to this property warnings: Optional\[Dict\[str, str]] Map of lease IDs to warning messages encountered during acknowledgement. Link to this property

[Link to this property](<#(resource)%20queues.messages%20%3E%20(model)%20message_ack_response%20%3E%20(schema)>)

class MessagePullResponse: …

message\_backlog\_count: Optional\[float] The number of unacknowledged messages in the queue. Link to this property

messages: Optional\[List\[Message]]

id: Optional\[str] Link to this property attempts: Optional\[float] Link to this property body: Optional\[str] Link to this property lease\_id: Optional\[str] An ID that represents an “in-flight” message that has been pulled from a Queue. You must hold on to this ID and use it to acknowledge this message. Link to this property metadata: Optional\[object] Link to this property timestamp\_ms: Optional\[float] Link to this property

Link to this property

metadata: Optional\[Metadata]

metrics: Optional\[MetadataMetrics] Best-effort metrics for the queue. Values may be approximate due to the distributed nature of queues.

Link to this property

[Link to this property](<#(resource)%20queues.messages%20%3E%20(model)%20message_pull_response%20%3E%20(schema)>)

class MessageBulkPushResponse: …

metadata: Optional\[Metadata]

metrics: Optional\[MetadataMetrics] Best-effort metrics for the queue. Values may be approximate due to the distributed nature of queues.

Link to this property

[Link to this property](<#(resource)%20queues.messages%20%3E%20(model)%20message_bulk_push_response%20%3E%20(schema)>)

class MessagePeekResponse: …

messages: Optional\[List\[Message]]

id: Optional\[str] Link to this property attempts: Optional\[float] Link to this property body: Optional\[str] Link to this property metadata: Optional\[object] Link to this property ref: Optional\[str] An opaque reference to a peeked message. You must hold on to this value and use it to purge the message. Link to this property timestamp\_ms: Optional\[float] Link to this property

Link to this property

[Link to this property](<#(resource)%20queues.messages%20%3E%20(model)%20message_peek_response%20%3E%20(schema)>)

class MessagePurgeResponse: …

errors: Optional\[List\[Error]] Errors encountered while purging messages.

message: Optional\[str] Link to this property

Link to this property warnings: Optional\[Dict\[str, str]] Map of refs to warning messages encountered during purge. Link to this property

[Link to this property](<#(resource)%20queues.messages%20%3E%20(model)%20message_purge_response%20%3E%20(schema)>)