---
title: "Rename or recolor an event label"
method: PATCH
path: "/api/event_labels/{id}/"
tags: ["Labels and notes"]
---

# Rename or recolor an event label

`PATCH /api/event_labels/{id}/`

## Request

- Base URL: `https://eyalsec.com`
- URL: `https://eyalsec.com/api/event_labels/{id}/`
- Auth: one of:
  - API key in header `X-API-Key`
  - API key in cookie `__Host-es2session`

Replaces a label's name and color by id (path). Both are written on every call, so leaving color out resets it to amber. name follows the same rules as create, and renaming onto another of your labels' names replies 409. 404 if the label is not owned by the caller. Cookie callers must pass CSRF.

This is a **write**: a read-only API key is refused with 403.

## Path parameters

- `id` integer, required

## Request body

- object
  - `name` string, required: New name, at most 48 characters.
  - `color` string: New color; unknown values default to amber.

## Response `204`

Done. No body.

## Other responses

- `401`: The API key is missing, wrong, revoked or expired.
- `429`: A rate limit was hit, or the account is locked after wrong passwords. Retry-After gives the seconds to wait.
- `default`: An error. Check the status first; the body carries a short message, as JSON ({"error": "..."}) on most endpoints and as plain text on some. 400: malformed JSON, an invalid regex, an unreadable cursor or date, or an unknown value. 401: the API key is missing, wrong, revoked or expired. 403: a failed CSRF check, a read-only key trying to write, a product or feature not enabled on your account, a wrong password, or a write on an account limited to reading. 404: not found, including things that belong to another account. 409: conflict with the current state. 422: a field is missing or invalid. 429: a rate limit was hit, or the account is locked after wrong passwords. 500: something failed on our side.

---

[API](https://skmtc.dev/eyalsec/apis/eyalsec-api.md) · [All operations](https://skmtc.dev/eyalsec/apis/eyalsec-api/llms.txt) · [OpenAPI document](https://skmtc.dev/eyalsec/apis/eyalsec-api/revisions/dc7520689cf1?raw)