List invites

Every invitation still waiting to be accepted, newest first.

GET/invites

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 pending invitations.

invitesInvite[]

Show properties

Array of Invite

idstring

emailstring

rolestring

Allowed:owneradminmember

invitedByNamestring

createdAtinteger

sentAtinteger | null

sendErrorstring | null

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

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

Response

{
  "invites": [
    {
      "id": "string",
      "email": "string",
      "role": "owner",
      "invitedByName": "string",
      "createdAt": 0,
      "sentAt": 0,
      "sendError": "string"
    }
  ]
}