GET /agent
Updated Oct 1, 20261 minute read
Get the agent
The agent's name, personality, and autonomy switches. Defaults until somebody has edited anything.
Part of Agent.
Responses
| Status | Description |
|---|---|
200 | The agent. |
401 | The bearer token is missing, revoked, or expired. |
403 | The token's person does not hold the role this needs. |
429 | Too many requests. Wait the seconds in Retry-After. Limits depend on the plan. See rate limits. |
200 body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | No | |
personality | string | No | |
autoResolve | boolean | No | Whether it may end conversations it finished on its own. |
learnFromThreads | boolean | No | Whether resolved threads get read for knowledge suggestions. |
suggestKnowledge | boolean | No | Whether it may file knowledge and tool suggestions mid-conversation. |
nightlySweep | boolean | No | Whether the nightly sweep may resolve finished threads. |
fileSignals | boolean | No | Whether it may file bugs and suggestions mid-conversation. |
requireEmail | boolean | No | Whether the widget asks for an email before a first message. |
messagePreview | boolean | No | Whether the closed widget previews an unread reply on its button. |
Example request
curl https://api.median.sh/v1/agent \
-H "Authorization: Bearer $BEARER_AUTH"