Who am I

The person behind an OAuth token, where the session is bound, and everywhere else it could be. Token-only: a key is an organization, not a person. org is null for a fresh account that has not created one yet.

GET/me

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 person and their organizations.

namestring

orgOrgMembership | any

Show properties

One of:

OrgMembership

idstring

namestring

slugstring

rolestring

Allowed:owneradminmember

any

any

orgsOrgMembership[]

Show properties

Array of OrgMembership

idstring

namestring

slugstring

rolestring

Allowed:owneradminmember

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

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/me" \
  -H "Authorization: Bearer YOUR_TOKEN"

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

Response

{
  "name": "string",
  "org": {
    "id": "string",
    "name": "string",
    "slug": "string",
    "role": "owner"
  },
  "orgs": [
    {
      "id": "string",
      "name": "string",
      "slug": "string",
      "role": "owner"
    }
  ]
}