Etiquetas

REST API — Todos los endpoints requieren autenticación mediante Bearer token. Incluye Authorization: Bearer {token} en cada solicitud. Los tokens se gestionan en Configuración de GitScrum → API. Base URL: https://services.gitscrum.com — Todas las rutas de solicitud en esta documentación son relativas a esta URL base.

Las etiquetas ayudan a categorizar y filtrar tareas en los proyectos. Gestiona etiquetas a nivel de workspace y adjúntalas a tareas individuales.

Listar etiquetas

GET /projects-labels?company_slug={slug}

Devuelve todas las etiquetas del workspace.

Parámetros de query

curl -X GET "https://services.gitscrum.com/projects-labels?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json"

Respuesta 200 OK

{
  "data": [
    {
      "id": 1,
      "slug": "bug",
      "title": "Bug",
      "color": "EF4444"
    },
    {
      "id": 2,
      "slug": "feature",
      "title": "Feature",
      "color": "3B82F6"
    },
    {
      "id": 3,
      "slug": "urgent",
      "title": "Urgent",
      "color": "F59E0B"
    }
  ]
}

Crear etiqueta

POST /projects-labels?company_slug={slug}

Crea una nueva etiqueta en el workspace.

Parámetros de query

Cuerpo de la solicitud

curl -X POST "https://services.gitscrum.com/projects-labels?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Design",
    "color": "8B5CF6"
  }'

Respuesta 201 Created

{
  "data": {
    "id": 4,
    "slug": "design",
    "title": "Design",
    "color": "8B5CF6"
  }
}

Actualizar etiqueta

PUT /projects-labels/{slug}?company_slug={slug}

Actualiza una etiqueta existente.

Parámetros de ruta

Parámetros de query

Cuerpo de la solicitud

curl -X PUT "https://services.gitscrum.com/projects-labels/design?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "UI Design",
    "color": "7C3AED"
  }'

Respuesta 200 OK

{
  "data": {
    "id": 4,
    "slug": "design",
    "title": "UI Design",
    "color": "7C3AED"
  }
}

Eliminar etiqueta

DELETE /projects-labels/{slug}?company_slug={slug}

Elimina permanentemente una etiqueta y la remueve de todas las tareas.

Parámetros de ruta

Parámetros de query

curl -X DELETE "https://services.gitscrum.com/projects-labels/design?company_slug=acme-corp" \
  -H "Authorization: Bearer {token}"

Adjuntar etiqueta

POST /projects-labels/{labelslug}/attach?companyslug={slug}&project_slug={slug}

Adjunta una etiqueta a una tarea. Sin efecto si ya está adjunta.

Parámetros de ruta

Parámetros de query

Cuerpo de la solicitud

curl -X POST "https://services.gitscrum.com/projects-labels/feature/attach?company_slug=acme-corp&project_slug=web-platform" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_uuid": "task-uuid-abc123"
  }'

Separar etiqueta

DELETE /projects-labels/{labelslug}/detach?companyslug={slug}&project_slug={slug}

Remueve una etiqueta de una tarea. Sin efecto si no está adjunta.

Parámetros de ruta

Parámetros de query

Cuerpo de la solicitud

curl -X DELETE "https://services.gitscrum.com/projects-labels/feature/detach?company_slug=acme-corp&project_slug=web-platform" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "task_uuid": "task-uuid-abc123"
  }'

Referencia de campos