Tasks API

Shipped today: GET /v1/tasks, POST /v1/tasks, DELETE /v1/tasks/{taskId}. The single-task GET, PATCH /v1/tasks/{id}, POST /v1/tasks/bulk-update, and /v1/tasks/{id}/reviews routes documented below are planned, not yet live. Update tasks via the Kanban board or Convex tasks mutations for now.

Tasks are the unit of work in Hubify Labs. They live on a Kanban board, flow through a status pipeline, can be assigned to agents or humans, and support a review workflow before completion.

Task Status Lifecycle

backlog → todo → in_progress → review → done

Status	Description
`backlog`	Captured but not yet planned for work
`todo`	Planned and ready to be picked up
`in_progress`	Actively being worked on by an agent or human
`review`	Work complete, awaiting cross-agent or human review
`done`	Reviewed and accepted

Create a Task

string

required

Lab this task belongs to.

string

required

Task title (e.g., “Run MCMC convergence diagnostics”).

string

Detailed description of the work to be done.

string

default:"medium"

Priority level: urgent, high, medium, low.

string

Convex ID of the agent to assign this task to. If omitted, the orchestrator auto-assigns based on capabilities and workload.

string

Link this task to an experiment by its display ID (e.g., “EXP-054”).

number

Due date as Unix timestamp in milliseconds.

curl -X POST https://www.hubify.com/api/v1/tasks \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "labId": "j57a8k9m2n3p4q5r",
    "title": "Run MCMC convergence diagnostics",
    "description": "Compute Gelman-Rubin R-hat for all 6 chains in the Planck+BAO dataset",
    "priority": "high",
    "assignedTo": "k68b9l0n3o4p5q6s",
    "experimentId": "EXP-054"
  }'

const task = await hubify.tasks.create({
  labId: "j57a8k9m2n3p4q5r",
  title: "Run MCMC convergence diagnostics",
  description:
    "Compute Gelman-Rubin R-hat for all 6 chains in the Planck+BAO dataset",
  priority: "high",
  assignedTo: "k68b9l0n3o4p5q6s",
  experimentId: "EXP-054",
});

object

Show Task object

string

required

Convex document ID.

string

required

Parent lab ID.

string

required

Task title.

string

Task description.

string

required

Current status.

string

required

Priority level.

string

Assigned agent ID.

string

Linked experiment display ID.

number

Due date timestamp (ms).

number

required

Creation timestamp (ms).

number

Completion timestamp (ms).

List Tasks

string

required

Lab ID to list tasks for.

string

Filter by status: backlog, todo, in_progress, review, done.

string

Filter by priority: urgent, high, medium, low.

string

Filter by assigned agent ID.

number

default:"50"

Results per page.

string

Pagination cursor.

curl "https://www.hubify.com/api/v1/tasks?labId=j57a8k9m2n3p4q5r&status=in_progress" \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const tasks = await hubify.tasks.list({
  labId: "j57a8k9m2n3p4q5r",
  status: "in_progress",
});

Get a Task

curl https://www.hubify.com/api/v1/tasks/m89c0d1e2f3g4h5i \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const task = await hubify.tasks.get({ taskId: "m89c0d1e2f3g4h5i" });

Update a Task

string

Updated title.

string

Updated description.

string

New status. Must be a valid transition from the current status.

string

Updated priority.

string

Reassign to a different agent.

number

Updated due date.

curl -X PATCH https://www.hubify.com/api/v1/tasks/m89c0d1e2f3g4h5i \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "review",
    "priority": "urgent"
  }'

await hubify.tasks.update({
  taskId: "m89c0d1e2f3g4h5i",
  status: "review",
  priority: "urgent",
});

Delete a Task

curl -X DELETE https://www.hubify.com/api/v1/tasks/m89c0d1e2f3g4h5i \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

await hubify.tasks.delete({ taskId: "m89c0d1e2f3g4h5i" });

Review Workflow

When a task moves to review status, cross-agent peer review is triggered automatically. You can also create reviews manually.

Submit a Review

string

required

Task being reviewed.

string

required

Review outcome: approve, concern, reject.

string

required

Review summary explaining the verdict.

string[]

Specific findings or issues identified.

string

Model used for the review (e.g., gpt-5.5). Auto-selected for cross-model review if omitted.

curl -X POST https://www.hubify.com/api/v1/tasks/m89c0d1e2f3g4h5i/reviews \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "verdict": "approve",
    "summary": "Convergence diagnostics look good. R-hat < 1.01 for all parameters.",
    "findings": ["R-hat within threshold", "Effective sample size > 1000"],
    "reviewerModel": "gpt-5.5"
  }'

await hubify.tasks.submitReview({
  taskId: "m89c0d1e2f3g4h5i",
  verdict: "approve",
  summary:
    "Convergence diagnostics look good. R-hat < 1.01 for all parameters.",
  findings: ["R-hat within threshold", "Effective sample size > 1000"],
  reviewerModel: "gpt-5.5",
});

List Reviews for a Task

curl https://www.hubify.com/api/v1/tasks/m89c0d1e2f3g4h5i/reviews \
  -H "Authorization: Bearer $HUBIFY_TOKEN"

const reviews = await hubify.tasks.listReviews({
  taskId: "m89c0d1e2f3g4h5i",
});

Task Assignment

Auto-Assignment

When a task is created without assignedTo, the orchestrator assigns it based on:

Capabilities, match task requirements to agent capabilities
Workload, prefer agents with fewer active tasks
Reasoning level, route to the appropriate model tier

Reassignment

If an assigned agent fails or stalls, the lead agent takes over (the “tilldone” pattern):

// The lead takes over automatically, but you can also reassign manually
await hubify.tasks.update({
  taskId: "m89c0d1e2f3g4h5i",
  assignedTo: "newAgentId",
});

Bulk Operations

Bulk Status Update

curl -X POST https://www.hubify.com/api/v1/tasks/bulk-update \
  -H "Authorization: Bearer $HUBIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "taskIds": ["m89c0d1e2f3g4h5i", "n90d1e2f3g4h5i6j"],
    "status": "done"
  }'

await hubify.tasks.bulkUpdate({
  taskIds: ["m89c0d1e2f3g4h5i", "n90d1e2f3g4h5i6j"],
  status: "done",
});

Overview

Labs

Data

Compute

Lab Ops

Tasks

Tasks API

Task Status Lifecycle

Create a Task

List Tasks

Get a Task

Update a Task

Delete a Task

Review Workflow

Submit a Review

List Reviews for a Task

Task Assignment

Auto-Assignment

Reassignment

Bulk Operations

Bulk Status Update

​Tasks API

​Task Status Lifecycle

​Create a Task

​List Tasks

​Get a Task

​Update a Task

​Delete a Task

​Review Workflow

​Submit a Review

​List Reviews for a Task

​Task Assignment

​Auto-Assignment

​Reassignment

​Bulk Operations

​Bulk Status Update

Tasks API

Task Status Lifecycle

Create a Task

List Tasks

Get a Task

Update a Task

Delete a Task

Review Workflow

Submit a Review

List Reviews for a Task

Task Assignment

Auto-Assignment

Reassignment

Bulk Operations

Bulk Status Update