Ferris

Add a label to an organization. project_role labels are people's titles (used as title_id). project_type labels classify projects in Ferris. Re-creating an archived label restores it. Requires owner or admin.

create_org_label

Create a board task on a project. Returns the task with its id and task_number. Requires write access.

create_task

Post a note comment on a task. Reply in a thread with parent_comment_id. Mention people with mention_actor_ids from list_project_actors; they get a notification. Returns the comment with its id.

create_task_comment

Delete a requirement and its epic links. For a scope cut, set status withdrawn instead. Requires write access.

delete_requirement

Delete a note comment you authored, including its @-mentions. Threaded replies under this comment are also removed. Permission and questionnaire comments cannot be deleted.

delete_task_comment

One client company (account).

get_account

One person on a client company.

get_account_contact

Returns a short-lived download link for a generated artifact in the project, with its filename, type, and expires_at. The link works for anyone who has it until it expires.

get_artifact_download_url

Returns a short-lived download link for one of a task's attachments, with its filename, type, and expires_at. A draft's link is to its latest saved version. The link works for anyone who has it until it expires.

get_attachment_download_url

Get one document's metadata by id: filename, display_name, document_type, processing status, file_size, mime_type, its external link, a summary when one exists, and when it was added and processed.

get_document

Get a single document's AI-generated summary and metadata (works for both project and org-level documents). Use after list_documents when you need the summary content of a specific document. Returns: filename, display_name, document_type, summary text, processing status, and created_at.

get_document_summary

Get one epic on a project, with the requirement_ids it satisfies.

get_epic

One issue. A closed issue carries its close_reason; a completed one also has its resolution.

get_issue

Get the ranked next actions for an actor in this project, most effect on the date first. continue lists their work in progress. focus lists their ready tasks and client work worth chasing (kind next or chase), at most 3. Each item has a reason line, criticality, slack days, days saved at P80 and how many tasks it unblocks. Defaults to the calling actor.

get_next_actions

Get full details of a specific project by ID.

get_project

Get this project's schedule forecast: the likely (P50) and fairly sure (P80) finish dates, the chance of finishing by the target date, each deliverable's dates and odds, and the tasks that move the date most (drivers, with the working days saved at P80 if each takes exactly its planned time). Ferris recomputes it within minutes of a plan change; stale is true when the plan changed after the last run.

get_schedule_forecast

Get details for a single task including assignees. Works for board tasks and issues.

get_task

Email an invitation to join the organization. Pass project_id to add them to that project when they accept. Re-inviting the same email refreshes the invitation. Requires owner or admin.

invite_org_member

People who belong to a client company. Use account_contact_id with add_project_contact.

list_account_contacts

List client companies (accounts) in an organization. Use the returned id with get_account and list_account_contacts.

list_accounts

List documents (metadata only, no content). Returns id, filename, display_name, document_type, status, and created_at. display_name is the user-chosen name (may be null); filename is the original file name. Use scope='project' (default) for native project documents plus org documents routed into this project. Use scope='organization' for org-level shared documents. Use query to match filename or display_name. Use get_document_summary to get the AI-generated summary for a specific document.

list_documents

Epics (deliverables) on a project, each with the requirement_ids it satisfies. Use id as epic_id when creating or filtering tasks.

list_epics

Lists a project's generated artifacts: documents Ferris produced and published to the Project Library from a task, a chat, or a workflow run, newest first. Each has an id, name, format, version, size, status (ready, processing, or failed), created and updated times, and its source. has_more is true when another page follows.

list_generated_artifacts

List issue tasks for a project. Optionally filter by status. Defaults to unresolved issues.

list_issues

List what changed for you in Ferris over the last few days, across your projects: tasks assigned to you, changes and new comments on your open tasks, @-mentions of you, client questions you own, tasks that were unblocked, and action items from recent meetings. Each update has a date, project, task, link, and a short reason. Newest first. Covers up to 25 projects per call; projects_skipped says how many were left out, and project_id reads one project.

list_my_recent_updates

Invitations that have not been accepted yet. Requires owner or admin.

list_org_invitations

Labels an organization defines. project_role labels are people's titles (used as title_id). project_type labels classify projects in Ferris.

list_org_labels

People in an organization: user_id, name, email, org role (owner, admin, member, viewer), and title.

list_org_members

List all organizations the authenticated user belongs to, including the user's role in each.

list_organizations

People and agents you can assign or mention. Use actor_id with task assignees and comment mentions.

list_project_actors

Account contacts placed on this project. account_contact_id matches list_account_contacts.

list_project_contacts

People on the project team: name, email, and role.

list_project_members

List the projects you can see, with each project's id, name, description, organization, and client account. Optionally filter by name substring.

list_projects

List the project's requirements: the conditions the delivered result must meet. Each has epic_ids (the epics, or deliverables, that satisfy it), assignees, and is_satisfied. is_satisfied is true when at least one epic is linked and every linked epic that is not cancelled is completed. uncovered_only returns requirements with no linked epic that is not cancelled.

list_requirements

Lists a task's attachments: reference files people added (input_file), drafts Ferris is working on (draft_artifact), and published deliverables (promoted_artifact). Each has an id, type, label, filename, and created time.

list_task_attachments

List the note comments on a task, oldest first, with threaded replies and @-mentions. Each comment has its author_actor_id; list_project_actors gives the names.

list_task_comments

List tasks on a project, filtered by status, epic, assignee, or kind (general, issue, or administrative). By default it returns board tasks that are not cancelled, including completed ones. Administrative tasks take status changes only; approving one happens in Ferris. A closed task carries its close_reason.

list_tasks

Take a contact off a project. They stay on the client company. Requires write access.

remove_project_contact

Take a member off a project. Agents they sponsor on the project are removed. They stay in the organization. Requires write access.

remove_project_member

Complete an issue with its resolution. The resolution is stored as the issue's close_reason, pinned as its resolution comment, and saved to project knowledge. Returns the issue and the comment. Requires write access.

resolve_issue