> 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 a label to multiple scenarios

> Assigns a team label to as many as 10,000 scenario IDs in one request. The caller needs \`scenario edit\` on the label's team (or the equivalent admin permission). Valid same-team assignments are written atomically as one accepted subset; expected per-scenario failures do not prevent other valid assignments and the response remains \`200\`. Missing and cross-team scenario IDs use the same generic \`IM002\` rejection so the endpoint does not reveal whether an unauthorized scenario exists. Repeating an existing assignment is successful.

```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":{"post":{"tags":["Scenario labels"],"summary":"Assign a label to multiple scenarios","description":"Assigns a team label to as many as 10,000 scenario IDs in one request. The caller needs `scenario edit` on the label's team (or the equivalent admin permission). Valid same-team assignments are written atomically as one accepted subset; expected per-scenario failures do not prevent other valid assignments and the response remains `200`. Missing and cross-team scenario IDs use the same generic `IM002` rejection so the endpoint does not reveal whether an unauthorized scenario exists. Repeating an existing assignment is successful.","parameters":[{"name":"labelId","in":"path","required":true,"description":"Team label to assign.","schema":{"type":"integer","format":"int32","minimum":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["scenarioIds"],"properties":{"scenarioIds":{"type":"array","description":"Scenario IDs to process. The raw array is limited before duplicate IDs are removed. Duplicate IDs are processed once and retain the position of their first occurrence.","minItems":1,"maxItems":10000,"items":{"type":"integer","format":"int32","minimum":1}}}}}}},"responses":{"200":{"description":"Batch processed. This status is also returned when every distinct scenario ID is rejected; inspect `results` and `summary` for per-scenario outcomes.","content":{"application/json":{"schema":{"type":"object","required":["results","summary"],"properties":{"results":{"type":"array","description":"One result per distinct scenario ID, ordered by first occurrence in the request.","items":{"oneOf":[{"type":"object","required":["scenarioId","status"],"properties":{"scenarioId":{"type":"integer","format":"int32","minimum":1},"status":{"type":"string","enum":["applied"]}}},{"type":"object","required":["scenarioId","status","code","detail"],"properties":{"scenarioId":{"type":"integer","format":"int32","minimum":1},"status":{"type":"string","enum":["rejected"]},"code":{"type":"string","description":"`IM002` when a scenario is missing or belongs to another team; `IM301` for an authorized but trashed scenario in the label's team.","enum":["IM002","IM301"]},"detail":{"type":"string"}}}]}},"summary":{"type":"object","required":["total","applied","rejected"],"properties":{"total":{"type":"integer","minimum":0},"applied":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}}}}}}},"400":{"description":"Invalid request body, including an empty array, more than 10,000 raw IDs, or a non-positive/non-int32 ID; also returned with `IM903` when scenario labels are disabled.","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, the token lacks `scenarios:write` (`IM001`), or an organization-bound token cannot access the label — a missing label and an inaccessible label are indistinguishable (`SC401`).","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 `/admin` route was used by a caller without admin access.","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"}}}}}}}}},"404":{"description":"The label does not exist or the caller cannot edit its team (`IM013`).","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 a label from multiple scenarios

> Removes a team label from as many as 10,000 scenario IDs in one request. The caller needs \`scenario edit\` on the label's team (or the equivalent admin permission). Valid same-team removals are written atomically as one accepted subset; expected per-scenario failures do not prevent other valid removals and the response remains \`200\`. Missing and cross-team scenario IDs use the same generic \`IM002\` rejection so the endpoint does not reveal whether an unauthorized scenario exists. Removing an assignment that is already absent is successful. An invalid cross-team assignment is rejected and preserved.

```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":{"delete":{"tags":["Scenario labels"],"summary":"Remove a label from multiple scenarios","description":"Removes a team label from as many as 10,000 scenario IDs in one request. The caller needs `scenario edit` on the label's team (or the equivalent admin permission). Valid same-team removals are written atomically as one accepted subset; expected per-scenario failures do not prevent other valid removals and the response remains `200`. Missing and cross-team scenario IDs use the same generic `IM002` rejection so the endpoint does not reveal whether an unauthorized scenario exists. Removing an assignment that is already absent is successful. An invalid cross-team assignment is rejected and preserved.","parameters":[{"name":"labelId","in":"path","required":true,"description":"Team label to remove.","schema":{"type":"integer","format":"int32","minimum":1}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["scenarioIds"],"properties":{"scenarioIds":{"type":"array","description":"Scenario IDs to process. The raw array is limited before duplicate IDs are removed. Duplicate IDs are processed once and retain the position of their first occurrence.","minItems":1,"maxItems":10000,"items":{"type":"integer","format":"int32","minimum":1}}}}}}},"responses":{"200":{"description":"Batch processed. This status is also returned when every distinct scenario ID is rejected; inspect `results` and `summary` for per-scenario outcomes.","content":{"application/json":{"schema":{"type":"object","required":["results","summary"],"properties":{"results":{"type":"array","description":"One result per distinct scenario ID, ordered by first occurrence in the request.","items":{"oneOf":[{"type":"object","required":["scenarioId","status"],"properties":{"scenarioId":{"type":"integer","format":"int32","minimum":1},"status":{"type":"string","enum":["removed"]}}},{"type":"object","required":["scenarioId","status","code","detail"],"properties":{"scenarioId":{"type":"integer","format":"int32","minimum":1},"status":{"type":"string","enum":["rejected"]},"code":{"type":"string","description":"`IM002` when a scenario is missing or belongs to another team; `IM301` for an authorized but trashed scenario in the label's team.","enum":["IM002","IM301"]},"detail":{"type":"string"}}}]}},"summary":{"type":"object","required":["total","removed","rejected"],"properties":{"total":{"type":"integer","minimum":0},"removed":{"type":"integer","minimum":0},"rejected":{"type":"integer","minimum":0}}}}}}}},"400":{"description":"Invalid request body, including an empty array, more than 10,000 raw IDs, or a non-positive/non-int32 ID; also returned with `IM903` when scenario labels are disabled.","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, the token lacks `scenarios:write` (`IM001`), or an organization-bound token cannot access the label — a missing label and an inaccessible label are indistinguishable (`SC401`).","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 `/admin` route was used by a caller without admin access.","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"}}}}}}}}},"404":{"description":"The label does not exist or the caller cannot edit its team (`IM013`).","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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.