Servers API¶

Older endpoint notes

Rendered from ProjectInfo/api-docs/api/servers.md on docs/encryption-modes-spec. These notes predate the REST API reference, which is canonical wherever the two overlap. They are published because they still cover endpoints the reference does not yet document — check shapes against the reference and the spec errata.

All endpoints require Authorization: Bearer <token>.

POST /api/servers¶

Create a new server. Calling user becomes owner + first member.

Request:

{
  "name": "string (required)",
  "description": "string (optional)"
}

Response 201: Server

GET /api/servers¶

List all servers the authenticated user is a member of.

Response 200: Array of Server

GET /api/servers/{serverID}¶

Fetch a single server. Must be a member.

Response 200: Server

PATCH /api/servers/{serverID}¶

Update server settings. Requires PermAdministrator.

Request (all optional):

{
  "name": "string",
  "description": "string",
  "icon_url": "string",
  "banner_url": "string",
  "verification_level": 0,
  "explicit_filter": 0,
  "afk_timeout_seconds": 300,
  "system_channel_id": "uuid",
  "rules_channel_id": "uuid",
  "afk_channel_id": "uuid"
}

Response 200: Server

DELETE /api/servers/{serverID}¶

Permanently delete a server. Owner only.

Response 204

DELETE /api/servers/{serverID}/members/@me¶

Leave a server. Not available to the owner (must delete the server or transfer ownership).

Response 204