Tareas

Las tareas le permiten crear recordatorios de seguimiento y elementos de acción vinculados a contactos.

Listar tareas de un contacto

GET /contacts/{contact_id}/tasks

Devuelve las tareas vinculadas a un contacto específico.

Parámetros de consulta

Parámetro	Tipo	Predeterminado	Descripción
`status`	string	—	Filtrar por estado (`open`, `completed`, `overdue`)

curl "https://be.graph8.com/api/v1/contacts/12345/tasks?status=open" \
  -H "Authorization: Bearer $API_KEY"

response = requests.get(
    f"{BASE_URL}/contacts/12345/tasks",
    headers=HEADERS,
    params={"status": "open"}
)

Respuesta

{
  "data": [
    {
      "id": "task-abc",
      "title": "Send proposal",
      "description": "Draft and send the enterprise proposal.",
      "status": "open",
      "priority": 2,
      "due_date": "2026-03-05T00:00:00Z",
      "assignee_id": "user-123",
      "entity_type": "contact",
      "entity_id": "12345",
      "created_at": "2026-02-25T10:00:00Z",
      "updated_at": "2026-02-25T10:00:00Z"
    }
  ]
}

Listar todas las tareas

GET /tasks

Devuelve todas las tareas de la organización, con filtros opcionales.

Parámetros de consulta

Parámetro	Tipo	Predeterminado	Descripción
`status`	string	—	Filtrar por estado
`priority`	integer	—	Filtrar por prioridad (0=ninguna, 1=urgente, 2=alta, 3=normal, 4=baja)
`assignee_id`	string	—	Filtrar por responsable
`search`	string	—	Buscar en título y descripción

Crear tarea

POST /contacts/{contact_id}/tasks

Cuerpo de la solicitud

Campo	Tipo	Requerido	Descripción
`title`	string	Sí	Título de la tarea
`description`	string	No	Detalles de la tarea
`due_date`	string	No	Fecha de vencimiento en formato ISO 8601
`assignee_id`	string	No	ID del usuario asignado
`priority`	integer	No	0=ninguna, 1=urgente, 2=alta, 3=normal, 4=baja

Ejemplo

cURL

curl -X POST "https://be.graph8.com/api/v1/contacts/12345/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Send proposal", "due_date": "2026-03-05", "priority": 2}'

Actualizar tarea

PATCH /tasks/{task_id}

Admite actualizaciones parciales. Envíe únicamente los campos que desea modificar.

Eliminar tarea

DELETE /tasks/{task_id}

Devuelve 204 No Content cuando la operación se realiza con éxito.