--- title: Subscriptions --- [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** # Subscriptions ##### [List Event Subscriptions](https://developers.cloudflare.com/api/python/resources/queues/subresources/subscriptions/methods/list) queues.subscriptions.list(SubscriptionListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[SubscriptionListResponse]()] GET/accounts/{account\_id}/event\_subscriptions/subscriptions ##### [Get Event Subscription](https://developers.cloudflare.com/api/python/resources/queues/subresources/subscriptions/methods/get) queues.subscriptions.get(strsubscription\_id, SubscriptionGetParams\*\*kwargs) -> [SubscriptionGetResponse]() GET/accounts/{account\_id}/event\_subscriptions/subscriptions/{subscription\_id} ##### [Create Event Subscription](https://developers.cloudflare.com/api/python/resources/queues/subresources/subscriptions/methods/create) queues.subscriptions.create(SubscriptionCreateParams\*\*kwargs) -> [SubscriptionCreateResponse]() POST/accounts/{account\_id}/event\_subscriptions/subscriptions ##### [Update Event Subscription](https://developers.cloudflare.com/api/python/resources/queues/subresources/subscriptions/methods/update) queues.subscriptions.update(strsubscription\_id, SubscriptionUpdateParams\*\*kwargs) -> [SubscriptionUpdateResponse]() PATCH/accounts/{account\_id}/event\_subscriptions/subscriptions/{subscription\_id} ##### [Delete Event Subscription](https://developers.cloudflare.com/api/python/resources/queues/subresources/subscriptions/methods/delete) queues.subscriptions.delete(strsubscription\_id, SubscriptionDeleteParams\*\*kwargs) -> [SubscriptionDeleteResponse]() DELETE/accounts/{account\_id}/event\_subscriptions/subscriptions/{subscription\_id} ##### ModelsExpand Collapse
class SubscriptionListResponse: … id: str Unique identifier for the subscription Link to this property created\_at: datetime When the subscription was created formatdate-time Link to this property
destination: Destination Destination configuration for the subscription queue\_id: str ID of the target queue Link to this property type: Literal\["queues.queue"] Type of destination Link to this property
Link to this property enabled: bool Whether the subscription is active Link to this property events: List\[str] List of event types this subscription handles Link to this property modified\_at: datetime When the subscription was last modified formatdate-time Link to this property name: str Name of the subscription Link to this property
source: Source Source configuration for the subscription One of the following:
class SourceMqEventSourceImages: … type: Optional\[Literal\["images"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceKV: … type: Optional\[Literal\["kv"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceR2: … type: Optional\[Literal\["r2"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceSuperSlurper: … type: Optional\[Literal\["superSlurper"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceVectorize: … type: Optional\[Literal\["vectorize"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersAIModel: … model\_name: Optional\[str] Name of the Workers AI model Link to this property type: Optional\[Literal\["workersAi.model"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersBuildsWorker: … type: Optional\[Literal\["workersBuilds.worker"]] Type of source Link to this property worker\_name: Optional\[str] Name of the worker Link to this property
Link to this property
class SourceMqEventSourceWorkersScript: … script\_tag: Optional\[str] Tag of the Worker script Link to this property type: Optional\[Literal\["workers.script"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkflowsWorkflow: … type: Optional\[Literal\["workflows.workflow"]] Type of source Link to this property workflow\_name: Optional\[str] Name of the workflow Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(model)%20subscription_list_response%20%3E%20(schema)>)
class SubscriptionGetResponse: … id: str Unique identifier for the subscription Link to this property created\_at: datetime When the subscription was created formatdate-time Link to this property
destination: Destination Destination configuration for the subscription queue\_id: str ID of the target queue Link to this property type: Literal\["queues.queue"] Type of destination Link to this property
Link to this property enabled: bool Whether the subscription is active Link to this property events: List\[str] List of event types this subscription handles Link to this property modified\_at: datetime When the subscription was last modified formatdate-time Link to this property name: str Name of the subscription Link to this property
source: Source Source configuration for the subscription One of the following:
class SourceMqEventSourceImages: … type: Optional\[Literal\["images"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceKV: … type: Optional\[Literal\["kv"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceR2: … type: Optional\[Literal\["r2"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceSuperSlurper: … type: Optional\[Literal\["superSlurper"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceVectorize: … type: Optional\[Literal\["vectorize"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersAIModel: … model\_name: Optional\[str] Name of the Workers AI model Link to this property type: Optional\[Literal\["workersAi.model"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersBuildsWorker: … type: Optional\[Literal\["workersBuilds.worker"]] Type of source Link to this property worker\_name: Optional\[str] Name of the worker Link to this property
Link to this property
class SourceMqEventSourceWorkersScript: … script\_tag: Optional\[str] Tag of the Worker script Link to this property type: Optional\[Literal\["workers.script"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkflowsWorkflow: … type: Optional\[Literal\["workflows.workflow"]] Type of source Link to this property workflow\_name: Optional\[str] Name of the workflow Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(model)%20subscription_get_response%20%3E%20(schema)>)
class SubscriptionCreateResponse: … id: str Unique identifier for the subscription Link to this property created\_at: datetime When the subscription was created formatdate-time Link to this property
destination: Destination Destination configuration for the subscription queue\_id: str ID of the target queue Link to this property type: Literal\["queues.queue"] Type of destination Link to this property
Link to this property enabled: bool Whether the subscription is active Link to this property events: List\[str] List of event types this subscription handles Link to this property modified\_at: datetime When the subscription was last modified formatdate-time Link to this property name: str Name of the subscription Link to this property
source: Source Source configuration for the subscription One of the following:
class SourceMqEventSourceImages: … type: Optional\[Literal\["images"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceKV: … type: Optional\[Literal\["kv"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceR2: … type: Optional\[Literal\["r2"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceSuperSlurper: … type: Optional\[Literal\["superSlurper"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceVectorize: … type: Optional\[Literal\["vectorize"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersAIModel: … model\_name: Optional\[str] Name of the Workers AI model Link to this property type: Optional\[Literal\["workersAi.model"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersBuildsWorker: … type: Optional\[Literal\["workersBuilds.worker"]] Type of source Link to this property worker\_name: Optional\[str] Name of the worker Link to this property
Link to this property
class SourceMqEventSourceWorkersScript: … script\_tag: Optional\[str] Tag of the Worker script Link to this property type: Optional\[Literal\["workers.script"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkflowsWorkflow: … type: Optional\[Literal\["workflows.workflow"]] Type of source Link to this property workflow\_name: Optional\[str] Name of the workflow Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(model)%20subscription_create_response%20%3E%20(schema)>)
class SubscriptionUpdateResponse: … id: str Unique identifier for the subscription Link to this property created\_at: datetime When the subscription was created formatdate-time Link to this property
destination: Destination Destination configuration for the subscription queue\_id: str ID of the target queue Link to this property type: Literal\["queues.queue"] Type of destination Link to this property
Link to this property enabled: bool Whether the subscription is active Link to this property events: List\[str] List of event types this subscription handles Link to this property modified\_at: datetime When the subscription was last modified formatdate-time Link to this property name: str Name of the subscription Link to this property
source: Source Source configuration for the subscription One of the following:
class SourceMqEventSourceImages: … type: Optional\[Literal\["images"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceKV: … type: Optional\[Literal\["kv"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceR2: … type: Optional\[Literal\["r2"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceSuperSlurper: … type: Optional\[Literal\["superSlurper"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceVectorize: … type: Optional\[Literal\["vectorize"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersAIModel: … model\_name: Optional\[str] Name of the Workers AI model Link to this property type: Optional\[Literal\["workersAi.model"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersBuildsWorker: … type: Optional\[Literal\["workersBuilds.worker"]] Type of source Link to this property worker\_name: Optional\[str] Name of the worker Link to this property
Link to this property
class SourceMqEventSourceWorkersScript: … script\_tag: Optional\[str] Tag of the Worker script Link to this property type: Optional\[Literal\["workers.script"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkflowsWorkflow: … type: Optional\[Literal\["workflows.workflow"]] Type of source Link to this property workflow\_name: Optional\[str] Name of the workflow Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(model)%20subscription_update_response%20%3E%20(schema)>)
class SubscriptionDeleteResponse: … id: str Unique identifier for the subscription Link to this property created\_at: datetime When the subscription was created formatdate-time Link to this property
destination: Destination Destination configuration for the subscription queue\_id: str ID of the target queue Link to this property type: Literal\["queues.queue"] Type of destination Link to this property
Link to this property enabled: bool Whether the subscription is active Link to this property events: List\[str] List of event types this subscription handles Link to this property modified\_at: datetime When the subscription was last modified formatdate-time Link to this property name: str Name of the subscription Link to this property
source: Source Source configuration for the subscription One of the following:
class SourceMqEventSourceImages: … type: Optional\[Literal\["images"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceKV: … type: Optional\[Literal\["kv"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceR2: … type: Optional\[Literal\["r2"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceSuperSlurper: … type: Optional\[Literal\["superSlurper"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceVectorize: … type: Optional\[Literal\["vectorize"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersAIModel: … model\_name: Optional\[str] Name of the Workers AI model Link to this property type: Optional\[Literal\["workersAi.model"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkersBuildsWorker: … type: Optional\[Literal\["workersBuilds.worker"]] Type of source Link to this property worker\_name: Optional\[str] Name of the worker Link to this property
Link to this property
class SourceMqEventSourceWorkersScript: … script\_tag: Optional\[str] Tag of the Worker script Link to this property type: Optional\[Literal\["workers.script"]] Type of source Link to this property
Link to this property
class SourceMqEventSourceWorkflowsWorkflow: … type: Optional\[Literal\["workflows.workflow"]] Type of source Link to this property workflow\_name: Optional\[str] Name of the workflow Link to this property
Link to this property
Link to this property
[Link to this property](<#(resource)%20queues.subscriptions%20%3E%20(model)%20subscription_delete_response%20%3E%20(schema)>)