Get the agent

The agent’s name, personality, and autonomy switches. Defaults until somebody has edited anything.

GET/agent

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Responses

200The agent.

namestring

personalitystring

autoResolveboolean

Whether it may end conversations it finished on its own.

learnFromThreadsboolean

Whether resolved threads get read for knowledge suggestions.

suggestKnowledgeboolean

Whether it may file knowledge and tool suggestions mid-conversation.

nightlySweepboolean

Whether the nightly sweep may resolve finished threads.

fileSignalsboolean

Whether it may file bugs and suggestions mid-conversation.

requireEmailboolean

Whether the widget asks for an email before a first message.

messagePreviewboolean

Whether the closed widget previews an unread reply on its button.

401The bearer token is missing, revoked, or expired.

errorobject

Show properties

codestring

messagestring

403The token's person does not hold the role this needs.

errorobject

Show properties

codestring

messagestring

429Too many requests. Wait the seconds in `Retry-After`. Limits depend on the plan. See [rate limits](/api/errors-and-limits#rate-limits).

errorobject

Show properties

codestring

messagestring

Request

curl -X GET "https://api.median.sh/v1/agent" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/agent", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "name": "string",
  "personality": "string",
  "autoResolve": true,
  "learnFromThreads": true,
  "suggestKnowledge": true,
  "nightlySweep": true,
  "fileSignals": true,
  "requireEmail": true,
  "messagePreview": true
}