Update the agent

Whatever is sent moves; everything else is read off the row, so saving a name can never put a switch back. The picture stays in the app.

PATCH/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.

Request body

requiredapplication/json

namestring

min length 2 · max length 40

personalitystring

max length 2000

autoResolveboolean

learnFromThreadsboolean

suggestKnowledgeboolean

nightlySweepboolean

fileSignalsboolean

requireEmailboolean

messagePreviewboolean

Responses

200Done.

okboolean

400The request is malformed, and the message names the field.

errorobject

Show properties

codestring

messagestring

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 PATCH "https://api.median.sh/v1/agent" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "fileSignals": false
}'

const response = await fetch("https://api.median.sh/v1/agent", {
  method: "PATCH",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
  "fileSignals": false
})
});

Response

{
  "ok": true
}