{"version":"v1","auth":"Authorization: Bearer gt_...","endpoints":[{"method":"GET|POST","path":"/api/v1/ask","description":"Ask a natural-language question about the company. Returns the most relevant sources (pages, decisions, records) with numbered citations and a quick draft answer; compose your final answer from `sources` and cite them as [n]. Use this first for any 'what/who/how/why' question about how the company works.","input":{"type":"object","properties":{"question":{"type":"string","description":"The question, in plain language."}},"required":["question"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/search","description":"Keyword search across pages, decisions and records. Returns ranked hits with snippets and ids you can pass to get_page.","input":{"type":"object","properties":{"query":{"type":"string","description":"Search terms."},"types":{"type":"array","items":{"type":"string","enum":["page","decision","record"]},"description":"Optional filter."},"limit":{"type":"integer","minimum":1,"maximum":25,"description":"Default 8."}},"required":["query"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_pages","description":"List pages (id, title, space, tags, owner, staleness). Optionally filter by space or tag.","input":{"type":"object","properties":{"space":{"type":"string","description":"Space name, e.g. 'Engineering'."},"tag":{"type":"string","description":"Tag, e.g. 'policy'."}},"required":[],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/get_page","description":"Read a full page as markdown, with owner, last editor (human or agent), staleness, a one-line summary, the pages it links to ([[Page title]] links, including ones not written yet) and the pages that link to it.","input":{"type":"object","properties":{"page":{"type":"string","description":"Page id (p_...) or exact title."}},"required":["page"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_my_pages","description":"The user's personal knowledge base in this workspace: private pages only they can see (their notes, experience, cases, 1:1s), colleagues' private pages shared with them (read-only), and the ones they shared with the workspace. Only for the user's own sign-in; ask and search already include these pages for them.","input":{"type":"object","properties":{"tag":{"type":"string","description":"Filter by tag, e.g. 'case'."}},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/create_page","description":"Create a new markdown page. Search first to avoid duplicates, and follow the workspace's agent handbook (get_handbook). Link related pages with [[Page title]]. The page is attributed to you (an agent) in the activity log.","input":{"type":"object","properties":{"title":{"type":"string","description":"Page title."},"body":{"type":"string","description":"Markdown body."},"space":{"type":"string","description":"Space, e.g. 'Engineering', 'Customers', 'People'. Default 'General'."},"tags":{"type":"array","items":{"type":"string"}},"owner":{"type":"string","description":"Human owner responsible for keeping it true."},"description":{"type":"string","description":"One sentence for the index: what this page is about."},"private":{"type":"boolean","description":"true: save it in the user's personal knowledge base, visible only to them (their notes, experience, cases). Use this for anything personal."}},"required":["title","body"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/update_page","description":"Replace a page's title, body, space, tags or owner. Prefer append_to_page for adding notes. Include a short summary of what changed and why.","input":{"type":"object","properties":{"page":{"type":"string","description":"Page id or exact title."},"title":{"type":"string","description":"New title."},"body":{"type":"string","description":"New full markdown body."},"space":{"type":"string","description":"New space."},"tags":{"type":"array","items":{"type":"string"}},"owner":{"type":"string","description":"New owner."},"description":{"type":"string","description":"New one-sentence summary for the index (empty to derive it from the body)."},"summary":{"type":"string","description":"One line: what changed and why (shown in the activity log)."}},"required":["page","summary"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/append_to_page","description":"Append markdown to the end of a page (e.g. an incident timeline entry, meeting notes, a new FAQ).","input":{"type":"object","properties":{"page":{"type":"string","description":"Page id or exact title."},"text":{"type":"string","description":"Markdown to append."},"summary":{"type":"string","description":"One line for the activity log."}},"required":["page","text"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/verify_page","description":"Mark a page as verified (still correct). Used by people in the web app; not available to agents.","input":{"type":"object","properties":{"page":{"type":"string","description":"Page id or exact title."}},"required":["page"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/get_index","description":"The whole workspace at a glance: every page by space with a one-line summary, owner, review state and its links, plus decisions, record collections, the agent handbook and the number of open knowledge gaps. Read this first to find your way around, instead of many searches.","input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/get_handbook","description":"The workspace's conventions for people and AI assistants: where things go, how to write, what to check before changing something. Follow it when you write.","input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_gaps","description":"Questions people and assistants asked that this workspace couldn't answer, most asked first. Each says whether the workspace can answer it now. Good work for an agent: help write the missing pages (ask a person for the facts).","input":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":200,"description":"Default 50."}},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/save_answer","description":"File a good answer back into the workspace as a page, so the next person (or agent) finds it. Use after you composed an answer from `ask` sources that people will need again. Include the sources you cited (page titles become [[links]]). The page waits for a person to review it. An answer that cites the user's private pages is saved privately, in their personal knowledge base.","input":{"type":"object","properties":{"question":{"type":"string","description":"The question that was asked."},"answer":{"type":"string","description":"Your answer, in markdown, with [n] citation markers."},"sources":{"type":"array","items":{"type":"string"},"description":"Titles of the sources you cited, in [n] order."},"title":{"type":"string","description":"Page title. Default: the question."},"space":{"type":"string","description":"Space. Default 'Answers'."}},"required":["question","answer"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/propose_changes","description":"Propose updates to every page one source affects (a meeting, a document, a URL), as one changeset a person reviews in Groundtruth. Nothing changes until they accept. Use this instead of update_page when a source touches several pages. Read each page with get_page first; give its full new body, changing only what the source supports, and one line on why. To add a page nobody has written, give title instead of page. At most 15 changes.","input":{"type":"object","properties":{"source":{"type":"object","properties":{"title":{"type":"string","description":"What the source is, e.g. 'Weekly sync 14 Oct' or 'Pricing update email'."},"url":{"type":"string","description":"Link to the source, if it has one."},"page":{"type":"string","description":"Page id or title, if the source is a page in Groundtruth (e.g. a filed meeting)."}},"required":["title"],"additionalProperties":false},"summary":{"type":"string","description":"Two or three sentences: what the source says that matters, and what you propose."},"changes":{"type":"array","minItems":1,"maxItems":15,"items":{"type":"object","properties":{"page":{"type":"string","description":"Page id or exact title to edit. Leave out to create a new page."},"title":{"type":"string","description":"Title of a new page (only when page is left out)."},"body":{"type":"string","description":"The page's full new markdown body."},"reason":{"type":"string","description":"One line: what changed and which part of the source says so."},"space":{"type":"string","description":"Space for a new page. Default 'General'."},"tags":{"type":"array","items":{"type":"string"}},"description":{"type":"string","description":"One sentence for the index."}},"required":["body","reason"],"additionalProperties":false}}},"required":["source","changes"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_changes","description":"Changesets proposed from sources (propose_changes), newest first, with what was accepted, rejected or conflicted. Check this before proposing the same source again.","input":{"type":"object","properties":{"status":{"type":"string","description":"open = waiting for review, done = reviewed.","enum":["open","done"]},"limit":{"type":"integer","minimum":1,"maximum":100,"description":"Default 20."}},"required":[],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/research","description":"For questions where a probably-right answer isn't good enough (contracts, money, compliance, commitments to customers). Starts the workspace's Research Agent: several rounds with the strongest model at maximum effort, where every claim must quote its source word for word and survive a sceptical check. Takes minutes. Returns a research id: call get_research with it until status is done, then give the user the verdict (verified, partial or not_verified) and its reasons along with the answer. Needs the Research Agent switched on and the workspace's own AI key.","input":{"type":"object","properties":{"question":{"type":"string","description":"The question, in plain language, with everything that matters (which customer, period, plan)."}},"required":["question"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/get_research","description":"Progress and, when done, the result of a research question started with research: the verdict and its reasons, the answer built only from verified claims, each claim's exact quotes, the claims that were dropped and why, and the sources with any cautions (unreviewed or outdated pages). Poll every 20-30 seconds while status is running.","input":{"type":"object","properties":{"id":{"type":"string","description":"Research id (rs_...)."}},"required":["id"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_decisions","description":"List the decision log (newest first): what was decided, why, by whom, and status.","input":{"type":"object","properties":{"status":{"type":"string","description":"Filter by status.","enum":["proposed","accepted","superseded","rejected"]},"tag":{"type":"string","description":"Filter by tag."}},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/log_decision","description":"Record a decision with its context so humans and agents can later ask 'why is it like this?'. Use status 'proposed' if a human still needs to approve it.","input":{"type":"object","properties":{"title":{"type":"string","description":"Short decision title."},"decision":{"type":"string","description":"What was decided."},"context":{"type":"string","description":"Why: the problem, options considered, data."},"status":{"type":"string","description":"Default 'accepted'.","enum":["proposed","accepted","superseded","rejected"]},"owner":{"type":"string","description":"Human owner of the decision."},"date":{"type":"string","description":"YYYY-MM-DD. Default today."},"tags":{"type":"array","items":{"type":"string"}}},"required":["title","decision"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/query_records","description":"Query structured records (e.g. customers, metrics, people, vendors). `where` supports exact match {field: value} or operators {field: {gt|gte|lt|lte|contains: value}}. `sort` is a field name, prefix '-' for descending. Call without collection to list collections.","input":{"type":"object","properties":{"collection":{"type":"string","description":"Collection name, e.g. 'customers'."},"where":{"type":"object","description":"Filter conditions."},"sort":{"type":"string","description":"Field to sort by, e.g. '-mrr'."},"limit":{"type":"integer","minimum":1,"maximum":500}},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/upsert_record","description":"Create a record, or update it if one with the same collection+title (or id) exists. Fields are merged.","input":{"type":"object","properties":{"collection":{"type":"string","description":"Collection, e.g. 'customers'."},"title":{"type":"string","description":"Record title (unique within the collection)."},"fields":{"type":"object","description":"Flat key/value fields (string, number, boolean)."},"id":{"type":"string","description":"Optional record id to update."}},"required":["collection","title"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/get_activity","description":"Recent changes in the workspace, newest first, with who made them and whether they were a human or an agent.","input":{"type":"object","properties":{"limit":{"type":"integer","minimum":1,"maximum":200},"actor_type":{"type":"string","description":"Filter.","enum":["human","agent"]}},"required":[],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_alerts","description":"Open alerts raised by the workspace's agents (contract deadlines, churn risk, stale pages), most urgent first. Check this when asked what needs attention.","input":{"type":"object","properties":{"status":{"type":"string","description":"Default open.","enum":["open","resolved","dismissed"]},"agent":{"type":"string","description":"Filter by agent id, e.g. contract-agent."},"limit":{"type":"integer","minimum":1,"maximum":500}},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/resolve_alert","description":"Mark an alert resolved (handled) or dismissed (not relevant), with a short note on what was done.","input":{"type":"object","properties":{"alert_id":{"type":"string","description":"Alert id (al_...)."},"status":{"type":"string","description":"Default resolved.","enum":["resolved","dismissed"]},"note":{"type":"string","description":"What was done."}},"required":["alert_id"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_agents","description":"The Agent Store: which agents exist, which are installed in this workspace, their settings and last run.","input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/run_agent","description":"Run an installed agent immediately (they also run daily). Returns its summary and any new alerts. New alerts may be posted to the workspace's alert webhook (e.g. Slack) if one is set.","input":{"type":"object","properties":{"agent":{"type":"string","description":"Agent id, e.g. contract-agent, churn-agent, freshness-agent."}},"required":["agent"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/log_interaction","description":"Record an interaction with a customer (meeting, email, ticket, call, NPS response). Feeds the Churn Agent's risk scores.","input":{"type":"object","properties":{"customer":{"type":"string","description":"Customer name exactly as in the customers collection."},"type":{"type":"string","description":"meeting, email, ticket, call, nps, note."},"date":{"type":"string","description":"YYYY-MM-DD. Default today."},"sentiment":{"type":"string","description":"How it went.","enum":["positive","neutral","negative"]},"nps":{"type":"number","minimum":0,"maximum":10,"description":"NPS score if this was a survey response."},"summary":{"type":"string","description":"One or two sentences: what happened."}},"required":["customer","summary"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_tasks","description":"Cards on the workspace's kanban board, by priority. Filter by status (todo, doing, blocked, review, done) and assignee (a person's name, an agent's name like 'Claude', 'me', or 'unassigned'). Check your own column with assignee='me'. `stale: true` marks work stuck in progress for 6h+.","input":{"type":"object","properties":{"status":{"type":"string","description":"todo | doing | blocked | review | done"},"assignee":{"type":"string","description":"Name, 'me', or 'unassigned'."},"assignee_type":{"type":"string","description":"human or agent","enum":["human","agent"]},"limit":{"type":"integer","minimum":1,"maximum":500}},"required":[],"additionalProperties":false}},{"method":"POST","path":"/api/v1/create_task","description":"Add a card to the board. Assign it to a person (their name) when a human must act (e.g. buy a domain, approve spend), or to an agent by name. Put clear, step-by-step instructions in the description.","input":{"type":"object","properties":{"title":{"type":"string","description":"Short imperative title."},"description":{"type":"string","description":"What to do, why, and how to know it's done (markdown)."},"assignee":{"type":"string","description":"Person's name, an agent name (e.g. 'Claude'), or 'me'."},"assignee_type":{"type":"string","description":"Force human or agent.","enum":["human","agent"]},"status":{"type":"string","description":"Default todo."},"priority":{"type":"string","description":"Default medium.","enum":["low","medium","high","urgent"]},"due":{"type":"string","description":"YYYY-MM-DD."}},"required":["title"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/update_task","description":"Move a card (status), reassign it, edit it, or add a comment in the same call. Statuses: todo, doing, blocked, review, done. Agents can move cards up to 'review'; only people can mark them 'done'.","input":{"type":"object","properties":{"task_id":{"type":"string","description":"Task id (t_...)."},"status":{"type":"string","description":"todo | doing | blocked | review | done"},"assignee":{"type":"string","description":"New assignee."},"assignee_type":{"type":"string","description":"human or agent","enum":["human","agent"]},"title":{"type":"string","description":"New title."},"description":{"type":"string","description":"New description."},"priority":{"type":"string","description":"low | medium | high | urgent","enum":["low","medium","high","urgent"]},"due":{"type":"string","description":"YYYY-MM-DD"},"comment":{"type":"string","description":"Progress note to add to the card."}},"required":["task_id"],"additionalProperties":false}},{"method":"POST","path":"/api/v1/comment_task","description":"Add a progress note, question or result to a card.","input":{"type":"object","properties":{"task_id":{"type":"string","description":"Task id (t_...)."},"text":{"type":"string","description":"Markdown."}},"required":["task_id","text"],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/whoami","description":"Which workspace this call acts in, who you are acting as, whether you can write there, and which other workspaces this connection can use.","input":{"type":"object","properties":{},"required":[],"additionalProperties":false}},{"method":"GET|POST","path":"/api/v1/list_workspaces","description":"The workspaces this connection can use, with your role in each and which one is the default. Pass a workspace's slug as `workspace` to any tool to act there.","input":{"type":"object","properties":{},"required":[],"additionalProperties":false}}]}