Skip to main content
The Median HTTP API lets you forward customer feedback into a workspace from your own apps, embeds, or scripts. Median ingests the submission, optionally classifies it as product feedback, and turns it into tasks on your board.

​
Base URL

https://api.median.sh

​
Conventions

  • Requests and responses use JSON (Content-Type: application/json).
  • Authenticate with a workspace API key — see Authentication.
  • Times are Unix milliseconds.
  • Successful submissions return 202 Accepted while processing happens asynchronously.

​
Error shape

Errors are returned as JSON with a single error field and an appropriate HTTP status code. 
{
  "error": "Missing API key. Provide via Authorization: Bearer <key> or apiKey in body."
}
StatusMeaning
400The request body was invalid (missing content, wrong field type, etc.)
401The API key is missing, malformed, or revoked.
402The workspace does not have an active plan.
405Wrong HTTP method for the endpoint.

​
Billing

Each accepted submission counts as one integration event against your workspace plan. When the LLM classifier or extractor runs, AI usage is metered per token in addition to the event credit.