Spaces

Create a new space. The authenticated user becomes the owner. Human-only.

Update space metadata. Supports both JSON and multipart/form-data for image uploads. Uses OptionalField for nullable fields (send null to clear, omit to keep). Requires being the owner or an Administrator, checked before any upload; otherwise 403 with "you don't have permission to manage this space".

Search the messages of the rooms of the space that the user can view, newest first. Human-only. It needs some text or a filter. The values of one filter are alternatives (any of them), and different filters must all match. Pin notices are no results.

Create a new room inside a space. Requires ManageChannels permission.

Update room settings. Categories only support name and position changes.

Delete a room from a space. Requires ManageChannels permission.

Create or update a permission overwrite for a room. Requires ManageChannels permission in that room. Every permission you newly allow or deny must be one you have in that room, unless you own the space or are an Administrator. Keeping or clearing existing allows and denies isn't restricted. A room has at most one overwrite per target, so this replaces it if there is one, and its target type can't change. The target must be a role of this space (the @everyone role's ID is the space ID) or a member of it (404 otherwise), and flags outside the permission table are rejected (400).

Remove a permission overwrite from a room. Requires ManageChannels permission in that room.

Generate an invite link for a specific room of the space. Requires CreateInvites permission. The body is optional.

List the space's invites that still work (at most 1000), newest first. Expired ones are deleted within the hour. Requires ManageInvites permission.

Delete one of the space's invites: its link stops working. Requires ManageInvites permission.

Create a new role in a space. Requires ManageRoles permission. The new role can only include permissions you have, and flags outside the permission table are rejected (400).

Update an existing role. Requires ManageRoles permission. Unless you own the space, the role must be below your highest role, it can't be moved to or above it, and you can only add permissions you have. Flags outside the permission table are rejected (400).

Delete a role from a space. Requires ManageRoles permission. Unless you own the space, the role must be below your highest role.

Assign a role to a space member. Requires ManageRoles permission. Unless you own the space, the role must be below your highest role.

Remove a role from a space member. Requires ManageRoles permission. Unless you own the space, the role must be below your highest role.

List all custom emojis in a space.

Upload a new custom emoji to a space. Sent as multipart/form-data with an image file.

Rename a custom emoji.

Delete a custom emoji from a space.

List all custom stickers in a space.

Upload a new custom sticker to a space. Sent as multipart/form-data with an image file.

Rename a custom sticker.

Delete a custom sticker from a space.

Retrieve paginated members for a space.

Remove the authenticated user from the space. Space owners cannot leave their own space.

Add a bot user to a space. Requires ManageBots permission. The bot must be public. Human-only.

Remove a bot user from a space. Requires ManageBots permission. Human-only.

Retrieve all attachments owned by the space (emojis and stickers, where message_id IS NULL).

Retrieve total storage bytes used by the space.

Delete one of the space's own attachments (the images of its emojis and stickers, the ones its attachment list shows), and the emojis and stickers made from it, which get SPACE_EMOJI_DELETE and SPACE_STICKER_DELETE. Human-only. Requires ManageSpaceAttachments.

Delete all attachments in a space, and its emojis and stickers with them (SPACE_EMOJI_DELETE, SPACE_STICKER_DELETE). Human-only.

List all S3-compatible storage buckets configured for a space.

Add a new S3-compatible storage bucket to a space.

Update an existing storage bucket configuration.

Delete a storage bucket from a space.

Activate a storage bucket so new uploads go to it.

Deactivate a storage bucket. Existing files remain accessible but new uploads will not use it.