Plan · Tareas

Crear una tarea en este tablero (alias de `POST /v1/plan/tasks/`)

La misma semántica de creación que POST /v1/plan/tasks/, con el tablero tomado de la ruta (board en el cuerpo es opcional y se sobrescribe). Idempotency-Key es opcional y recomendado.

curl -sS -X POST "https://api.dailybot.com/v1/plan/boards/00000000-0000-4000-8000-000000000002/tasks/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Ship the delta feed",
    "priority": 2
  }'

dailybot plan task create -t "Ship the delta feed" -b 00000000-0000-4000-8000-000000000002

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Crear una tarea

La clave (ENG-143) se asigna desde el contador del tablero y nunca se reutiliza, ni siquiera después de archivar.

Cuando se define owner, esa persona ya debe poder ver el tablero; de lo contrario, la llamada se rechaza con 400 participant_cannot_access_board y no se escribe nada.

La ubicación es relativa: after o before indica una tarea visible en la columna de destino (como máximo uno de los dos); omite ambos para agregar al final. Nunca se acepta un rank en bruto.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "board": "00000000-0000-4000-8000-000000000002",
    "title": "Ship the delta feed",
    "priority": 2,
    "due_date": "2026-10-15"
  }'

dailybot plan task create -t "Ship the delta feed" -b 00000000-0000-4000-8000-000000000002 --owner me --priority 2

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Crear hasta 100 tareas, o aplicarles una operación

Registrado ANTES de la ruta de detalle {task_id}, o bulk se interpretaría como un identificador. La atomicidad es por elemento, no por lote: la respuesta informa cada elemento por separado y el estado HTTP describe si el lote fue aceptado, no si todos los elementos se aplicaron. Idempotency-Key es obligatorio: un movimiento masivo que se aplica a medias dos veces deja el tablero corrupto. La operación restore es la forma por lotes de POST .../tasks/{task_id}/restore/ y sigue las mismas reglas.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/bulk/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "operation": "create",
    "board": "00000000-0000-4000-8000-000000000002",
    "items": [
      {
        "title": "Write the migration guide",
        "external_id": "row-1"
      },
      {
        "title": "Record the demo",
        "external_id": "row-2"
      }
    ]
  }'

dailybot plan task bulk --operation create --board 00000000-0000-4000-8000-000000000002 -f tasks.json --dry-run
dailybot plan task bulk --operation create --board 00000000-0000-4000-8000-000000000002 -f tasks.json

{
  "succeeded": 1,
  "failed": 1,
  "results": [
    {
      "task": "ENG-142",
      "status": "ok",
      "version": 8
    },
    {
      "task": "ENG-9",
      "status": "error",
      "code": "version_conflict",
      "detail": "This task changed since you loaded it.",
      "extra": {
        "current_version": 4
      }
    }
  ]
}

• Scope: `tasks:write`.
• Límite de solicitudes: 30 llamadas masivas por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Archivar una tarea y sus subtareas

Archivar deja en null el rank de la tarea, así que sale de todo orden del tablero sin salir de la tabla. Las relaciones y los participantes se conservan.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/archive/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task archive ENG-142 --dry-run
dailybot plan task archive ENG-142 --yes

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Duplicar una tarea en el mismo tablero

Crea una tarea nueva en la misma columna. El include predeterminado copia title, description y labels. Emite task.created.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/duplicate/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "include": [
      "title",
      "description",
      "labels"
    ]
  }'

dailybot plan task duplicate ENG-142 --include title --include description

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Mover una tarea a otro tablero

El cuerpo requiere board (uuid del tablero destino). Resolución de la columna destino: state explícito, o state_map de uuid de columna de origen → uuid de columna destino, o la misma category en el tablero destino. Emite task.moved (con from_board_uuid al cambiar de tablero). Las correspondencias inválidas devuelven 400 move_board_state_invalid.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/move-board/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "board": "00000000-0000-4000-8000-000000000012"
  }'

dailybot plan task move ENG-142 --board 00000000-0000-4000-8000-000000000012

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Mover una tarea a un estado y una posición relativa

La única forma de cambiar el estado de una tarea. La posición es un vecino, no un número, así que si dos personas arrastran la misma tarjeta a la vez, ambas producen un orden válido. Como máximo se puede indicar uno de after / before; si ambos son null, se agrega al final de la columna. Una escritura, un evento task.moved. Envía If-Match (o version) para rechazar un movimiento desactualizado.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/move/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "state": "00000000-0000-4000-8000-000000000004",
    "after": null,
    "before": null
  }'

dailybot plan task move ENG-142 --state done

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Vincular dos tareas

Vincula esta tarea con otra. Envía relation_type (blocks, relates_to o duplicates) y target_task, un uuid de tarea o una clave como ENG-142; una tarea que no puedes ver es 404. kind y target son alias obsoletos de esos dos campos: enviar un alias y su campo con valores distintos es 400. Un vínculo que ya existe o que crearía un ciclo es 409.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/relations/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "relation_type": "blocks",
    "target_task": "ENG-150"
  }'

dailybot plan task link ENG-142 ENG-150 --type blocks

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Agregar, quitar o reemplazar las etiquetas de una tarea

Las etiquetas son la taxonomía de toda la organización, compartida con formularios y check-ins; no hay un vocabulario de etiquetas exclusivo de tareas. Como máximo 50 etiquetas por tarea.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/labels/batch/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "mode": "add",
    "label_uuids": [
      "00000000-0000-4000-8000-00000000000b"
    ]
  }'

dailybot plan task labels ENG-142 --mode add --label 00000000-0000-4000-8000-00000000000b

{
  "labels": [
    {
      "uuid": "00000000-0000-4000-8000-00000000000b",
      "name": "backend",
      "color": "#2563eb"
    }
  ]
}

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Suscribirse a las notificaciones de la tarea (rol de observador)

La única forma de definir el campo subscribed de la tarea (enviar subscribed en un PATCH de tarea es 400). Devuelve {"subscribed": true}, así que no hace falta volver a leer.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/subscription/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN"

dailybot plan task watch ENG-142

{
  "subscribed": true
}

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Requiere una persona: llámalo con una sesión iniciada, un token de usuario del CLI o una API key personal. Una key de agente o de la organización recibe `403 insufficient_scope`.

Restaurar una tarea archivada

El reflejo de archivar: mismo scope, mismas credenciales, misma idempotencia. La tarea vuelve al final de su columna, porque sus vecinos anteriores ya no están. Restaurar una tarea activa es un 200 sin efecto.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/restore/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY"

dailybot plan task restore ENG-142

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Funciona con una sesión iniciada, un token de usuario del CLI, una API key personal, o una key de agente o de la organización. Una key personal ve lo que ve su persona; una key de agente o de la organización actúa como actor del sistema y solo ve los tableros visibles para la organización.

Poner a alguien en esta tarjeta

Agrega un participante u observador. Agregar a alguien que ya está en la tarjeta devuelve 200 con la fila existente. Agregar o quitar un participante emite task.participant_added con actor_is_self, para distinguir "alguien me agregó" de "me uní". Un cambio de observador no emite nada: seguir una tarea es una preferencia privada. Silenciar (is_muted) mantiene a la persona en la tarjeta.

curl -sS -X POST "https://api.dailybot.com/v1/plan/tasks/ENG-142/participants/" \
  -H "Authorization: Bearer $DAILYBOT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "user_uuid": "00000000-0000-4000-8000-00000000000c",
    "role": "participant"
  }'

dailybot plan task participants add ENG-142 --user 00000000-0000-4000-8000-00000000000c --role participant
dailybot plan task mute ENG-142
dailybot plan task unmute ENG-142

• Scope: `tasks:write`.
• Límite de solicitudes: 60 escrituras por minuto por actor.
• Requiere una persona: llámalo con una sesión iniciada, un token de usuario del CLI o una API key personal. Una key de agente o de la organización recibe `403 insufficient_scope`.