> For the complete documentation index, see [llms.txt](https://developers.make.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.make.com/api-documentation/api-reference/scenario-labels.md).

# Scenario Labels

Colour-coded team labels can be assigned to scenarios for organization and filtering.

## List team labels

> Retrieves the colour-coded labels owned by a team, sorted by name (case-insensitive) ascending. Each label carries a \`scenariosCount\` — the number of non-trashed scenarios in the team that currently carry it.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:read"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels":{"get":{"tags":["Scenario labels"],"summary":"List team labels","description":"Retrieves the colour-coded labels owned by a team, sorted by name (case-insensitive) ascending. Each label carries a `scenariosCount` — the number of non-trashed scenarios in the team that currently carry it.","parameters":[{"name":"teamId","in":"query","required":true,"schema":{"type":"integer","minimum":1},"description":"The team (company) whose labels are listed."}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"labels":{"type":"array","items":{"allOf":[{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"colour":{"type":"string","description":"Fixed palette semantic token name; the UI maps each token to its hex value.","enum":["white","neutral","brand","info","success","warning","danger","pink"]},"scope":{"type":"string","description":"Label visibility tier exposed by the web API. Only team labels are supported in this version.","enum":["team"]},"teamId":{"type":"integer","description":"The team (company) that owns the label."},"description":{"type":"string","nullable":true},"createdBy":{"type":"integer","nullable":true},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time","nullable":true}}},{"type":"object","properties":{"scenariosCount":{"type":"integer","minimum":0,"description":"Number of non-trashed scenarios in the team carrying this label."}}}]}}}}}}}}}}}}
```

## Create team label

> Creates a new team label. Requires \`scenario edit\` on the team. Label names are unique (case-insensitive) within a team.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels":{"post":{"tags":["Scenario labels"],"summary":"Create team label","description":"Creates a new team label. Requires `scenario edit` on the team. Label names are unique (case-insensitive) within a team.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["teamId","name","colour"],"properties":{"teamId":{"type":"integer","minimum":1},"name":{"type":"string","minLength":1,"maxLength":30},"colour":{"type":"string","description":"Fixed palette semantic token name; the UI maps each token to its hex value.","enum":["white","neutral","brand","info","success","warning","danger","pink"]},"description":{"type":"string","maxLength":500}}}}}},"responses":{"200":{"description":"Label created","content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"colour":{"type":"string","description":"Fixed palette semantic token name; the UI maps each token to its hex value.","enum":["white","neutral","brand","info","success","warning","danger","pink"]},"scope":{"type":"string","description":"Label visibility tier exposed by the web API. Only team labels are supported in this version.","enum":["team"]},"teamId":{"type":"integer","description":"The team (company) that owns the label."},"description":{"type":"string","nullable":true},"createdBy":{"type":"integer","nullable":true},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time","nullable":true}}}}}}}},"409":{"description":"A team label with the same name already exists."}}}}}}
```

## Delete team label

> Deletes a team label. Requires \`scenario edit\` on the label's team. Removes the label from every scenario it was assigned to.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels/{labelId}":{"delete":{"tags":["Scenario labels"],"summary":"Delete team label","description":"Deletes a team label. Requires `scenario edit` on the label's team. Removes the label from every scenario it was assigned to.","parameters":[{"name":"labelId","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Label deleted","content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"object","properties":{"id":{"type":"integer"}}}}}}}},"401":{"description":"Authentication failed, the token lacks `scenarios:write`, or an organization-bound token cannot access the label."},"404":{"description":"For an unbound caller, the label does not exist or the caller cannot edit its team."}}}}}}
```

## Update team label

> Renames, re-colours, or re-describes a team label. Requires \`scenario edit\` on the label's team. Every chip using the label updates at once.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels/{labelId}":{"patch":{"tags":["Scenario labels"],"summary":"Update team label","description":"Renames, re-colours, or re-describes a team label. Requires `scenario edit` on the label's team. Every chip using the label updates at once.","parameters":[{"name":"labelId","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","minProperties":1,"properties":{"name":{"type":"string","minLength":1,"maxLength":30},"colour":{"type":"string","description":"Fixed palette semantic token name; the UI maps each token to its hex value.","enum":["white","neutral","brand","info","success","warning","danger","pink"]},"description":{"type":"string","maxLength":500,"nullable":true}}}}}},"responses":{"200":{"description":"Label updated","content":{"application/json":{"schema":{"type":"object","properties":{"label":{"type":"object","properties":{"id":{"type":"integer"},"name":{"type":"string"},"colour":{"type":"string","description":"Fixed palette semantic token name; the UI maps each token to its hex value.","enum":["white","neutral","brand","info","success","warning","danger","pink"]},"scope":{"type":"string","description":"Label visibility tier exposed by the web API. Only team labels are supported in this version.","enum":["team"]},"teamId":{"type":"integer","description":"The team (company) that owns the label."},"description":{"type":"string","nullable":true},"createdBy":{"type":"integer","nullable":true},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time","nullable":true}}}}}}}},"401":{"description":"Authentication failed, the token lacks `scenarios:write`, or an organization-bound token cannot access the label."},"404":{"description":"For an unbound caller, the label does not exist or the caller cannot edit its team."},"409":{"description":"A team label with the same name already exists."}}}}}}
```

## Assign labels to scenarios

> Assigns every accepted team label to every accepted scenario in one transaction. The raw request accepts up to 100 label IDs and 1,000 scenario IDs before duplicate IDs are removed. Missing, non-team, and different-team labels are rejected with the same \`IM013\` response. Missing and different-team scenarios are rejected with \`IM002\`; trashed scenarios in the requested team are rejected with \`IM301\`. Existing assignments are accepted no-ops. A processed request returns \`200\` even when every resource is rejected.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels/assign-scenarios":{"post":{"tags":["Scenario labels"],"summary":"Assign labels to scenarios","description":"Assigns every accepted team label to every accepted scenario in one transaction. The raw request accepts up to 100 label IDs and 1,000 scenario IDs before duplicate IDs are removed. Missing, non-team, and different-team labels are rejected with the same `IM013` response. Missing and different-team scenarios are rejected with `IM002`; trashed scenarios in the requested team are rejected with `IM301`. Existing assignments are accepted no-ops. A processed request returns `200` even when every resource is rejected.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["teamId","labelIds","scenarioIds"],"properties":{"teamId":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647,"description":"Team whose labels and scenarios are being mutated."},"labelIds":{"type":"array","minItems":1,"maxItems":100,"description":"Label IDs to process. The raw limit is enforced before duplicate IDs are removed. Each distinct ID is processed once.","items":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647}},"scenarioIds":{"type":"array","minItems":1,"maxItems":1000,"description":"Scenario IDs to process. The raw limit is enforced before duplicate IDs are removed. Each distinct ID is processed once. Together with the 100-label limit, this bounds one request to 100,000 label-scenario pairs.","items":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647}}}}}}},"responses":{"200":{"description":"The valid Cartesian subset was processed atomically; inspect the rejection arrays and summary.","content":{"application/json":{"schema":{"type":"object","required":["rejectedLabels","rejectedScenarios","summary"],"properties":{"rejectedLabels":{"type":"array","description":"Rejected distinct label IDs in first-occurrence request order.","items":{"type":"object","required":["labelId","code","detail"],"properties":{"labelId":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647},"code":{"type":"string","description":"Always `IM013`; missing, non-team, and different-team labels are indistinguishable.","enum":["IM013"]},"detail":{"type":"string"}}}},"rejectedScenarios":{"type":"array","description":"Rejected distinct scenario IDs in first-occurrence request order.","items":{"type":"object","required":["scenarioId","code","detail"],"properties":{"scenarioId":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647},"code":{"type":"string","description":"`IM002` when a scenario is missing or belongs to another team; `IM301` for a trashed scenario in the requested team.","enum":["IM002","IM301"]},"detail":{"type":"string"}}}},"summary":{"type":"object","required":["labels","scenarios","changed"],"properties":{"labels":{"type":"object","required":["total","accepted","rejected"],"properties":{"total":{"type":"integer","minimum":0,"description":"Number of distinct requested IDs after duplicate IDs are removed."},"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}},"scenarios":{"type":"object","required":["total","accepted","rejected"],"properties":{"total":{"type":"integer","minimum":0,"description":"Number of distinct requested IDs after duplicate IDs are removed."},"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}},"changed":{"type":"integer","minimum":0,"description":"Number of label-scenario relationships actually inserted or deleted."}}}}}}}},"400":{"description":"The body is invalid, or scenario labels are disabled (`IM903`).","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Localized summary for the error code."},"code":{"type":"string","description":"Stable Make API error code."},"detail":{"type":"string","description":"Request-specific detail when the error safely exposes one."},"suberrors":{"type":"array","description":"Individual validation failures, when request validation reports them.","items":{"type":"object","required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"}}}}}}}}},"401":{"description":"Authentication failed or the token lacks `scenarios:write` (`IM001`).","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Localized summary for the error code."},"code":{"type":"string","description":"Stable Make API error code."},"detail":{"type":"string","description":"Request-specific detail when the error safely exposes one."},"suberrors":{"type":"array","description":"Individual validation failures, when request validation reports them.","items":{"type":"object","required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"}}}}}}}}},"403":{"description":"The caller cannot edit scenarios in the requested team, or cannot access the `/admin` route.","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Localized summary for the error code."},"code":{"type":"string","description":"Stable Make API error code."},"detail":{"type":"string","description":"Request-specific detail when the error safely exposes one."},"suberrors":{"type":"array","description":"Individual validation failures, when request validation reports them.","items":{"type":"object","required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"}}}}}}}}}}}}}}
```

## Remove labels from scenarios

> Removes every accepted team label from every accepted scenario in one transaction. The raw request accepts up to 100 label IDs and 1,000 scenario IDs before duplicate IDs are removed. Missing, non-team, and different-team labels are rejected with the same \`IM013\` response. Missing and different-team scenarios are rejected with \`IM002\`; trashed scenarios in the requested team are rejected with \`IM301\`. Absent assignments are accepted no-ops. A processed request returns \`200\` even when every resource is rejected.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels/unassign-scenarios":{"post":{"tags":["Scenario labels"],"summary":"Remove labels from scenarios","description":"Removes every accepted team label from every accepted scenario in one transaction. The raw request accepts up to 100 label IDs and 1,000 scenario IDs before duplicate IDs are removed. Missing, non-team, and different-team labels are rejected with the same `IM013` response. Missing and different-team scenarios are rejected with `IM002`; trashed scenarios in the requested team are rejected with `IM301`. Absent assignments are accepted no-ops. A processed request returns `200` even when every resource is rejected.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["teamId","labelIds","scenarioIds"],"properties":{"teamId":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647,"description":"Team whose labels and scenarios are being mutated."},"labelIds":{"type":"array","minItems":1,"maxItems":100,"description":"Label IDs to process. The raw limit is enforced before duplicate IDs are removed. Each distinct ID is processed once.","items":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647}},"scenarioIds":{"type":"array","minItems":1,"maxItems":1000,"description":"Scenario IDs to process. The raw limit is enforced before duplicate IDs are removed. Each distinct ID is processed once. Together with the 100-label limit, this bounds one request to 100,000 label-scenario pairs.","items":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647}}}}}}},"responses":{"200":{"description":"The valid Cartesian subset was processed atomically; inspect the rejection arrays and summary.","content":{"application/json":{"schema":{"type":"object","required":["rejectedLabels","rejectedScenarios","summary"],"properties":{"rejectedLabels":{"type":"array","description":"Rejected distinct label IDs in first-occurrence request order.","items":{"type":"object","required":["labelId","code","detail"],"properties":{"labelId":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647},"code":{"type":"string","description":"Always `IM013`; missing, non-team, and different-team labels are indistinguishable.","enum":["IM013"]},"detail":{"type":"string"}}}},"rejectedScenarios":{"type":"array","description":"Rejected distinct scenario IDs in first-occurrence request order.","items":{"type":"object","required":["scenarioId","code","detail"],"properties":{"scenarioId":{"type":"integer","format":"int32","minimum":1,"maximum":2147483647},"code":{"type":"string","description":"`IM002` when a scenario is missing or belongs to another team; `IM301` for a trashed scenario in the requested team.","enum":["IM002","IM301"]},"detail":{"type":"string"}}}},"summary":{"type":"object","required":["labels","scenarios","changed"],"properties":{"labels":{"type":"object","required":["total","accepted","rejected"],"properties":{"total":{"type":"integer","minimum":0,"description":"Number of distinct requested IDs after duplicate IDs are removed."},"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}},"scenarios":{"type":"object","required":["total","accepted","rejected"],"properties":{"total":{"type":"integer","minimum":0,"description":"Number of distinct requested IDs after duplicate IDs are removed."},"accepted":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}},"changed":{"type":"integer","minimum":0,"description":"Number of label-scenario relationships actually inserted or deleted."}}}}}}}},"400":{"description":"The body is invalid, or scenario labels are disabled (`IM903`).","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Localized summary for the error code."},"code":{"type":"string","description":"Stable Make API error code."},"detail":{"type":"string","description":"Request-specific detail when the error safely exposes one."},"suberrors":{"type":"array","description":"Individual validation failures, when request validation reports them.","items":{"type":"object","required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"}}}}}}}}},"401":{"description":"Authentication failed or the token lacks `scenarios:write` (`IM001`).","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Localized summary for the error code."},"code":{"type":"string","description":"Stable Make API error code."},"detail":{"type":"string","description":"Request-specific detail when the error safely exposes one."},"suberrors":{"type":"array","description":"Individual validation failures, when request validation reports them.","items":{"type":"object","required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"}}}}}}}}},"403":{"description":"The caller cannot edit scenarios in the requested team, or cannot access the `/admin` route.","content":{"application/json":{"schema":{"type":"object","required":["message","code"],"properties":{"message":{"type":"string","description":"Localized summary for the error code."},"code":{"type":"string","description":"Stable Make API error code."},"detail":{"type":"string","description":"Request-specific detail when the error safely exposes one."},"suberrors":{"type":"array","description":"Individual validation failures, when request validation reports them.","items":{"type":"object","required":["message","name"],"properties":{"message":{"type":"string"},"name":{"type":"string"}}}}}}}}}}}}}}
```

## Assign label to scenario

> Assigns a team label to a single scenario. A team label may only be applied to scenarios in that same team. Idempotent.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels/{labelId}/scenarios/{scenarioId}":{"post":{"tags":["Scenario labels"],"summary":"Assign label to scenario","description":"Assigns a team label to a single scenario. A team label may only be applied to scenarios in that same team. Idempotent.","parameters":[{"name":"labelId","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"scenarioId","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Label assigned","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioLabel":{"type":"object","properties":{"labelId":{"type":"integer"},"scenarioId":{"type":"integer"}}}}}}}},"401":{"description":"Authentication failed, the token lacks `scenarios:write`, or an organization-bound token cannot access the label."},"403":{"description":"Insufficient rights — the user lacks scenario-edit permission, the scenario does not exist or is not accessible, or a label visible to the caller belongs to a different team than the scenario."},"404":{"description":"For an unbound caller, the label does not exist or the caller cannot edit its team."}}}}}}
```

## Remove label from scenario

> Removes a team label from a single scenario. Idempotent.

```json
{"openapi":"3.0.0","info":{"title":"Web API v2 - Public ","version":"1.0.0"},"tags":[{"name":"Scenario labels","description":"Colour-coded team labels can be assigned to scenarios for organization and filtering."}],"servers":[{"url":"https://eu1.make.com/api/v2","description":"EU1 production zone"},{"url":"https://eu2.make.com/api/v2","description":"EU2 production zone"},{"url":"https://us1.make.com/api/v2","description":"US1 production zone"},{"url":"https://us2.make.com/api/v2","description":"US2 production zone"},{"url":"https://eu1.make.celonis.com/api/v2","description":"Celonis EU1 production zone"},{"url":"https://us1.make.celonis.com/api/v2","description":"Celonis US1 production zone"}],"security":[{"token":["scenarios:write"]}],"components":{"securitySchemes":{"token":{"type":"apiKey","name":"Authorization","in":"header","description":"Authorize the API call with your API token in the `Authorization` header with the value: `Token your-api-token`.\n\nIf you don't have an API token yet, please refer to the [\"Authentication\" section](/api-documentation/authentication) to learn how to create one.\n"}}},"paths":{"/scenario-labels/{labelId}/scenarios/{scenarioId}":{"delete":{"tags":["Scenario labels"],"summary":"Remove label from scenario","description":"Removes a team label from a single scenario. Idempotent.","parameters":[{"name":"labelId","in":"path","required":true,"schema":{"type":"integer","minimum":1}},{"name":"scenarioId","in":"path","required":true,"schema":{"type":"integer","minimum":1}}],"responses":{"200":{"description":"Label removed","content":{"application/json":{"schema":{"type":"object","properties":{"scenarioLabel":{"type":"object","properties":{"labelId":{"type":"integer"},"scenarioId":{"type":"integer"}}}}}}}},"401":{"description":"Authentication failed, the token lacks `scenarios:write`, or an organization-bound token cannot access the label."},"403":{"description":"Insufficient rights — the user lacks scenario-edit permission, the scenario does not exist or is not accessible, or a label visible to the caller belongs to a different team than the scenario."},"404":{"description":"For an unbound caller, the label does not exist or the caller cannot edit its team."}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.make.com/api-documentation/api-reference/scenario-labels.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.