GET /config

Updated Oct 1, 20261 minute read

Get the config

Your organization's name and the agent that answers. Renaming the agent in the dashboard is reflected here.

Part of Conversations.

Responses

Status	Description
`200`	The organization and its agent.
`401`	`missing_api_key`: no bearer token. `invalid_api_key`: the key matches no organization or was revoked. `publishable_key`: a `median_pk_` key was sent. An OAuth access token is refused here with `invalid_api_key`.
`429`	The organization's API allowance for this class of request is used up. Wait the `Retry-After` header's seconds. Limits depend on the plan. See rate limits.

Field	Type	Required	Description
`orgName`	`string`	Yes
`agent`	`object`	Yes	Who answered. Covers both the AI and your team.
`agent.kind`	`"ai" \| "human"`	Yes
`agent.name`	`string`	Yes
`agent.avatarUrl`	`any`	Yes

{
  "orgName": "Acme",
  "agent": {
    "kind": "ai",
    "name": "Median AI",
    "avatarUrl": null
  }
}

curl https://api.median.sh/v1/config \
  -H "Authorization: Bearer $MEDIAN_KEY"