--- title: Labels --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [API Gateway](https://developers.cloudflare.com/api/python/resources/api_gateway) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Labels ##### [List operation labels](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/methods/list) api\_gateway.labels.list(LabelListParams\*\*kwargs) -> SyncV4PagePaginationArray\[[LabelListResponse]()] GET/zones/{zone\_id}/api\_gateway/labels ##### ModelsExpand Collapse
class LabelListResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property mapped\_resources: Optional\[object] Provides counts of what resources are linked to this label Link to this property
[Link to this property](<#(resource)%20api_gateway.labels%20%3E%20(model)%20label_list_response%20%3E%20(schema)>) #### LabelsUser ##### [Create user-defined operation labels](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/methods/bulk_create) api\_gateway.labels.user.bulk\_create(UserBulkCreateParams\*\*kwargs) -> SyncSinglePage\[[UserBulkCreateResponse]()] POST/zones/{zone\_id}/api\_gateway/labels/user ##### [Delete user-defined operation labels](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/methods/bulk_delete) api\_gateway.labels.user.bulk\_delete(UserBulkDeleteParams\*\*kwargs) -> SyncSinglePage\[[UserBulkDeleteResponse]()] DELETE/zones/{zone\_id}/api\_gateway/labels/user ##### [Get a user-defined operation label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/methods/get) api\_gateway.labels.user.get(strname, UserGetParams\*\*kwargs) -> [UserGetResponse]() GET/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### [Update a user-defined operation label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/methods/update) api\_gateway.labels.user.update(strname, UserUpdateParams\*\*kwargs) -> [UserUpdateResponse]() PUT/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### [Edit a user-defined operation label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/methods/edit) api\_gateway.labels.user.edit(strname, UserEditParams\*\*kwargs) -> [UserEditResponse]() PATCH/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### [Delete a user-defined operation label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/methods/delete) api\_gateway.labels.user.delete(strname, UserDeleteParams\*\*kwargs) -> [UserDeleteResponse]() DELETE/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### ModelsExpand Collapse
class UserBulkCreateResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user%20%3E%20(model)%20user_bulk_create_response%20%3E%20(schema)>)
class UserBulkDeleteResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user%20%3E%20(model)%20user_bulk_delete_response%20%3E%20(schema)>)
class UserGetResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property mapped\_resources: Optional\[object] Provides counts of what resources are linked to this label Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user%20%3E%20(model)%20user_get_response%20%3E%20(schema)>)
class UserUpdateResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user%20%3E%20(model)%20user_update_response%20%3E%20(schema)>)
class UserEditResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user%20%3E%20(model)%20user_edit_response%20%3E%20(schema)>)
class UserDeleteResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user%20%3E%20(model)%20user_delete_response%20%3E%20(schema)>) #### LabelsUserResources #### LabelsUserResourcesOperation ##### [Replace operations attached to a user-defined label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/user/subresources/resources/subresources/operation/methods/update) api\_gateway.labels.user.resources.operation.update(strname, OperationUpdateParams\*\*kwargs) -> [OperationUpdateResponse]() PUT/zones/{zone\_id}/api\_gateway/labels/user/{name}/resources/operation ##### ModelsExpand Collapse
class OperationUpdateResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property mapped\_resources: Optional\[object] Provides counts of what resources are linked to this label Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.user.resources.operation%20%3E%20(model)%20operation_update_response%20%3E%20(schema)>) #### LabelsManaged ##### [Get a managed operation label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/managed/methods/get) api\_gateway.labels.managed.get(strname, ManagedGetParams\*\*kwargs) -> [ManagedGetResponse]() GET/zones/{zone\_id}/api\_gateway/labels/managed/{name} ##### ModelsExpand Collapse
class ManagedGetResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property mapped\_resources: Optional\[object] Provides counts of what resources are linked to this label Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.managed%20%3E%20(model)%20managed_get_response%20%3E%20(schema)>) #### LabelsManagedResources #### LabelsManagedResourcesOperation ##### [Replace operations attached to a managed label](https://developers.cloudflare.com/api/python/resources/api_gateway/subresources/labels/subresources/managed/subresources/resources/subresources/operation/methods/update) api\_gateway.labels.managed.resources.operation.update(strname, OperationUpdateParams\*\*kwargs) -> [OperationUpdateResponse]() PUT/zones/{zone\_id}/api\_gateway/labels/managed/{name}/resources/operation ##### ModelsExpand Collapse
class OperationUpdateResponse: … created\_at: datetime formatdate-time Link to this property description: str The description of the label Link to this property last\_updated: datetime formatdate-time Link to this property metadata: object Metadata for the label Link to this property name: str The name of the label Link to this property
source: Literal\["user", "managed"] - user - label is owned by the user - managed - label is owned by cloudflare One of the following: "user" Link to this property "managed" Link to this property
Link to this property mapped\_resources: Optional\[object] Provides counts of what resources are linked to this label Link to this property
[Link to this property](<#(resource)%20api_gateway.labels.managed.resources.operation%20%3E%20(model)%20operation_update_response%20%3E%20(schema)>)