GitScrum / Docs

Inicio Rápido

Comienza con la API de GitScrum en 5 minutos. Lista workspaces, obtén proyectos y crea tu primera tarea.

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.

Crea tu primera tarea vía la API en 5 minutos.

Requisitos previos

  • Una cuenta de GitScrum con al menos un workspace y un proyecto
  • Tu token de API (consulta Autenticación)

Paso 1 — Obtén tu token de API

Exporta tu token como variable de entorno:

export GITSCRUM_TOKEN="your-api-token-here"

Paso 2 — Lista tus workspaces

curl -X GET https://services.gitscrum.com/workspaces \
  -H "Authorization: Bearer $GITSCRUM_TOKEN" \
  -H "Content-Type: application/json"

Respuesta

{
  "data": [
    {
      "slug": "acme-corp",
      "name": "Acme Corp",
      "logo": "https://cdn.gitscrum.com/logos/acme.png"
    }
  ]
}

Copia el valor de slug — lo necesitarás en los próximos pasos.

Paso 3 — Lista los proyectos

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

Respuesta

{
  "data": [
    {
      "slug": "web-platform",
      "name": "Web Platform",
      "description": "Main product application",
      "visibility": "public"
    }
  ]
}

Copia el slug del proyecto para el siguiente paso.

Paso 4 — Crea una tarea

curl -X POST https://services.gitscrum.com/tasks \
  -H "Authorization: Bearer $GITSCRUM_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "My first API task",
    "company_slug": "acme-corp",
    "project_slug": "web-platform"
  }'

Respuesta 201 Created

{
  "data": {
    "uuid": "task-uuid-abc123",
    "title": "My first API task",
    "code": "WEB-42",
    "status": "todo",
    "created_at": "2026-02-07T10:30:00Z"
  }
}

Paso 5 — Verifica la tarea

curl -X GET https://services.gitscrum.com/tasks/task-uuid-abc123 \
  -H "Authorization: Bearer $GITSCRUM_TOKEN" \
  -H "Content-Type: application/json"

Respuesta

{
  "data": {
    "uuid": "task-uuid-abc123",
    "title": "My first API task",
    "code": "WEB-42",
    "status": "todo",
    "workflow": {
      "title": "Backlog"
    },
    "project": {
      "slug": "web-platform",
      "name": "Web Platform"
    },
    "created_at": "2026-02-07T10:30:00Z"
  }
}

Tu tarea ahora es visible en el tablero Kanban de GitScrum.

Próximos pasos