Planely
Iniciar sesiónEmpezar gratis

Etiquetas

Etiquetas de proyecto con color libre. El nombre es único por proyecto y el color acepta cualquier hex, normalizado a #rrggbb.

Listar etiquetas

GET/api/v1/labelsLectura (cualquier key)

Todas las etiquetas del proyecto, por nombre.

Request
curl https://planely.dev/api/v1/labels \
  -H "Authorization: Bearer $PLANELY_API_KEY"
200 OK
{ "labels": [ { "id": "c4d9…", "name": "bug", "color": "#ef4444" } ] }

Crear una etiqueta

POST/api/v1/labelsPermiso: Gestionar etiquetas

El color acepta cualquier hex y se normaliza a #rrggbb.

Cuerpo (JSON)

  • namestringobligatorio

    1–50 caracteres, único en el proyecto

  • colorstring

    Hex ("#rrggbb", "rrggbb", "#rgb"). Por defecto #8b8b8b

  • Un nombre duplicado responde 409 conflict.
Request
curl -X POST https://planely.dev/api/v1/labels \
  -H "Authorization: Bearer $PLANELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "bug", "color": "EF4444" }'
201 Created
{ "label": { "id": "c4d9…", "name": "bug", "color": "#ef4444" } }

Actualizar una etiqueta

PATCH/api/v1/labels/{labelId}Permiso: Gestionar etiquetas

Parcial: envía solo lo que cambia.

Cuerpo (JSON)

  • namestring
  • colorstring
Request
curl -X PATCH https://planely.dev/api/v1/labels/c4d9… \
  -H "Authorization: Bearer $PLANELY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "regresión" }'
200 OK
{ "label": { "id": "c4d9…", "name": "regresión", "color": "#ef4444" } }

Eliminar una etiqueta

DELETE/api/v1/labels/{labelId}Permiso: Gestionar etiquetas

Se desprende de todas sus tareas; las tareas no se tocan.

Request
curl -X DELETE https://planely.dev/api/v1/labels/c4d9… \
  -H "Authorization: Bearer $PLANELY_API_KEY"
204 No Content
(sin cuerpo)
Anterior← ComentariosSiguienteSprints →