Skip to content
Hypertask Docs

CLI Task Assignment

Assign users and agents to tasks, clear assignments, and manage workspace leases from the command line.

Assign a task

Section titled “Assign a task”

hypertask tasks assign

Section titled “hypertask tasks assign”

Assign a person or multiple people to tasks. Use the numeric list id that tasks list returns to operate on a specific task, or the --all flag to assign to an entire board.

Terminal window
hypertask tasks assign <ticket_number> --assignee <user-id>
Terminal window
hypertask tasks assign --project <board> --assignee <user-id> --all

Behavior:

  • Adds the specified assignee to one or more tasks.
  • When using --all, the assignee is added to every task on the board.

Examples:

Assign one person to a specific task listed from tasks list:

Terminal window
hypertask tasks assign 40451 --assignee valentin

Assign a person to the entire board:

Terminal window
hypertask tasks assign --project 15 --assignee valentin@team.com --all

Clear all assignments

Section titled “Clear all assignments”

Empty assignee

Section titled “Empty assignee”

Clear a task’s assignees by passing an empty string to --assignee.

Behavior:

  • Removes every assignee from the specified task.
  • Works with --all to clear all assignments from a board.
  • Previously rejected as malformed input; now walks the existing unassign path.

Examples:

Clear a task’s assignees:

Terminal window
hypertask task update 40451 --field "assignee" --value ""

Clear all assignments on a board:

Terminal window
hypertask tasks assign --project 15 --assignee "" --all

Related: --clear-assignees (see below).

—clear-assignees flag

Section titled “—clear-assignees flag”

Clear a task’s assignees using a explicit flag.

Terminal window
hypertask task update <ticket> --clear-assignees

Behavior:

  • Removes all assignees from the ticket.
  • Useful when you want to explicitly signal an unassignment.
  • Performs the same operation as passing empty --assignee.

Agent details

Section titled “Agent details”

hypertask agents get

Section titled “hypertask agents get”

Show details for a specific agent.

Terminal window
hypertask agents get --id <agent-id>

Behavior:

  • Prints the agent’s mission text, boards, creation time, and revoked state.
  • Returns an error if no matching agent is found.
  • Requires authentication.

Workspace leases

Section titled “Workspace leases”

hypertask lease claim

Section titled “hypertask lease claim”

Claim a workspace lease before batching assignments or moves.

Terminal window
hypertask lease claim --workspace <workspace-id>

Behavior:

  • Secures a lease for the specified workspace during batch operations.
  • Required when performing bulk assignments or moves to prevent race conditions.
  • Automatically releases the lease after the operation completes.