--- title: Labels --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/typescript) [API Gateway](https://developers.cloudflare.com/api/typescript/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/typescript/resources/api_gateway/subresources/labels/methods/list) client.apiGateway.labels.list(LabelListParams {zone\_id, direction, filter, 5 more } params, RequestOptionsoptions?): V4PagePaginationArray< [LabelListResponse]() {created\_at, description, last\_updated, 4 more } > GET/zones/{zone\_id}/api\_gateway/labels ##### ModelsExpand Collapse

LabelListResponse {created\_at, description, last\_updated, 4 more }

created\_at: string formatdate-time Link to this property description: string The description of the label Link to this property last\_updated: string formatdate-time Link to this property metadata: unknown Metadata for the label Link to this property name: string The name of the label Link to this property

source: "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?: unknown 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/typescript/resources/api_gateway/subresources/labels/subresources/user/methods/bulk_create) client.apiGateway.labels.user.bulkCreate(UserBulkCreateParams {zone\_id, body } params, RequestOptionsoptions?): SinglePage< [UserBulkCreateResponse]() {created\_at, description, last\_updated, 3 more } > POST/zones/{zone\_id}/api\_gateway/labels/user ##### [Delete user-defined operation labels](https://developers.cloudflare.com/api/typescript/resources/api_gateway/subresources/labels/subresources/user/methods/bulk_delete) client.apiGateway.labels.user.bulkDelete(UserBulkDeleteParams {zone\_id } params, RequestOptionsoptions?): SinglePage< [UserBulkDeleteResponse]() {created\_at, description, last\_updated, 3 more } > DELETE/zones/{zone\_id}/api\_gateway/labels/user ##### [Get a user-defined operation label](https://developers.cloudflare.com/api/typescript/resources/api_gateway/subresources/labels/subresources/user/methods/get) client.apiGateway.labels.user.get(stringname, UserGetParams {zone\_id, with\_mapped\_resource\_counts } params, RequestOptionsoptions?): [UserGetResponse]() {created\_at, description, last\_updated, 4 more } GET/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### [Update a user-defined operation label](https://developers.cloudflare.com/api/typescript/resources/api_gateway/subresources/labels/subresources/user/methods/update) client.apiGateway.labels.user.update(stringname, UserUpdateParams {zone\_id, description, metadata } params, RequestOptionsoptions?): [UserUpdateResponse]() {created\_at, description, last\_updated, 3 more } PUT/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### [Edit a user-defined operation label](https://developers.cloudflare.com/api/typescript/resources/api_gateway/subresources/labels/subresources/user/methods/edit) client.apiGateway.labels.user.edit(stringname, UserEditParams {zone\_id, description, metadata } params, RequestOptionsoptions?): [UserEditResponse]() {created\_at, description, last\_updated, 3 more } PATCH/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### [Delete a user-defined operation label](https://developers.cloudflare.com/api/typescript/resources/api_gateway/subresources/labels/subresources/user/methods/delete) client.apiGateway.labels.user.delete(stringname, UserDeleteParams {zone\_id } params, RequestOptionsoptions?): [UserDeleteResponse]() {created\_at, description, last\_updated, 3 more } DELETE/zones/{zone\_id}/api\_gateway/labels/user/{name} ##### ModelsExpand Collapse

UserBulkCreateResponse {created\_at, description, last\_updated, 3 more }

source: "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)>)

UserBulkDeleteResponse {created\_at, description, last\_updated, 3 more }

source: "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)>)

UserGetResponse {created\_at, description, last\_updated, 4 more }

source: "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?: unknown 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)>)

UserUpdateResponse {created\_at, description, last\_updated, 3 more }

source: "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)>)

UserEditResponse {created\_at, description, last\_updated, 3 more }

source: "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)>)

UserDeleteResponse {created\_at, description, last\_updated, 3 more }

source: "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/typescript/resources/api_gateway/subresources/labels/subresources/user/subresources/resources/subresources/operation/methods/update) client.apiGateway.labels.user.resources.operation.update(stringname, OperationUpdateParams {zone\_id, selector } params, RequestOptionsoptions?): [OperationUpdateResponse]() {created\_at, description, last\_updated, 4 more } PUT/zones/{zone\_id}/api\_gateway/labels/user/{name}/resources/operation ##### ModelsExpand Collapse

OperationUpdateResponse {created\_at, description, last\_updated, 4 more }

source: "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?: unknown 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/typescript/resources/api_gateway/subresources/labels/subresources/managed/methods/get) client.apiGateway.labels.managed.get(stringname, ManagedGetParams {zone\_id, with\_mapped\_resource\_counts } params, RequestOptionsoptions?): [ManagedGetResponse]() {created\_at, description, last\_updated, 4 more } GET/zones/{zone\_id}/api\_gateway/labels/managed/{name} ##### ModelsExpand Collapse

ManagedGetResponse {created\_at, description, last\_updated, 4 more }

source: "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?: unknown 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/typescript/resources/api_gateway/subresources/labels/subresources/managed/subresources/resources/subresources/operation/methods/update) client.apiGateway.labels.managed.resources.operation.update(stringname, OperationUpdateParams {zone\_id, selector } params, RequestOptionsoptions?): [OperationUpdateResponse]() {created\_at, description, last\_updated, 4 more } PUT/zones/{zone\_id}/api\_gateway/labels/managed/{name}/resources/operation ##### ModelsExpand Collapse

OperationUpdateResponse {created\_at, description, last\_updated, 4 more }

source: "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?: unknown 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)>)