MCP Tools Reference

Every tool the Hypertask MCP server exposes at https://mcp.hypertask.ai/mcp, with its parameters. Requests need a Bearer token in the Authorization header.

Tip

This page is generated from the server's own tools/list response, so it cannot drift from what an agent actually gets. Start with hypertask_user_context and action: "hello" for the welcome map.

Note

Each resource tool selects an operation with action; put its fields in input. See MCP Integration for connection instructions.

Source: Live MCP tools/list. Schema version 561d0acdec59.

20 tools.

---

Context and projects

hypertask_projects

Does: List accessible boards, read their column manifests and playbooks, create or rename boards, and manage board settings and members. Use when: Use to discover project_id or section_id before ticket changes, or to build a board from a brief using the create action. Do not use when: Do not use to move individual tickets or change a column; use hypertask_tasks or hypertask_sections instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. A project is a board and a section is a column; manifest returns ordered columns and their semantic roles. Creating a board accepts nested tasks and section names, and archive changes visibility without deleting it.

Parameter	Type	Required	Description
action	list | manifest | playbook | create | rename | members | archive | invite_member | get_playbook | set_playbook | get_instructions | set_instructions	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object | object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
offset	integer	No	Number of matching rows to skip; prefer cursor continuation when supported.
query	string	No	Free-text search over the list. Same name on every list tool.
search	string	No	Text filter for the existing task or project list.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
sort_by	createdAt | updatedAt | dueDate | priority | title | lastUsedAt	No	Field to sort the result list by.
sort_order	asc | desc	No	Ascending or descending sort direction.
status	Normal | Archive | Deleted	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.

Input for manifest

Parameter	Type	Required	Description
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.

Input for playbook

Parameter	Type	Required	Description
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.

Input for create

Parameter	Type	Required	Description
description	string	No	Optional board description (HTML if product requires)
labels	object[]	No	Optional. Use for area/track/component/risk (e.g. Frontend, Security). Do not encode workflow state in labels;that belongs in sections.
sections	object[]	Yes	Delivery workflow columns left-to-right (array order): intake → committed → building → verify → done. Use domain-specific titles (Linear/Jira-style), not phase buckets like Discovery/Foundation unless the user asked for a phased roadmap. Avoid bland generic names as the default choice.
source_summary	string	No	Optional audit trail; not used for inference
tasks	object[]	No	Starter tasks for a realistic delivery board. Large/multi-doc sources may produce many tasks (often 100–250+);see create_board tool description. Each task: exactly one of section_index or section_title; for new work, bias placement to Triage/Scheduled; avoid parking most cards in In development/In review on a greenfield board. Shipped usually empty unless user said work is done. Each task SHOULD include priority and estimate unless user opted out. tasks[] is flat; use create_task + parent_task_id after board creation for explicit parent/child.
team_id	string | integer	Yes	Team/workspace id (numeric or UUID string from get_user_context.teams)
title	string	Yes	New board title

Input for rename

Parameter	Type	Required	Description
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
title	string	Yes	Human-readable title of the ticket, board, column, page or view.

Input for members

Parameter	Type	Required	Description
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.

Input for archive

Parameter	Type	Required	Description
member_identifier	integer | string	No	Required when action is invite_member.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
status	Archive | Normal	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.

Input for invite_member

Parameter	Type	Required	Description
member_identifier	integer | string	No	Required when action is invite_member.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
status	Archive | Normal	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.

Input for get_playbook

Parameter	Type	Required	Description
custom_instruction	string	No	Required when action is set_instructions.
definition_of_done	string[]	No	Board completion criteria to store in its playbook.
model_selected	string	No	AI model preference to store in board instructions.
notes	string	No	Additional board playbook notes.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
working_rules	string	No	Board-specific workflow instructions to store in the playbook.

Input for set_playbook

Parameter	Type	Required	Description
custom_instruction	string	No	Required when action is set_instructions.
definition_of_done	string[]	No	Board completion criteria to store in its playbook.
model_selected	string	No	AI model preference to store in board instructions.
notes	string	No	Additional board playbook notes.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
working_rules	string	No	Board-specific workflow instructions to store in the playbook.

Input for get_instructions

Parameter	Type	Required	Description
custom_instruction	string	No	Required when action is set_instructions.
definition_of_done	string[]	No	Board completion criteria to store in its playbook.
model_selected	string	No	AI model preference to store in board instructions.
notes	string	No	Additional board playbook notes.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
working_rules	string	No	Board-specific workflow instructions to store in the playbook.

Input for set_instructions

Parameter	Type	Required	Description
custom_instruction	string	No	Required when action is set_instructions.
definition_of_done	string[]	No	Board completion criteria to store in its playbook.
model_selected	string	No	AI model preference to store in board instructions.
notes	string	No	Additional board playbook notes.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
working_rules	string	No	Board-specific workflow instructions to store in the playbook.

hypertask_user_context

Does: Orient to the authenticated user, their accessible boards and account connections, or update their own profile. Use when: Use at the start of a session to discover accessible projects and permissions, or when the user requests a profile change. Do not use when: Do not use for filtered board lists or task searches; use hypertask_projects or hypertask_search instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	hello | get	Yes	Operation to perform on this resource.
input	object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for hello

Takes no parameters.

Input for get

Takes no parameters.

---

Comments

hypertask_comments

Does: List ticket comments and activity, add replies, and edit or delete comments allowed by the current credential. Use when: Use to discuss a ticket or inspect its conversation; list with include_activity also retrieves work history. Do not use when: Do not use for ticket descriptions or unpublished drafts; use hypertask_tasks or hypertask_drafts instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. text is HTML unless content_type=markdown; comment_id is required to edit or delete, and ticket identifiers locate list/add targets. Ownership and board membership still apply.

Parameter	Type	Required	Description
action	list | add | update | delete	Yes	Operation to perform on this resource.
input	object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
include_activity	boolean	No	Include task activity history such as label, move, assignment, and priority changes. Defaults to false. Defaults to false.
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
offset	integer	No	Number of matching rows to skip; prefer cursor continuation when supported.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
query	string	No	Free-text search over the list. Same name on every list tool.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
sort_order	asc | desc	No	Ascending or descending sort direction.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for add

Parameter	Type	Required	Description
attachments	object[]	No	Files to attach after the operation succeeds. Each file needs filename, content_type, and exactly one of data (base64 bytes; 3145728 decoded bytes total) or url (HTTP(S), for files up to 15 MB).
comment_id	integer	No	Comment ID. Required for update and delete. Obtain from get_comments_for_task.
content_type	html | markdown	No	Input format for text. Defaults to HTML.
mentions	object[]	No	Required when text contains @mentions. Resolve via list_project_members, then include { user_id, display_name } for each.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
reply_to_comment_id	integer	No	For agent replies, the comment ID that invoked the agent. This routes the answer to the requester's Important inbox.
reply_to_invocation_id	integer	No	For agent replies, the agent Mentioned notification ID that invoked the agent. Use this when the mention was in the task description, which has no comment ID. Routes the answer to the requester's Important inbox.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Comment text for add/update. HTML or structural markdown; content_type can explicitly select either format.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for update

Parameter	Type	Required	Description
comment_id	integer	Yes	Numeric id of an existing comment to edit, delete or attach files to.
content_type	html | markdown	No	Input format for text. Defaults to HTML.
mentions	object[]	No	Objects containing user_id and display_name to resolve and notify comment mentions.
text	string	Yes	Comment, draft or related-search text; comment formatting uses content_type.

Input for delete

Parameter	Type	Required	Description
comment_id	integer	Yes	Numeric id of an existing comment to edit, delete or attach files to.

---

Tasks

hypertask_tasks

Does: Read, create, update, move, assign and relate tickets, including context, trees and description versions. Use when: Use when working with a known ticket or a filtered board queue; list finds overdue work and context includes comments and recent activity. Do not use when: Do not use for fuzzy text discovery or editing comments; use hypertask_search or hypertask_comments instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Prefer ticket_number (for example HTPR-1234); get accepts one identifier or a list, while context requires task_id and project_id. Normal, Archive and Deleted describe storage state, not workflow columns; section names describe workflow.

Parameter	Type	Required	Description
action	list | get | context | tree | next | versions | restore | link | links | unlink | create | update | move | assign	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object | object | object | object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
assigned_to	string | string | integer | integer[]	No	Assignee filter using the identifiers or special values accepted by this action.
created_by	integer	No	Numeric user id that created the tickets.
created_since	string	No	ISO 8601 lower bound on ticket creation time.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
due_date_after	string	No	ISO 8601 lower bound on ticket due dates.
due_date_before	string	No	ISO 8601 upper bound on ticket due dates, useful for overdue work.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
has_attachments	boolean	No	Require tickets with attachments when true, or without attachments when false.
has_comments	boolean	No	Require tickets with comments when true, or without comments when false.
has_due_date	boolean	No	Require tickets with a due date when true, or without a due date when false.
labels	string | integer | string | integer[]	No	Label filter or assignment values in the shape accepted by this action.
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
offset	integer	No	Number of matching rows to skip; prefer cursor continuation when supported.
priority	Urgent | High | Medium | Low | Urgent | High | Medium | Low[]	No	Ticket priority index or supported priority name; 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
query	string	No	Free-text search over the list. Same name on every list tool.
search	string	No	Text filter for the existing task or project list.
section	string	No	Workflow column title to match, not the ticket storage status.
section_id	integer	No	Numeric workflow column id; discover it with projects manifest.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
sort_by	createdAt | updatedAt | dueDate | priority | title | lastUsedAt	No	Field to sort the result list by.
sort_order	asc | desc	No	Ascending or descending sort direction.
status	Normal | Archive | Deleted	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.
updated_since	string	No	ISO 8601 lower bound on ticket update time.

Input for get

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer | integer[]	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string | string[]	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for context

Parameter	Type	Required	Description
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
summary	boolean	No	Request the shorter ticket-context representation when true.
task_id	integer	Yes	Numeric ticket id; get accepts an array, while other actions usually accept a single id.

Input for tree

Parameter	Type	Required	Description
depth	integer	No	How many levels deep to show. Use 0 for the root only; omit for the full tree.
task_id	integer	No	Numeric task ID
ticket_number	string	No	Ticket number of the task (e.g. HTPR-15)

Input for next

Parameter	Type	Required	Description
cursor	string	No	Opaque continuation cursor from the previous filtered list response; keep the same filters.
exclude_blocked	boolean	No	Exclude tickets with unresolved blocking relations from next-work selection.
labels	string	No	Label filter or assignment values in the shape accepted by this action.
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
section	string	No	Workflow column title to match, not the ticket storage status.

Input for versions

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.
version_id	integer	No	Required when action is restore.

Input for restore

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.
version_id	integer	No	Required when action is restore.

Input for link

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
relation_type	RelatedTo | BlockedBy | BlockedTo	No	Required when action is link.
source_project_id	integer	No	Numeric board id for a source ticket identified by source_unique_index.
source_task_id	integer	No	Numeric source ticket id for a link or unlink action.
source_ticket_number	string	No	Stable source ticket key, for example HTPR-1234.
source_unique_index	integer	No	Source ticket number within source_project_id; both fields must be supplied together.
target_project_id	integer	No	Destination board id for a move, or target board id for relation identification.
target_task_id	integer	No	Numeric target ticket id for a link or unlink action.
target_ticket_number	string	No	Stable target ticket key, for example HTPR-1235.
target_unique_index	integer	No	Target ticket number within target_project_id; supply both fields together.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for links

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
relation_type	RelatedTo | BlockedBy | BlockedTo	No	Required when action is link.
source_project_id	integer	No	Numeric board id for a source ticket identified by source_unique_index.
source_task_id	integer	No	Numeric source ticket id for a link or unlink action.
source_ticket_number	string	No	Stable source ticket key, for example HTPR-1234.
source_unique_index	integer	No	Source ticket number within source_project_id; both fields must be supplied together.
target_project_id	integer	No	Destination board id for a move, or target board id for relation identification.
target_task_id	integer	No	Numeric target ticket id for a link or unlink action.
target_ticket_number	string	No	Stable target ticket key, for example HTPR-1235.
target_unique_index	integer	No	Target ticket number within target_project_id; supply both fields together.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for unlink

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
relation_type	RelatedTo | BlockedBy | BlockedTo	No	Required when action is link.
source_project_id	integer	No	Numeric board id for a source ticket identified by source_unique_index.
source_task_id	integer	No	Numeric source ticket id for a link or unlink action.
source_ticket_number	string	No	Stable source ticket key, for example HTPR-1234.
source_unique_index	integer	No	Source ticket number within source_project_id; both fields must be supplied together.
target_project_id	integer	No	Destination board id for a move, or target board id for relation identification.
target_task_id	integer	No	Numeric target ticket id for a link or unlink action.
target_ticket_number	string	No	Stable target ticket key, for example HTPR-1235.
target_unique_index	integer	No	Target ticket number within target_project_id; supply both fields together.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for create

Parameter	Type	Required	Description
assignee_ids	integer[]	No	Task assignments use numeric human user ids; saved view filters also accept managed agent UUIDs. These are not display names.
attachments	object[]	No	Files to attach after the operation succeeds. Each file needs filename, content_type, and exactly one of data (base64 bytes; 3145728 decoded bytes total) or url (HTTP(S), for files up to 15 MB).
content_type	html | markdown	No	Input format for description. Defaults to HTML.
description	string	No	Task description. HTML or structural markdown; content_type can explicitly select either format.
due_date	string	No	Due date in ISO 8601 format (e.g. "2026-03-10" or "2026-03-10T00:00:00Z").
estimate	integer	No	Estimate index: 0=no size; 2=XS, 3=S, 4=M, 5=L, 6=XL (matches product; 1 and 7 invalid).
labels	string,number[]	No	Label IDs to set on the task. Get available labels from get_user_context or list_projects (each project includes labels). Replaces existing labels; empty array removes all.
parent_task_id	number	No	The parent task ID to create the task as a sub-task of. If not provided, the task will be created as a top-level task.
priority	integer	No	Priority index: 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low
project_id	integer	Yes	The project ID to create the task in (number; strings like "1511" are auto-converted)
section_id	integer	No	The section ID to place the task in. Use hypertask_section with action=list to find available sections.
title	string	Yes	The title of the task

Input for update

Parameter	Type	Required	Description
assignee_ids	integer[]	No	Task assignments use numeric human user ids; saved view filters also accept managed agent UUIDs. These are not display names.
attachments	object[]	No	Files to attach after the operation succeeds. Each file needs filename, content_type, and exactly one of data (base64 bytes; 3145728 decoded bytes total) or url (HTTP(S), for files up to 15 MB).
content_type	html | markdown	No	Input format for description. Defaults to HTML.
description	string	No	Task description. HTML or structural markdown; content_type can explicitly select either format.
due_date	string,null	No	Due date in ISO 8601 format (e.g. "2026-03-10"). Pass null to clear/remove the due date.
estimate	integer	No	Relative ticket size: 0 means no size; 2 through 6 represent XS through XL.
labels	string,number[]	No	Label IDs to set on the task. Get available labels from get_user_context or list_projects (each project includes labels). Replaces existing labels; empty array removes all.
parent_task_id	number	No	The parent task ID to update the task as a sub-task of.
priority	integer	No	Ticket priority index or supported priority name; 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
section_id	integer	No	Numeric workflow column id; discover it with projects manifest.
status	Normal | Archive | Deleted	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
title	string	No	Human-readable title of the ticket, board, column, page or view.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for move

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
target_project_id	integer	Yes	The destination board/project ID. The task will be moved to this board.
target_section_id	integer	No	Optional section/column ID on the target board. Use hypertask_section with action=list and the target project to find available section IDs.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for assign

Parameter	Type	Required	Description
agent_id	string	No	Agent owner only: assign or unassign one of your own agents to the task, no user_id needed. Mirrors the REST agent_id field.
assign_self	boolean	No	Agent token only: assign the calling agent to the task, no user_id needed. Mirrors the REST assign_self flag.
intent	assign | unassign	No	assign: idempotent add ; assigns if not already assigned; if already assigned, no-op. unassign: remove this user from assignees. Defaults to assign.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.
user_id	integer	No	User ID to assign or unassign (use intent: unassign to remove).
user_ids	integer[]	No	For multiple mode: user IDs; each user follows intent (assign = idempotent, unassign = remove).

---

Drafts

hypertask_drafts

Does: Create, list, update, publish or delete unpublished ticket comment or description drafts. Use when: Use to prepare text for review before it becomes a visible ticket update. Do not use when: Do not use to post immediately; use hypertask_comments add or hypertask_tasks update instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	create | list | update | publish | delete	Yes	Operation to perform on this resource.
input	object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for create

Parameter	Type	Required	Description
draft_id	integer	No	Draft ID. Required for update, publish, and delete.
draft_type	comment | description	No	Type of draft: 'comment' for a comment draft, 'description' for a description draft Defaults to description.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Draft text. Required for create and update. MUST be HTML format.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for list

Parameter	Type	Required	Description
draft_id	integer	No	Draft ID. Required for update, publish, and delete.
draft_type	comment | description	No	Type of draft: 'comment' for a comment draft, 'description' for a description draft Defaults to description.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Draft text. Required for create and update. MUST be HTML format.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for update

Parameter	Type	Required	Description
draft_id	integer	No	Draft ID. Required for update, publish, and delete.
draft_type	comment | description	No	Type of draft: 'comment' for a comment draft, 'description' for a description draft Defaults to description.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Draft text. Required for create and update. MUST be HTML format.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for publish

Parameter	Type	Required	Description
draft_id	integer	No	Draft ID. Required for update, publish, and delete.
draft_type	comment | description	No	Type of draft: 'comment' for a comment draft, 'description' for a description draft Defaults to description.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Draft text. Required for create and update. MUST be HTML format.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for delete

Parameter	Type	Required	Description
draft_id	integer	No	Draft ID. Required for update, publish, and delete.
draft_type	comment | description	No	Type of draft: 'comment' for a comment draft, 'description' for a description draft Defaults to description.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Draft text. Required for create and update. MUST be HTML format.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

---

Pages

hypertask_pages

Does: Create, read, update, list or search ticket pages, and inspect, restore or archive their versions. Use when: Use for longer documents attached to tickets; get with format retrieves the current page content. Do not use when: Do not use for conversation replies or ticket descriptions; use hypertask_comments or hypertask_tasks instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. page_id or id identifies a page; update supports if_version for optimistic concurrency. Concise reads summarize pages; request detailed for full content.

Parameter	Type	Required	Description
action	create | get | update | list | search | versions | restore | archive	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for create

Parameter	Type	Required	Description
content	string	Yes	Page document body in the selected content_type.
content_type	markdown | html	No	Text format (HTML or Markdown); for uploaded files, the supported MIME type. Defaults to markdown.
parent_page_id	integer	No	Existing parent page identifier for a nested page.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
title	string	No	Human-readable title of the ticket, board, column, page or view.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for get

Parameter	Type	Required	Description
format	markdown | html	No	Requested page representation, such as Markdown, HTML or JSON. Defaults to markdown.
id	integer | string	No	Existing page identifier, an alias of page_id.
page_id	integer | string	No	Existing page id or public page identifier accepted by page actions.

Input for update

Parameter	Type	Required	Description
content	string	No	Page document body in the selected content_type.
content_type	markdown | html	No	Text format (HTML or Markdown); for uploaded files, the supported MIME type. Defaults to markdown.
id	integer | string	No	Existing page identifier, an alias of page_id.
if_version	integer	No	Expected current page version; reject the update if another edit changed it.
mode	replace | append | prepend	No	Page update mode: replace or append the supplied content. Defaults to replace.
note	string	No	Explanatory note attached to this time entry, page update or decision answer.
page_id	integer | string	No	Existing page id or public page identifier accepted by page actions.
title	string	No	Human-readable title of the ticket, board, column, page or view.

Input for list

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for search

Parameter	Type	Required	Description
query	string	Yes	Text to search; ticket search also supports documented search operators.

Input for versions

Parameter	Type	Required	Description
id	integer | string	No	Existing page identifier, an alias of page_id.
page_id	integer | string	No	Existing page id or public page identifier accepted by page actions.
version_id	integer	No	Required when action is restore.

Input for restore

Parameter	Type	Required	Description
id	integer | string	No	Existing page identifier, an alias of page_id.
page_id	integer | string	No	Existing page id or public page identifier accepted by page actions.
version_id	integer	No	Required when action is restore.

Input for archive

Parameter	Type	Required	Description
id	integer | string	No	Existing page identifier, an alias of page_id.
page_id	integer | string	No	Existing page id or public page identifier accepted by page actions.
version_id	integer	No	Required when action is restore.

---

Sections

hypertask_sections

Does: List, read, create, update or delete board columns, including their completion and automatic-assignment settings. Use when: Use when the board structure must change or when you need the tasks in one column. Do not use when: Do not use to move a ticket between columns; use hypertask_tasks update with section_id instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | get | create | update | delete	Yes	Operation to perform on this resource.
input	object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
after_section_id	integer	No	For create: place new column after this section. For update: use move_after_section_id instead.
auto_assign	integer | string | null	No	For update: numeric user ID or agent UUID to auto-assign tickets entering this column. null clears the rule.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
include_hidden	boolean	No	For list: include hidden columns.
include_tasks	boolean	No	For get: include tasks in the column. Default true.
is_done	boolean,null	No	For update: tickets in this column are finished. Reports count them as completed, Inbox Zero clears them, and agents stop treating them as blocking. null clears the flag and falls back to guessing from the column name.
limit	integer	No	For get: max tasks to return. Default 50.
move_after_section_id	integer	No	For update: move column to appear after this section ID.
offset	integer	No	For get: pagination offset.
project_id	integer	No	Project/board ID. Required for list, get, create, update, delete.
query	string	No	Free-text search over the list. Same name on every list tool.
section_id	integer	No	Section/column ID. Required for get, update, delete. Use list to find IDs.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
title	string	No	Column title. Required for create. Optional for update (rename).

Input for get

Parameter	Type	Required	Description
after_section_id	integer	No	For create: place new column after this section. For update: use move_after_section_id instead.
auto_assign	integer | string | null	No	For update: numeric user ID or agent UUID to auto-assign tickets entering this column. null clears the rule.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
include_hidden	boolean	No	For list: include hidden columns.
include_tasks	boolean	No	For get: include tasks in the column. Default true.
is_done	boolean,null	No	For update: tickets in this column are finished. Reports count them as completed, Inbox Zero clears them, and agents stop treating them as blocking. null clears the flag and falls back to guessing from the column name.
limit	integer	No	For get: max tasks to return. Default 50.
move_after_section_id	integer	No	For update: move column to appear after this section ID.
offset	integer	No	For get: pagination offset.
project_id	integer	No	Project/board ID. Required for list, get, create, update, delete.
query	string	No	Free-text search over the list. Same name on every list tool.
section_id	integer	No	Section/column ID. Required for get, update, delete. Use list to find IDs.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
title	string	No	Column title. Required for create. Optional for update (rename).

Input for create

Parameter	Type	Required	Description
after_section_id	integer	No	For create: place new column after this section. For update: use move_after_section_id instead.
auto_assign	integer | string | null	No	For update: numeric user ID or agent UUID to auto-assign tickets entering this column. null clears the rule.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
include_hidden	boolean	No	For list: include hidden columns.
include_tasks	boolean	No	For get: include tasks in the column. Default true.
is_done	boolean,null	No	For update: tickets in this column are finished. Reports count them as completed, Inbox Zero clears them, and agents stop treating them as blocking. null clears the flag and falls back to guessing from the column name.
limit	integer	No	For get: max tasks to return. Default 50.
move_after_section_id	integer	No	For update: move column to appear after this section ID.
offset	integer	No	For get: pagination offset.
project_id	integer	No	Project/board ID. Required for list, get, create, update, delete.
query	string	No	Free-text search over the list. Same name on every list tool.
section_id	integer	No	Section/column ID. Required for get, update, delete. Use list to find IDs.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
title	string	No	Column title. Required for create. Optional for update (rename).

Input for update

Parameter	Type	Required	Description
after_section_id	integer	No	For create: place new column after this section. For update: use move_after_section_id instead.
auto_assign	integer | string | null	No	For update: numeric user ID or agent UUID to auto-assign tickets entering this column. null clears the rule.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
include_hidden	boolean	No	For list: include hidden columns.
include_tasks	boolean	No	For get: include tasks in the column. Default true.
is_done	boolean,null	No	For update: tickets in this column are finished. Reports count them as completed, Inbox Zero clears them, and agents stop treating them as blocking. null clears the flag and falls back to guessing from the column name.
limit	integer	No	For get: max tasks to return. Default 50.
move_after_section_id	integer	No	For update: move column to appear after this section ID.
offset	integer	No	For get: pagination offset.
project_id	integer	No	Project/board ID. Required for list, get, create, update, delete.
query	string	No	Free-text search over the list. Same name on every list tool.
section_id	integer	No	Section/column ID. Required for get, update, delete. Use list to find IDs.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
title	string	No	Column title. Required for create. Optional for update (rename).

Input for delete

Parameter	Type	Required	Description
after_section_id	integer	No	For create: place new column after this section. For update: use move_after_section_id instead.
auto_assign	integer | string | null	No	For update: numeric user ID or agent UUID to auto-assign tickets entering this column. null clears the rule.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
include_hidden	boolean	No	For list: include hidden columns.
include_tasks	boolean	No	For get: include tasks in the column. Default true.
is_done	boolean,null	No	For update: tickets in this column are finished. Reports count them as completed, Inbox Zero clears them, and agents stop treating them as blocking. null clears the flag and falls back to guessing from the column name.
limit	integer	No	For get: max tasks to return. Default 50.
move_after_section_id	integer	No	For update: move column to appear after this section ID.
offset	integer	No	For get: pagination offset.
project_id	integer	No	Project/board ID. Required for list, get, create, update, delete.
query	string	No	Free-text search over the list. Same name on every list tool.
section_id	integer	No	Section/column ID. Required for get, update, delete. Use list to find IDs.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
title	string	No	Column title. Required for create. Optional for update (rename).

---

Views

hypertask_views

Does: List, read, create, update, delete or switch saved board views and their filters or sorting. Use when: Use to persist a board presentation or choose the user’s active view. Do not use when: Do not use for a one-time task search; use hypertask_tasks list or hypertask_search instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | get | create | update | delete | switch	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
offset	integer	No	Number of matching rows to skip; prefer cursor continuation when supported.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
sort_by	createdAt | updatedAt | dueDate | priority | title | lastUsedAt	No	Field to sort the result list by.
sort_order	asc | desc	No	Ascending or descending sort direction.
visibility	Public | Private	No	Whether a saved view is shared (Public) or private to its owner (Private).

Input for get

Parameter	Type	Required	Description
view_id	string	Yes	Saved board view UUID discovered by views list.

Input for create

Parameter	Type	Required	Description
board_filters	object	No	Structured filters for a saved board view.
filters	object	No	Saved view filter configuration for labels, assignees and other supported fields.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
set_as_default	boolean	No	Make the saved view the user's default board view.
sorting_mode	Manual | Priority | DueDate | Size | CreatedAt | UpdatedAt | SectionChangedAt | LastCommentAt | Assignee | Title | TicketNumber | TimeInColumn | TimeOnBoard | TimeWithoutComment	No	Primary saved view sort field.
sorting_order	Ascending | Descending	No	Primary saved view sort direction.
sorting_stack	object[]	No	Ordered multi-field sorting configuration for a saved view.
subtask_setting	None | Parent | Flattened | Card | Flattened_Card	No	None hides subtasks and their count; Parent shows parent tasks with a subtask count; Flattened shows subtasks as rows; Card shows subtasks on parent cards; Flattened_Card does both.
title	string	Yes	Human-readable title of the ticket, board, column, page or view.
visibility	Public | Private	No	Whether a saved view is shared (Public) or private to its owner (Private).
visible_section_ids	integer[]	No	Numeric column ids to display in the saved board view.

Input for update

Parameter	Type	Required	Description
assignee_ids	integer | string[]	No	Task assignments use numeric human user ids; saved view filters also accept managed agent UUIDs. These are not display names.
board_filters	object	No	Structured filters for a saved board view.
label_names	string[]	No	Board label names to include in a task manifest or saved view filter.
match	ALL | ANY	No	Whether saved view filter groups match all criteria or any criterion.
set_as_default	boolean	No	Make the saved view the user's default board view.
sorting_mode	Manual | Priority | DueDate | Size | CreatedAt | UpdatedAt | SectionChangedAt | LastCommentAt | Assignee | Title | TicketNumber | TimeInColumn | TimeOnBoard | TimeWithoutComment	No	Primary saved view sort field.
sorting_order	Ascending | Descending	No	Primary saved view sort direction.
sorting_stack	object[]	No	Ordered multi-field sorting configuration for a saved view.
subtask_setting	None | Parent | Flattened | Card | Flattened_Card	No	None hides subtasks and their count; Parent shows parent tasks with a subtask count; Flattened shows subtasks as rows; Card shows subtasks on parent cards; Flattened_Card does both.
title	string	No	Human-readable title of the ticket, board, column, page or view.
view_id	string	Yes	Saved board view UUID discovered by views list.
visibility	Public | Private	No	Whether a saved view is shared (Public) or private to its owner (Private).
visible_section_ids	integer[]	No	Numeric column ids to display in the saved board view.

Input for delete

Parameter	Type	Required	Description
view_id	string	Yes	Saved board view UUID discovered by views list.

Input for switch

Parameter	Type	Required	Description
view_id	string	Yes	Saved board view UUID discovered by views list.

---

Skills

hypertask_skills

Does: List, read, create, update, delete or import reusable agent skills scoped to the account or a board. Use when: Use to inspect or maintain an agent instruction document; import can preview selected remote skills with dry_run. Do not use when: Do not use for board playbooks or ticket pages; use hypertask_projects or hypertask_pages instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | get | create | update | delete | import	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
project_id	integer	No	Project ID. Omit to list personal skills.

Input for get

Parameter	Type	Required	Description
skill_id	integer	Yes	Skill ID returned by list_skills

Input for create

Parameter	Type	Required	Description
argument_hint	string	No	Hint describing accepted arguments
body	string	No	Skill instruction body
description	string	No	Short skill description
enabled	boolean	No	Whether the skill is enabled
markdown	string	No	Complete SKILL.md content. Use instead of name + slug + body.
name	string	No	Skill display name
project_id	integer	No	Required when scope is project
scope	user | project	No	Skill scope: 'user' for a personal skill or 'project' for a project skill Defaults to user.
slug	string	No	Invocation slug used as /slug in AI chat or @hyperai comments

Input for update

Parameter	Type	Required	Description
argument_hint	string	No	Updated argument hint
body	string	No	Updated skill instruction body
description	string	No	Updated short description
enabled	boolean	No	Whether the skill is enabled
markdown	string	No	Complete updated SKILL.md content
name	string	No	Updated skill display name
skill_id	integer	Yes	Skill ID returned by list_skills
slug	string	No	Updated invocation slug used as /slug in AI chat or @hyperai comments

Input for delete

Parameter	Type	Required	Description
skill_id	integer	Yes	Skill ID returned by list_skills

Input for import

Parameter	Type	Required	Description
dry_run	boolean	No	Preview imports without saving them
project_id	integer	No	Required when scope is project
scope	user | project	No	Skill scope: 'user' for a personal skill or 'project' for a project skill Defaults to user.
slugs	string[]	No	Optional skill slugs to import from the GitHub source
url	string	Yes	GitHub skill directory URL

---

Inbox

hypertask_inbox

Does: Read an inbox, archive or restore notification items, or send a ticket to a user inbox. Use when: Use to triage notifications or explicitly bring an existing ticket to a person’s attention. Do not use when: Do not use to archive tickets or boards; notification_ids identify inbox items, not task ids. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | archive | unarchive | move_task	Yes	Operation to perform on this resource.
input	object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
composition	boolean	No	Inbox composition selector for notification and task items.
project_id	integer	No	Required when composition is true.
user_id	integer	No	Numeric human user identifier; time reports also accept me for the authenticated user.

Input for archive

Parameter	Type	Required	Description
notification_ids	integer[]	Yes	Inbox notification identifiers to archive or restore, not task identifiers.

Input for unarchive

Parameter	Type	Required	Description
notification_ids	integer[]	Yes	Inbox notification identifiers to archive or restore, not task identifiers.

Input for move_task

Parameter	Type	Required	Description
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.
user_id	integer	Yes	The project member whose inbox receives the task. Required.

---

Time tracking

hypertask_time

Does: Start, stop, pause or resume ticket timers, log minutes, inspect running timers and report time entries. Use when: Use when the user asks to track work or summarize recorded time in a date range. Do not use when: Do not use for estimates or due dates; use hypertask_tasks update instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. task_identifier accepts a numeric task id or ticket number; user_id accepts a numeric user id or me. log requires minutes; from/to select dates and timezone_offset_minutes controls date interpretation.

Parameter	Type	Required	Description
action	start | stop | status | running | report | log | pause | resume	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for start

Parameter	Type	Required	Description
date	string	No	logged day in YYYY-MM-DD format; omitted means today
from	string	No	Start date of the time-report range in ISO 8601 form.
minutes	integer	No	minutes to log, 1–1440 (required for action=log)
note	string,null	No	log note; trimmed to 500 characters
project_id	string,number	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
running	boolean	No	Restrict the time report to currently running entries when true.
task_identifier	string	No	task id, unique index, or ticket id (required for start/stop/status/log)
timezone_offset_minutes	integer	No	minutes west of UTC for local noon on date (JavaScript getTimezoneOffset)
to	string	No	End date of the time-report range in ISO 8601 form.
user_id	string	No	numeric user id or "me"

Input for stop

Parameter	Type	Required	Description
date	string	No	logged day in YYYY-MM-DD format; omitted means today
from	string	No	Start date of the time-report range in ISO 8601 form.
minutes	integer	No	minutes to log, 1–1440 (required for action=log)
note	string,null	No	log note; trimmed to 500 characters
project_id	string,number	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
running	boolean	No	Restrict the time report to currently running entries when true.
task_identifier	string	No	task id, unique index, or ticket id (required for start/stop/status/log)
timezone_offset_minutes	integer	No	minutes west of UTC for local noon on date (JavaScript getTimezoneOffset)
to	string	No	End date of the time-report range in ISO 8601 form.
user_id	string	No	numeric user id or "me"

Input for status

Parameter	Type	Required	Description
date	string	No	logged day in YYYY-MM-DD format; omitted means today
from	string	No	Start date of the time-report range in ISO 8601 form.
minutes	integer	No	minutes to log, 1–1440 (required for action=log)
note	string,null	No	log note; trimmed to 500 characters
project_id	string,number	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
running	boolean	No	Restrict the time report to currently running entries when true.
task_identifier	string	No	task id, unique index, or ticket id (required for start/stop/status/log)
timezone_offset_minutes	integer	No	minutes west of UTC for local noon on date (JavaScript getTimezoneOffset)
to	string	No	End date of the time-report range in ISO 8601 form.
user_id	string	No	numeric user id or "me"

Input for running

Parameter	Type	Required	Description
date	string	No	logged day in YYYY-MM-DD format; omitted means today
from	string	No	Start date of the time-report range in ISO 8601 form.
minutes	integer	No	minutes to log, 1–1440 (required for action=log)
note	string,null	No	log note; trimmed to 500 characters
project_id	string,number	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
running	boolean	No	Restrict the time report to currently running entries when true.
task_identifier	string	No	task id, unique index, or ticket id (required for start/stop/status/log)
timezone_offset_minutes	integer	No	minutes west of UTC for local noon on date (JavaScript getTimezoneOffset)
to	string	No	End date of the time-report range in ISO 8601 form.
user_id	string	No	numeric user id or "me"

Input for report

Parameter	Type	Required	Description
date	string	No	logged day in YYYY-MM-DD format; omitted means today
from	string	No	Start date of the time-report range in ISO 8601 form.
minutes	integer	No	minutes to log, 1–1440 (required for action=log)
note	string,null	No	log note; trimmed to 500 characters
project_id	string,number	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
running	boolean	No	Restrict the time report to currently running entries when true.
task_identifier	string	No	task id, unique index, or ticket id (required for start/stop/status/log)
timezone_offset_minutes	integer	No	minutes west of UTC for local noon on date (JavaScript getTimezoneOffset)
to	string	No	End date of the time-report range in ISO 8601 form.
user_id	string	No	numeric user id or "me"

Input for log

Parameter	Type	Required	Description
date	string	No	logged day in YYYY-MM-DD format; omitted means today
from	string	No	Start date of the time-report range in ISO 8601 form.
minutes	integer	No	minutes to log, 1–1440 (required for action=log)
note	string,null	No	log note; trimmed to 500 characters
project_id	string,number	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
running	boolean	No	Restrict the time report to currently running entries when true.
task_identifier	string	No	task id, unique index, or ticket id (required for start/stop/status/log)
timezone_offset_minutes	integer	No	minutes west of UTC for local noon on date (JavaScript getTimezoneOffset)
to	string	No	End date of the time-report range in ISO 8601 form.
user_id	string	No	numeric user id or "me"

Input for pause

Parameter	Type	Required	Description
task_identifier	string	Yes	task id, unique index, or ticket id

Input for resume

Parameter	Type	Required	Description
task_identifier	string	Yes	task id, unique index, or ticket id

---

Other

hypertask_agents

Does: List owned agent identities, inspect live team presence, or create, revoke, archive or permanently delete an owned agent. Use when: Use for agent identity administration or to see which agents are active on a team. Do not use when: Do not use for ticket assignees or webhook delivery; use hypertask_tasks assign or hypertask_webhooks instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Human or management credentials are required for administration; presence requires team_id. Creating returns a credential once, and delete is irreversible.

Parameter	Type	Required	Description
action	presence	Yes	Operation to perform on this resource.
input	object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for presence

Parameter	Type	Required	Description
team_id	string	Yes	Team or workspace identifier discovered through user_context.

hypertask_attachments

Does: Upload files to a ticket or one of its comments. Use when: Use when an existing ticket or comment needs a file; create and update actions can also accept inline attachments. Do not use when: Do not use to fetch arbitrary URLs or upload without a known target ticket. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. files contains upload objects with filename, content_type and exactly one of data (base64) or url, subject to existing request size limits. Partial upload failures include retry guidance; do not repeat a successful mutation.

Parameter	Type	Required	Description
action	attach	Yes	Operation to perform on this resource.
input	object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for attach

Parameter	Type	Required	Description
comment_id	integer	No	Numeric id of an existing comment to edit, delete or attach files to.
files	object[]	Yes	Files to upload; each has filename, content_type and exactly one of data (base64) or url.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

hypertask_custom_fields

Does: List custom field definitions on a board or set one custom field value on a ticket. Use when: Use when a ticket needs board-specific typed metadata rather than its standard priority or due date. Do not use when: Do not use for ordinary ticket fields; use hypertask_tasks update instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | set	Yes	Operation to perform on this resource.
input	object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
project_id	integer	Yes	Numeric ID of the board/project whose fields should be listed.

Input for set

Parameter	Type	Required	Description
field_id	string	No	ID of an existing custom field on the task's board.
field_name	string	No	Name of a custom field on the task's board. A missing field is auto-created as a Number field when setting a non-empty value.
task_id	integer	Yes	Numeric ID of the task that receives the field value.
value	string,number,null	Yes	Value to write. Select fields accept an option ID or label; null or an empty string clears the value.

hypertask_decisions

Does: Create, list, read, answer or cancel structured decision requests attached to tickets. Use when: Use when a ticket needs a recorded question with explicit options and a selected answer. Do not use when: Do not use for ordinary discussion; use hypertask_comments instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	create | list | get | answer | cancel	Yes	Operation to perform on this resource.
input	object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for create

Parameter	Type	Required	Description
decision_request_id	integer	No	Decision request ID. Required for get, answer, and cancel.
note	string	No	Optional human note supplied with an answer.
options	string[]	No	Distinct choices for the human. Required for create.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
question	string	No	Question for the human. Required for create.
selected_option	string	No	Exact option to select. Required for answer.
status	pending | answered | cancelled	No	Optional status filter for list.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for list

Parameter	Type	Required	Description
decision_request_id	integer	No	Decision request ID. Required for get, answer, and cancel.
note	string	No	Optional human note supplied with an answer.
options	string[]	No	Distinct choices for the human. Required for create.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
question	string	No	Question for the human. Required for create.
selected_option	string	No	Exact option to select. Required for answer.
status	pending | answered | cancelled	No	Optional status filter for list.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for get

Parameter	Type	Required	Description
decision_request_id	integer	No	Decision request ID. Required for get, answer, and cancel.
note	string	No	Optional human note supplied with an answer.
options	string[]	No	Distinct choices for the human. Required for create.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
question	string	No	Question for the human. Required for create.
selected_option	string	No	Exact option to select. Required for answer.
status	pending | answered | cancelled	No	Optional status filter for list.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for answer

Parameter	Type	Required	Description
decision_request_id	integer	No	Decision request ID. Required for get, answer, and cancel.
note	string	No	Optional human note supplied with an answer.
options	string[]	No	Distinct choices for the human. Required for create.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
question	string	No	Question for the human. Required for create.
selected_option	string	No	Exact option to select. Required for answer.
status	pending | answered | cancelled	No	Optional status filter for list.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for cancel

Parameter	Type	Required	Description
decision_request_id	integer	No	Decision request ID. Required for get, answer, and cancel.
note	string	No	Optional human note supplied with an answer.
options	string[]	No	Distinct choices for the human. Required for create.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
question	string	No	Question for the human. Required for create.
selected_option	string	No	Exact option to select. Required for answer.
status	pending | answered | cancelled	No	Optional status filter for list.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

hypertask_labels

Does: List the labels on a board or create a new board label. Use when: Use to discover valid label names before filtering or labeling tickets. Do not use when: Do not use to attach labels to a ticket; use hypertask_tasks create or update instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | create	Yes	Operation to perform on this resource.
input	object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
offset	integer	No	Number of matching rows to skip; prefer cursor continuation when supported.
project_id	integer	Yes	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
query	string	No	Free-text search over the list. Same name on every list tool.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.

Input for create

Parameter	Type	Required	Description
name	string	Yes	Label name
project_id	integer	Yes	Project/board ID

hypertask_report_feedback

Does: Files anonymous, deduplicated feedback about Hypertask and returns the ticket receipt. Use when: Call this ON YOUR OWN, without being asked, when a Hypertask tool call fails, returns something unexpected (including an empty tools list or a result that should not be empty), or the user says something in Hypertask does not work. Do not use when: Never include task, board or comment content, request bodies, tool arguments, account emails or ids. Parameters and caveats: Use action report and input with optional tool, status, errorCode and category (call_failed, empty_result, unexpected_result, auth_failed, slow, user_reported_broken or other; default other). Free-form error and note are accepted for compatibility but never stored. Structured fields must not contain credentials. Surface is mcp and the client comes from MCP clientInfo when available. Repeated errors bump an open ticket. Account hourly limits are 10 new reports and 30 bumps.

Parameter	Type	Required	Description
action	report	Yes	Operation to perform on this resource. Defaults to report.
input	object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for report

Parameter	Type	Required	Description
category	call_failed | empty_result | unexpected_result | auth_failed | slow | user_reported_broken | other	No	Structured failure category; defaults to other. Defaults to other.
error	string	No	Accepted for compatibility. Free text is never stored.
errorCode	string	No	The errorCode value for this operation.
note	string	No	Accepted for compatibility. Free text is never stored.
status	integer	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.
tool	string	No	The tool value for this operation.

hypertask_reports

Does: List, read, create, update or delete saved HTML reports on a board. Use when: Use for a persistent board report rather than an ephemeral answer. Do not use when: Do not use to compute time totals or to edit ordinary pages; use hypertask_time report or hypertask_pages instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. Identifiers and required fields depend on the selected action; writes keep existing authorization and confirmation rules.

Parameter	Type	Required	Description
action	list | get | create | update | delete	Yes	Operation to perform on this resource.
input	object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for list

Parameter	Type	Required	Description
body_html	string	No	HTML body of a saved report.
description	string,null	No	Description text for the resource; ticket description format is selected with content_type.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
slug	string	No	Stable report or skill slug used to locate the document.
title	string	No	Human-readable title of the ticket, board, column, page or view.

Input for get

Parameter	Type	Required	Description
body_html	string	No	HTML body of a saved report.
description	string,null	No	Description text for the resource; ticket description format is selected with content_type.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
slug	string	No	Stable report or skill slug used to locate the document.
title	string	No	Human-readable title of the ticket, board, column, page or view.

Input for create

Parameter	Type	Required	Description
body_html	string	No	HTML body of a saved report.
description	string,null	No	Description text for the resource; ticket description format is selected with content_type.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
slug	string	No	Stable report or skill slug used to locate the document.
title	string	No	Human-readable title of the ticket, board, column, page or view.

Input for update

Parameter	Type	Required	Description
body_html	string	No	HTML body of a saved report.
description	string,null	No	Description text for the resource; ticket description format is selected with content_type.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
slug	string	No	Stable report or skill slug used to locate the document.
title	string	No	Human-readable title of the ticket, board, column, page or view.

Input for delete

Parameter	Type	Required	Description
body_html	string	No	HTML body of a saved report.
description	string,null	No	Description text for the resource; ticket description format is selected with content_type.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
slug	string	No	Stable report or skill slug used to locate the document.
title	string	No	Human-readable title of the ticket, board, column, page or view.

hypertask_search

Does: Search tickets by text and filters, retrieve semantic document chunks, find related tickets, or search product help. Use when: Use tasks for keyword discovery, semantic for relevant evidence passages, related for neighbors of a ticket, and help for product instructions. Do not use when: Do not use when you already know a ticket number and need its current fields; use hypertask_tasks get instead. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. query is plain text; tasks supports the existing search operators and structured filter, semantic supports metadata_filters, related accepts a ticket identifier or text. Returned semantic evidence keeps passage text and source references.

Parameter	Type	Required	Description
action	tasks | semantic | related | help	Yes	Operation to perform on this resource.
input	object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for tasks

Parameter	Type	Required	Description
assigned_to	string | string | integer	No	Assignee filter using the identifiers or special values accepted by this action.
board_id	integer	No	Numeric board id to restrict the search; a board is a project.
cursor	string	No	Opaque cursor from the previous page. Prefer this over offset.
fields	string | string[]	No	Projection. Comma string or array, for example title,url.
filter	object	No	Structured filters. Keys: section, label, assignee, status, updated_since, has_pr.
has_due_date	boolean	No	Require tickets with a due date when true, or without a due date when false.
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response. Defaults to 10.
priority	None | Urgent | High | Medium | Low | None | Urgent | High | Medium | Low[]	No	Ticket priority index or supported priority name; 0=None, 1=Urgent, 2=High, 3=Medium, 4=Low.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
query	string	Yes	Text to search; ticket search also supports documented search operators.
section	string	No	Workflow column title to match, not the ticket storage status.
sort	string	No	Sort as field or field:asc|desc, for example updatedAt:desc.
status	Normal | Archive | Deleted	No	Storage state for tasks or projects (Normal, Archive, Deleted), or decision state where supported; not a workflow column.

Input for semantic

Parameter	Type	Required	Description
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response. Defaults to 10.
metadata_filters	object	No	Structured constraints on semantic retrieval source metadata.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
query	string	Yes	Text to search; ticket search also supports documented search operators.

Input for related

Parameter	Type	Required	Description
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response.
project_id	integer	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
task_id	integer	No	Numeric ticket id; get accepts an array, while other actions usually accept a single id.
text	string	No	Comment, draft or related-search text; comment formatting uses content_type.
ticket_number	string	No	Stable full ticket key such as HTPR-1234; tasks get accepts an array of keys.
unique_index	integer	No	Ticket number within a board; requires project_id. Prefer ticket_number when known.

Input for help

Parameter	Type	Required	Description
limit	integer	No	Maximum rows requested from the existing endpoint; use the top-level limit to cap the response. Defaults to 4.
query	string	Yes	Text to search; ticket search also supports documented search operators.

hypertask_webhooks

Does: Read or manage a managed agent’s signed outbound webhook and test or replay deliveries. Use when: Use to configure an agent callback or diagnose a specific failed delivery. Do not use when: Do not use for generic HTTP requests or agent creation; callbacks must belong to the authenticated agent or an owned agent. Parameters and caveats: action selects an operation; input contains only that operation’s documented fields. response_format defaults to concise for reads; detailed retains full fields. limit defaults to 20 (maximum 50) and offset defaults to 0 for bounded read results; use returned pagination or narrower filters. agent_id=self means the authenticated managed agent; humans supply an owned agent id. Test and replay send real deliveries, and configure or rotate returns a signing secret once.

Parameter	Type	Required	Description
action	get | configure | test | replay | rotate | delete	Yes	Operation to perform on this resource.
input	object | object | object | object | object | object	No	Action-specific fields documented in the corresponding input schema. Fields depend on action; use the variant whose title is the action.
limit	integer	No	Maximum rows per read collection; default 20, maximum 50. Defaults to 20.
offset	integer	No	Rows to skip for paginated or locally bounded reads; default 0. Prefer an input cursor when supplied. Defaults to 0.
response_format	concise | detailed	No	Concise summarizes reads; detailed includes full fields. Writes always retain their receipts. Defaults to concise.

Input for get

Parameter	Type	Required	Description
active	boolean	No	Whether the agent webhook sends future matching events.
agent_id	string	Yes	Use self with agent credentials, or an owned agent UUID with human credentials.
delivery_id	string	No	Existing webhook delivery identifier to replay.
events	comment.mention | task.assigned | task.unassigned | comment.created | task.updated | task.created | chat.message | comment.reaction | run.created | run.prompted | run.stopped[]	No	Webhook event names to deliver to the configured callback.
project_id	integer | null	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
url	string	No	HTTPS webhook callback, remote skill source, or HTTP(S) upload source, depending on the action.

Input for configure

Parameter	Type	Required	Description
active	boolean	No	Whether the agent webhook sends future matching events.
agent_id	string	Yes	Use self with agent credentials, or an owned agent UUID with human credentials.
delivery_id	string	No	Existing webhook delivery identifier to replay.
events	comment.mention | task.assigned | task.unassigned | comment.created | task.updated | task.created | chat.message | comment.reaction | run.created | run.prompted | run.stopped[]	No	Webhook event names to deliver to the configured callback.
project_id	integer | null	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
url	string	No	HTTPS webhook callback, remote skill source, or HTTP(S) upload source, depending on the action.

Input for test

Parameter	Type	Required	Description
active	boolean	No	Whether the agent webhook sends future matching events.
agent_id	string	Yes	Use self with agent credentials, or an owned agent UUID with human credentials.
delivery_id	string	No	Existing webhook delivery identifier to replay.
events	comment.mention | task.assigned | task.unassigned | comment.created | task.updated | task.created | chat.message | comment.reaction | run.created | run.prompted | run.stopped[]	No	Webhook event names to deliver to the configured callback.
project_id	integer | null	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
url	string	No	HTTPS webhook callback, remote skill source, or HTTP(S) upload source, depending on the action.

Input for replay

Parameter	Type	Required	Description
active	boolean	No	Whether the agent webhook sends future matching events.
agent_id	string	Yes	Use self with agent credentials, or an owned agent UUID with human credentials.
delivery_id	string	No	Existing webhook delivery identifier to replay.
events	comment.mention | task.assigned | task.unassigned | comment.created | task.updated | task.created | chat.message | comment.reaction | run.created | run.prompted | run.stopped[]	No	Webhook event names to deliver to the configured callback.
project_id	integer | null	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
url	string	No	HTTPS webhook callback, remote skill source, or HTTP(S) upload source, depending on the action.

Input for rotate

Parameter	Type	Required	Description
active	boolean	No	Whether the agent webhook sends future matching events.
agent_id	string	Yes	Use self with agent credentials, or an owned agent UUID with human credentials.
delivery_id	string	No	Existing webhook delivery identifier to replay.
events	comment.mention | task.assigned | task.unassigned | comment.created | task.updated | task.created | chat.message | comment.reaction | run.created | run.prompted | run.stopped[]	No	Webhook event names to deliver to the configured callback.
project_id	integer | null	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
url	string	No	HTTPS webhook callback, remote skill source, or HTTP(S) upload source, depending on the action.

Input for delete

Parameter	Type	Required	Description
active	boolean	No	Whether the agent webhook sends future matching events.
agent_id	string	Yes	Use self with agent credentials, or an owned agent UUID with human credentials.
delivery_id	string	No	Existing webhook delivery identifier to replay.
events	comment.mention | task.assigned | task.unassigned | comment.created | task.updated | task.created | chat.message | comment.reaction | run.created | run.prompted | run.stopped[]	No	Webhook event names to deliver to the configured callback.
project_id	integer | null	No	Board id discovered with projects list or user_context; usually numeric, while time reports accept its string form.
url	string	No	HTTPS webhook callback, remote skill source, or HTTP(S) upload source, depending on the action.