Management API

Everything the dashboard can do, over HTTP: the inbox, customers, the knowledge base, signals, the agent’s settings, and the numbers. Server to server only, and no CORS headers are sent.

Two credentials open it. MEDIAN_KEY acts as the organization and can do anything an admin can, except send invitations and change members. An MCP OAuth access token acts as the teammate who approved it, with that person’s role checked on every request.

Ids are strings. Pass them back exactly as you received them; an id that is not yours reads as not found.

Account

Who a token is, and the setup acts: organizations and keys.

• GET
  Who am I/me
• POST
  Create an organization/organizations
• POST
  Switch organizations/me/organization
• GET
  List keys/keys
• POST
  Create a key/keys
• DELETE
  Revoke a key/keys/{id}

Conversations

The inbox: read threads, reply, and move conversations along.

• GET
  List conversations/conversations
• GET
  Get a conversation/conversations/{id}
• DELETE
  Delete a conversation/conversations/{id}
• PATCH
  Update a conversation/conversations/{id}
• POST
  Reply as the team/conversations/{id}/messages
• POST
  Add a note/conversations/{id}/notes

Tool approvals

High risk tool calls waiting on a person, and tools run by hand.

• GET
  List runnable tools/conversations/{id}/tools
• POST
  Run a tool/conversations/{id}/tools/run
• GET
  List tools/tools
• POST
  Sync tool endpoints/tools/sync
• POST
  Test a tool/tools/{name}/test
• GET
  List approvals/tool-approvals
• GET
  Get an approval/tool-approvals/{id}
• POST
  Approve a tool call/tool-approvals/{id}/approve
• POST
  Deny a tool call/tool-approvals/{id}/deny
• PATCH
  Switch a tool/tools/{name}
• DELETE
  Remove a tool endpoint/tool-endpoints/{id}

Tool suggestions

Tools the agent went without, each written up as a brief.

• GET
  List tool suggestions/tool-suggestions
• POST
  Mark a suggestion built/tool-suggestions/{id}/built
• POST
  Dismiss a suggestion/tool-suggestions/{id}/dismiss

Customers

Everyone who has written in, and what is known about each.

• GET
  List customers/customers
• GET
  Get a customer/customers/{id}
• DELETE
  Delete a customer/customers/{id}
• POST
  Refresh the profile/customers/{id}/refresh-profile
• POST
  Reach out/customers/{id}/reach-out
• DELETE
  Delete a fact/customers/{id}/facts/{factId}

Knowledge

The agent’s library: documents, folders, the review queue, and crawls.

• GET
  Get the library/knowledge
• GET
  Search documents/knowledge/search
• POST
  Write a document/knowledge/documents
• GET
  Get a document/knowledge/documents/{id}
• DELETE
  Delete a document/knowledge/documents/{id}
• PATCH
  Edit a document/knowledge/documents/{id}
• POST
  Move a document/knowledge/documents/{id}/move
• POST
  Retry indexing/knowledge/documents/{id}/retry
• POST
  Sync external sources/knowledge/sync
• POST
  Create a folder/knowledge/folders
• DELETE
  Delete a folder/knowledge/folders/{id}
• PATCH
  Update a folder/knowledge/folders/{id}
• POST
  Move a folder/knowledge/folders/{id}/move
• GET
  List suggestions/knowledge/suggestions
• POST
  Approve a suggestion/knowledge/suggestions/{id}/approve
• POST
  Dismiss a suggestion/knowledge/suggestions/{id}/dismiss
• GET
  List crawls/knowledge/crawls
• POST
  Start a crawl/knowledge/crawls
• DELETE
  Remove a crawl/knowledge/crawls/{id}

Signals

Bugs and suggestions customers reported, and their trackers.

• GET
  List signals/signals
• POST
  File a signal/signals
• GET
  Get a signal/signals/{id}
• DELETE
  Delete a signal/signals/{id}
• PATCH
  Update a signal/signals/{id}
• POST
  Merge a duplicate/signals/{id}/merge
• POST
  Accept a signal/signals/{id}/accept
• POST
  Apply a commit/signals/commits/{id}/apply
• POST
  Dismiss a commit/signals/commits/{id}/dismiss

Feedback

Raw notes from anywhere, read and placed on the signal lists.

• POST
  Submit feedback/feedback

Tasks

The board work is tracked on: its columns, the requests waiting on a decision, and how it is wired up.

• GET
  List tasks/tasks
• POST
  Create a task/tasks
• GET
  List requests/tasks/requests
• POST
  Put a request on the board/tasks/requests/{id}
• GET
  Get board settings/tasks/settings
• PATCH
  Update board settings/tasks/settings
• GET
  Get a task/tasks/{task}
• DELETE
  Delete a task/tasks/{task}
• PATCH
  Update a task/tasks/{task}
• POST
  Decline a request/tasks/{task}/decline

Integrations

Email, Slack, Discord, GitHub, Notion, Linear: everything after the consent screen.

• GET
  Everything connected/integrations
• PATCH
  Switch email support/integrations/email
• PATCH
  Point the Slack mirror/integrations/slack
• PATCH
  Set up the Discord side/integrations/discord
• PATCH
  Set the Linear team/integrations/linear
• POST
  Set the issue repository/integrations/issue-repo
• DELETE
  Stop opening issues/integrations/issue-repo
• POST
  Watch a repository's commits/integrations/commit-repos
• DELETE
  Stop reading commits/integrations/commit-repos/{owner}/{repo}
• POST
  Mirror a repository/integrations/repos
• DELETE
  Stop mirroring a repository/integrations/repos/{owner}/{repo}
• PATCH
  Set the published address/integrations/repos/{owner}/{repo}

Site

How the public site looks.

• GET
  Get the site's appearance/site/appearance
• PATCH
  Change the site's appearance/site/appearance
• GET
  Get the custom domain/site/domain
• POST
  Connect a custom domain/site/domain
• DELETE
  Remove the custom domain/site/domain
• POST
  Check the custom domain now/site/domain/check
• GET
  Get how visitors sign in/site/sign-in
• PATCH
  Change how visitors sign in/site/sign-in

Organization

The organization, its members, and invitations.

• GET
  Get the organization/organization
• PATCH
  Rename the organization/organization
• GET
  List members/members
• DELETE
  Remove a member/members/{userId}
• PATCH
  Change somebody's role/members/{userId}
• GET
  List invites/invites
• POST
  Invite somebody/invites
• DELETE
  Revoke an invite/invites/{id}

Agent

The AI agent’s name, personality, and autonomy switches.

• GET
  Get the agent/agent
• PATCH
  Update the agent/agent

Webhooks

Where the organization asked to be told what happened.

• GET
  List webhooks/webhooks
• POST
  Add a webhook/webhooks
• DELETE
  Remove a webhook/webhooks/{id}
• PATCH
  Update a webhook/webhooks/{id}

Analytics

The dashboard’s numbers and the analytics page’s charts.

• GET
  Get the overview/analytics/overview
• GET
  Conversation volume/analytics/conversations
• GET
  Satisfaction/analytics/satisfaction
• GET
  Signal trends/analytics/signals
• GET
  Team activity/analytics/activity
• GET
  Knowledge coverage/analytics/knowledge
• POST
  Explore any dataset/analytics/explore
• GET
  Spend and model calls/analytics/billing
• POST
  List the rows a query matched/analytics/records
• GET
  Describe a dataset/analytics/datasets/{dataset}

Billing

API allowances, usage, invoices and the activity log.

• GET
  Read the effective API allowance/billing/limits
• GET
  Read the plan and credits/billing/overview
• GET
  List invoices/billing/invoices
• GET
  Read usage history/billing/usage
• GET
  Read the activity log/logs
• GET
  Read one log entry/logs/{id}

Call

Any method of the MCP client, by name, over HTTP.

• GET
  List methods/call
• POST
  Call a method/call/{method}

Docs

Median’s own documentation, searched and read.

• GET
  Search the docs/docs/search
• GET
  Read a docs page/docs/page