archive_item
ChatGPTArchives an item (or unarchives it if archived=false). Archived items are hidden from default views but can be recovered.
create_document
ChatGPTCreates a new document attached to an item. The item can be specified using an alias (e.g. "PROJ-123") or UUID.
create_insight
ChatGPTCreates an insight (connection) from a source item to a target item with the given text. The items must belong to workspaces that are connected by an Insights app.
create_item
ChatGPTCreates a new item in a workspace. The workspace must be specified using an alias (e.g. "PROJ"). Use get_workspace_configuration to discover available statuses, fields, and their value formats.
filter_items
ChatGPTSearches for items in an airfocus workspace with optional filters, sorting, and pagination. Returns item aliases, titles, and total count.
get_check_ins
ChatGPTRetrieves check-ins on an item, most recent first. Works for objectives and items in workspaces with the Check-ins app installed. Each check-in has a confidence (On track / At risk / Off track), date, author, and optional comment; Objective check-ins additionally have a progress value.
get_document
ChatGPTRetrieves a document by its ID, including its title, content, and linked items and workspaces.
get_item_insights
ChatGPTGet insights (feedback, evidence, quotes) collected for specific items. Returns insight text, source references, dates, summary, and score.
get_items
ChatGPTRetrieves specific items from an airfocus workspace by their identifiers. Items can be specified using aliases (e.g. "PROJ-123") or UUIDs. Returns item names, descriptions, statuses, assignees, custom field values, etc. Also returns the number of linked items, documents, comments, parents, children, etc.
get_linked_items
ChatGPTReturns the items linked to an airfocus item: its parent, children, and item links (dependencies, duplicates, relations, and any team-defined link types). Each linked item shows its alias, type, name, and status. Use this for relationship-shaped questions: what blocks an item, what it depends on, what it duplicates, what initiative it belongs to, what tasks roll up under it, or any team-defined link verb (e.g. what an item "implements"). This tool returns ONLY EXPLICITLY LINKED items. For semantically similar items, use semantic_search_items. For customer feedback or insights attached to an item, use get_item_insights. Results are paginated: a single call returns up to 50 linked items across all sections (link types in display order, then Parent, then Children). When more exist, the output ends with Use offset=X to see more results. — call again with that offset to continue.
get_workspace_configuration
ChatGPTRetrieves the configuration of an airfocus workspace, including its statuses, fields, types, requirements, and its parent/child workspace hierarchy. Use this to understand a workspace's structure settings.
link_items
ChatGPTCreates parent-child relationships between items. Use when the user asks to link, nest, or make one item a parent/child of another. Each from item is linked to each to item. One of the two lists must contain exactly one item; the other may contain several. Both lists having multiple items is rejected. Max 50 pairs per call. Hierarchy must be enabled per workspace — call get_workspace_configuration first to confirm which workspaces support parent/child links and in which direction. Requires Write permission on both workspaces. Items can have multiple parents. Re-creating an existing link is a no-op. Self-links are always rejected.
search_documents
ChatGPTSearches for documents the caller can access, optionally scoped to a single item and/or filtered by text. When item is omitted, searches across every document the caller can read. Returns matching documents with their titles, IDs, and linked items. Use offset and limit to page through results.
search_item_activity
ChatGPTAnswers "what happened to this item?" questions — tracks who made each change and when, covering field updates, status changes, assignee changes, and all comment events (added, edited, deleted). Prefer this over get_comments when the question is about history or activity; use get_comments when you need the actual text of current comments. Most recent first, paginated.
search_member_groups
ChatGPTSearches member groups by name. Returns each group's name and ID.
search_users
ChatGPTSearches team members by name. Returns each user's name and ID. Use this to find user IDs for mentions or assignments.
search_workspaces
ChatGPTLists available workspaces, optionally filtered by name, alias, workspace ID, or copied workspace URL. Returns each workspace's name, alias, workspace type, and workspace group.
semantic_search_items
ChatGPTSearches for items across one or more workspaces using semantic similarity. Returns items ranked by relevance to the search text.
unlink_items
ChatGPTRemoves parent-child relationships between items. Use when the user asks to unlink, unnest, or remove a parent/child relationship. Each from item is unlinked from each to item. One of the two lists must contain exactly one item; the other may contain several. Both lists having multiple items is rejected. Max 50 pairs per call. Requires Write permission on both workspaces. Removing a relationship that does not exist is a no-op. Do not use this tool to check whether a link exists; use get_linked_items instead.
update_document
ChatGPTUpdates a document's title and/or content. Omit a field to leave it unchanged. Pass an empty string for title to clear the document's title. Use get_document to retrieve the current content before making changes.
update_item
ChatGPTUpdates an existing item's properties. The item can be specified using an alias (e.g. "PROJ-123") or UUID.