API reference
Roles
Roles and permissions. Permissions are a 64-bit set sent as a decimal string, since JavaScript numbers cannot hold 64 bits. Bits: 1 View Channel, 2 Send Messages, 4 Read Message History, 8 Manage Messages, 16 Manage Channels, 32 Manage Roles, 64 Manage Community, 128 Create Invites, 256 Kick Members, 512 Change Nickname, 1024 Manage Nicknames, 2048 Administrator, 4096 Ban Members, 8192 Moderate Members, 16384 Mention Everyone, 131072 Manage Webhooks, 262144 Use Commands, 524288 View Audit Log, 1048576 Attach Files (on @everyone by default, as on Discord), 2097152 Manage Threads, 4194304 Create Public Threads, 8388608 Create Private Threads, 16777216 Send Messages in Threads (the three thread creation and sending bits are on @everyone by default, as on Discord). Voice: 32768 Connect, 65536 Speak, 33554432 Video (camera and screen share), 67108864 Mute Members, 134217728 Deafen Members, 268435456 Move Members, 536870912 Use Voice Activity, 1073741824 Priority Speaker (Connect, Speak, Video and Use Voice Activity are on @everyone by default). 2147483648 Add Reactions, 34359738368 Manage Expressions (server stickers; needs a second factor where the server requires one for moderation). Other bits are reserved and rejected with invalid_permissions. Every community has an @everyone role whose ID is the community ID. Managing a role or member needs it to be below the caller's highest role; the owner is above everyone and has every permission.
Every path is relative to https://api.palloo.app/v1.
Send a bot token as Authorization: Bearer palloo_bot_... unless the operation says otherwise; see Authentication.
Try it
Send real requests to https://api.palloo.app/v1 from this page. Open Try it under an operation, fill in its fields and send it.
A bot token is a password.
Anyone who has it can act as your bot. Use a test bot in a test server, never a production bot. The token stays in this tab's memory only: it is not saved, and it goes to the API and nowhere else. Reloading or leaving the page forgets it.
Starts with palloo_bot_. People's tokens are refused here.
On this page
Add member role
/communities/{id}/members/{userID}/roles/{roleID}
Bot token: Call it with a bot token (people can call it too).
Give a member a role. Requires Manage Roles; the role must be below the caller's highest role and must not hold a permission the caller lacks, and the member, unless it is the caller, must be below the caller's highest role. The role must also not give the member, in any channel, a permission or access to a channel that the caller lacks there (through the role's channel overwrites); otherwise missing_permission. Giving a role the member already has changes nothing.
Required permissions
Requires Manage Roles; the role must be below the caller's highest role and must not hold a permission the caller lacks, and the member, unless it is the caller, must be below the caller's highest role.
Try it: PUT /communities/{id}/members/{userID}/roles/{roleID}
Sends the bot token from the top of this page.
Request
PUT https://api.palloo.app/v1/communities/{id}/members/{userID}/roles/{roleID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
| userID Required | path | string |
The member's user ID. |
| roleID Required | path | string |
Role ID. The |
Responses
- 204
-
The member has the role. A change is sent as
member_update. - 400
-
everyone_role: the@everyonerole cannot be deleted, moved, renamed, styled or assigned, ormanaged_role: a bot's managed role cannot be deleted, assigned or removed.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
community_not_found,role_not_foundormember_not_found.Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Remove member role
/communities/{id}/members/{userID}/roles/{roleID}
Bot token: Call it with a bot token (people can call it too).
Take a role from a member. Requires Manage Roles; the role must be below the caller's highest role and the member, unless it is the caller, must be below the caller's highest role. Removing a role the member does not have changes nothing.
Required permissions
Requires Manage Roles; the role must be below the caller's highest role and the member, unless it is the caller, must be below the caller's highest role.
Try it: DELETE /communities/{id}/members/{userID}/roles/{roleID}
Sends the bot token from the top of this page.
Request
DELETE https://api.palloo.app/v1/communities/{id}/members/{userID}/roles/{roleID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
| userID Required | path | string |
The member's user ID. |
| roleID Required | path | string |
Role ID. The |
Responses
- 204
-
The member does not have the role. A change is sent as
member_update. - 400
-
everyone_role: the@everyonerole cannot be deleted, moved, renamed, styled or assigned, ormanaged_role: a bot's managed role cannot be deleted, assigned or removed.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
community_not_found,role_not_foundormember_not_found.Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
List roles
/communities/{id}/roles
Bot token: Call it with a bot token (people can call it too).
The community's roles, lowest position first (@everyone first). Members only.
Try it: GET /communities/{id}/roles
Sends the bot token from the top of this page.
Request
GET https://api.palloo.app/v1/communities/{id}/roles
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
Responses
- 200
-
The roles.
Body: RoleList
Example response (200) { "roles": [ { "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "community_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "name": "string", "color": 0, "position": 0, "permissions": "2748678791", "hoist": false, "mentionable": false, "managed": false, "bot_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A" } ] } - 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 404
-
community_not_found: no such community, or the caller is not a member. The two cases are indistinguishable on purpose.Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Create role
/communities/{id}/roles
Bot token: Call it with a bot token (people can call it too).
Create a role at position 1, just above @everyone; every other role moves up by one. Requires Manage Roles, and the role cannot hold a permission the caller lacks.
Required permissions
Requires Manage Roles, and the role cannot hold a permission the caller lacks.
Try it: POST /communities/{id}/roles
Sends the bot token from the top of this page.
Prefilled from the example above. Replace the placeholder values; unknown fields are refused.
Request
POST https://api.palloo.app/v1/communities/{id}/roles
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
Request body
application/json:
CreateRoleRequest
(required)
| Field | Type | Description |
|---|---|---|
| nameRequired | string | Trimmed, then 1 to 100 characters with no control or invisible formatting characters. Emoji are allowed. At most 4 combining marks may sit on one character, a zero-width joiner is only accepted inside an emoji sequence or between letters of a script that uses joiners, a variation selector only where it changes how its character is drawn, tag characters only in the England, Scotland and Wales flags, and line and paragraph separators, private use and unassigned characters are refused; the name needs one visible character. Names that fold to |
| color | integer or null | at least 0; at most 16777215 |
| permissions | Permissions | A 64-bit permission set as a decimal string. See the |
| hoist | boolean | default false |
| mentionable | boolean | default false |
{
"name": "string",
"color": 0,
"permissions": "2748678791",
"hoist": false,
"mentionable": false
}
Responses
- 201
-
Created. Sent to members as
role_create, followed byrole_positions.Body: Role
Example response (201) { "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "community_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "name": "string", "color": 0, "position": 0, "permissions": "2748678791", "hoist": false, "mentionable": false, "managed": false, "bot_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A" } - 400
-
invalid_body,invalid_name,invalid_colororinvalid_permissions.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller is a member but lacks the permission.Body: Error
- 404
-
community_not_found: no such community, or the caller is not a member. The two cases are indistinguishable on purpose.Body: Error
- 409
-
role_limit_reached: the community has 250 roles besides@everyone.Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Reorder roles
/communities/{id}/roles
Bot token: Call it with a bot token (people can call it too).
Move several roles at once. Listed roles take the given positions; the others keep their order and fill the remaining positions. Requires Manage Roles, and every role whose position changes must be below the caller's highest role before and after.
Required permissions
Requires Manage Roles, and every role whose position changes must be below the caller's highest role before and after.
Try it: PATCH /communities/{id}/roles
Sends the bot token from the top of this page.
Prefilled from the example above. Replace the placeholder values; unknown fields are refused.
Request
PATCH https://api.palloo.app/v1/communities/{id}/roles
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
Request body
application/json:
ReorderRolesRequest
(required)
| Field | Type | Description |
|---|---|---|
| rolesRequired | array of object | at least 1 items |
| roles[].idRequired | ID | |
| roles[].positionRequired | integer | Distinct, from 1 to the number of roles other than at least 1 |
{
"roles": [
{
"id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A",
"position": 1
}
]
}
Responses
- 200
-
Every role, in the new order. A change is sent as
role_positions.Body: RoleList
Example response (200) { "roles": [ { "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "community_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "name": "string", "color": 0, "position": 0, "permissions": "2748678791", "hoist": false, "mentionable": false, "managed": false, "bot_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A" } ] } - 400
-
invalid_body,invalid_positionsoreveryone_role.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
community_not_found(no such community, or the caller is not a member) orrole_not_found(no such role in this community).Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Update role
/communities/{id}/roles/{roleID}
Bot token: Call it with a bot token (people can call it too).
Change a role. Omitted fields keep their value. Requires Manage Roles and the role must be below the caller's highest role; added permissions must be ones the caller has. Only permissions can change on @everyone.
Required permissions
Requires Manage Roles and the role must be below the caller's highest role; added permissions must be ones the caller has.
Try it: PATCH /communities/{id}/roles/{roleID}
Sends the bot token from the top of this page.
Prefilled from the example above. Replace the placeholder values; unknown fields are refused.
Request
PATCH https://api.palloo.app/v1/communities/{id}/roles/{roleID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
| roleID Required | path | string |
Role ID. The |
Request body
application/json:
UpdateRoleRequest
(required)
| Field | Type | Description |
|---|---|---|
| name | string | Same rules as when creating. |
| color | integer or null | Null removes the color. at least 0; at most 16777215 |
| permissions | Permissions | |
| hoist | boolean | |
| mentionable | boolean |
{
"name": "string",
"color": 0,
"permissions": "2748678791",
"hoist": false,
"mentionable": false
}
Responses
- 200
-
The updated role. Also sent to members as
role_update.Body: Role
Example response (200) { "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "community_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "name": "string", "color": 0, "position": 0, "permissions": "2748678791", "hoist": false, "mentionable": false, "managed": false, "bot_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A" } - 400
-
invalid_body,invalid_name,invalid_color,invalid_permissionsoreveryone_role.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
community_not_found(no such community, or the caller is not a member) orrole_not_found(no such role in this community).Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Delete role
/communities/{id}/roles/{roleID}
Bot token: Call it with a bot token (people can call it too).
Delete a role; members lose it and its channel overwrites go with it. Roles above move down by one. Requires Manage Roles and the role must be below the caller's highest role.
Required permissions
Requires Manage Roles and the role must be below the caller's highest role.
Try it: DELETE /communities/{id}/roles/{roleID}
Sends the bot token from the top of this page.
Request
DELETE https://api.palloo.app/v1/communities/{id}/roles/{roleID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Community ID. |
| roleID Required | path | string |
Role ID. The |
Responses
- 204
-
Deleted. Sent as
role_delete, thenrole_positionsif roles moved. - 400
-
everyone_role: the@everyonerole cannot be deleted, moved, renamed, styled or assigned, ormanaged_role: a bot's managed role cannot be deleted, assigned or removed.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
community_not_found(no such community, or the caller is not a member) orrole_not_found(no such role in this community).Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Put role overwrite
/channels/{id}/overwrites/roles/{roleID}
Bot token: Call it with a bot token (people can call it too).
Set a role's permission overwrite in a channel (the role ID may be the community ID for @everyone). Requires Manage Roles in the channel, the role must be below the caller's highest role, and every bit that changes must be one the caller has in the channel. A channel can have at most 100 overwrites.
Required permissions
Requires Manage Roles in the channel, the role must be below the caller's highest role, and every bit that changes must be one the caller has in the channel.
Try it: PUT /channels/{id}/overwrites/roles/{roleID}
Sends the bot token from the top of this page.
Prefilled from the example above. Replace the placeholder values; unknown fields are refused.
Request
PUT https://api.palloo.app/v1/channels/{id}/overwrites/roles/{roleID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Channel ID. |
| roleID Required | path | string |
Role ID. The |
Request body
application/json:
OverwriteRequest
(required)
| Field | Type | Description |
|---|---|---|
| allow | Permissions | A 64-bit permission set as a decimal string. See the |
| deny | Permissions | A 64-bit permission set as a decimal string. See the |
{
"allow": "2748678791",
"deny": "2748678791"
}
Responses
- 200
-
The channel with its overwrites. Also sent to members as
channel_update.Body: Channel
Example response (200) { "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "community_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "name": "string", "kind": "text", "position": 0, "parent_id": "string", "topic": "string", "created_at": "2026-10-15T09:00:00Z", "overwrites": [ { "type": "role", "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "allow": "2748678791", "deny": "2748678791" } ], "owner_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "message_count": 0, "member_count": 0, "thread_metadata": { "archived": false, "auto_archive_duration": 60, "archive_timestamp": "2026-10-15T09:00:00Z", "locked": false, "invitable": false, "create_timestamp": "2026-10-15T09:00:00Z" }, "user_limit": 0, "bitrate": 8000, "age_restricted": false } - 400
-
invalid_bodyorinvalid_permissions.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
channel_not_found(no such channel, or the caller cannot view it) orrole_not_found(no such role in the channel's community).Body: Error
- 409
-
overwrite_limit_reached: the channel has 100 overwrites; change or remove one first.Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Delete role overwrite
/channels/{id}/overwrites/roles/{roleID}
Bot token: Call it with a bot token (people can call it too).
Remove a role's overwrite from a channel. Same rules as setting it; removing one that does not exist changes nothing.
Try it: DELETE /channels/{id}/overwrites/roles/{roleID}
Sends the bot token from the top of this page.
Request
DELETE https://api.palloo.app/v1/channels/{id}/overwrites/roles/{roleID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Channel ID. |
| roleID Required | path | string |
Role ID. The |
Responses
- 204
-
Removed. A change is sent as
channel_update. - 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
channel_not_found(no such channel, or the caller cannot view it) orrole_not_found(no such role in the channel's community).Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Put member overwrite
/channels/{id}/overwrites/members/{userID}
Bot token: Call it with a bot token (people can call it too).
Set a member's permission overwrite in a channel. Requires Manage Roles in the channel, the member must be below the caller's highest role, and every bit that changes must be one the caller has in the channel. The overwrite is removed when the member leaves. A channel can have at most 100 overwrites.
Required permissions
Requires Manage Roles in the channel, the member must be below the caller's highest role, and every bit that changes must be one the caller has in the channel.
Try it: PUT /channels/{id}/overwrites/members/{userID}
Sends the bot token from the top of this page.
Prefilled from the example above. Replace the placeholder values; unknown fields are refused.
Request
PUT https://api.palloo.app/v1/channels/{id}/overwrites/members/{userID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Channel ID. |
| userID Required | path | string |
The member's user ID. |
Request body
application/json:
OverwriteRequest
(required)
| Field | Type | Description |
|---|---|---|
| allow | Permissions | A 64-bit permission set as a decimal string. See the |
| deny | Permissions | A 64-bit permission set as a decimal string. See the |
{
"allow": "2748678791",
"deny": "2748678791"
}
Responses
- 200
-
The channel with its overwrites. Also sent to members as
channel_update.Body: Channel
Example response (200) { "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "community_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "name": "string", "kind": "text", "position": 0, "parent_id": "string", "topic": "string", "created_at": "2026-10-15T09:00:00Z", "overwrites": [ { "type": "role", "id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "allow": "2748678791", "deny": "2748678791" } ], "owner_id": "01J9ZQ3V5K8M2N4P6R8T0W2Y4A", "message_count": 0, "member_count": 0, "thread_metadata": { "archived": false, "auto_archive_duration": 60, "archive_timestamp": "2026-10-15T09:00:00Z", "locked": false, "invitable": false, "create_timestamp": "2026-10-15T09:00:00Z" }, "user_limit": 0, "bitrate": 8000, "age_restricted": false } - 400
-
invalid_bodyorinvalid_permissions.Body: Error
- 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
channel_not_found(no such channel, or the caller cannot view it) ormember_not_found(the target is not a member of the channel's community).Body: Error
- 409
-
overwrite_limit_reached: the channel has 100 overwrites; change or remove one first.Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error
Delete member overwrite
/channels/{id}/overwrites/members/{userID}
Bot token: Call it with a bot token (people can call it too).
Remove a member's overwrite from a channel. Same rules as setting it; removing one that does not exist changes nothing.
Try it: DELETE /channels/{id}/overwrites/members/{userID}
Sends the bot token from the top of this page.
Request
DELETE https://api.palloo.app/v1/channels/{id}/overwrites/members/{userID}
curl command
Response
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| id Required | path | string |
Channel ID. |
| userID Required | path | string |
The member's user ID. |
Responses
- 204
-
Removed. A change is sent as
channel_update. - 401
-
unauthenticated: the bearer token is missing, invalid or expired.Body: Error
WWW-Authenticateheader. - 403
-
missing_permission: the caller lacks the permission, or would grant one it lacks, orrole_hierarchy: the target role or member is not below the caller's highest role.Body: Error
- 404
-
channel_not_found(no such channel, or the caller cannot view it) ormember_not_found(the target is not a member of the channel's community).Body: Error
- 429
-
rate_limited: too many attempts. Every operation a bot calls is also limited per bot (50 at once, then 50 per second), so any authenticated operation can answer this to a bot. Changes to a community's structure (creating or changing the community, channels, roles, member roles, overwrites, invites, kicks, bans, timeouts, report updates and actions, and bots) are also limited per caller (30 at once, then 1 per second) and per community (60 at once, then 1 per second), and creating communities per caller (10 at once, then 1 every 5 minutes).Body: Error
Retry-Afterheader. - 500
-
internal: an unexpected server error. Details are only in server logs.Body: Error