Edit Category
This route requires a valid Authorization header.
PATCH/spheres/<sphere_id>/categories/<category_id>
Edit a category.
The default category cannot be edited.
Name must be less than or equal to 32 characters long if provided.
Position must be greater than or equal to 1. It is automatically upper-bounded to the number of channels in the category.
Path Params
| Name | Type |
|---|---|
| sphere_id | Number |
| category_id | Number |
Request Body
| Field | Type | Description |
|---|---|---|
| name | String? | The name of this category. |
| position | Number? |
Response
200Category
| Field | Type | Description |
|---|---|---|
| id | Number | The ID of this category. |
| name | String | The name of this category. |
| position | Number | This category’s position inside of its sphere. |
| channels | Array of SphereChannels | The channels that belong to this category. |
Example
curl --request PATCH \
-H "Authorization: <token>" \
--json '{"name":"Bean","position":42}' \
https://api.eludris.gay/spheres/1234/categories/5678