Delete a community

DELETE

/categories/{category}

const url = 'https://feed.work.optidata.cloud/api/categories/864';
const options = {method: 'DELETE', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request DELETE \
  --url https://feed.work.optidata.cloud/api/categories/864 \
  --header 'Authorization: Bearer <token>'

Moves a community to the trash. Allowed to administrators and, on a private community, to people with the manage permission; group-linked communities cannot be deleted here.

Authorizations

bearerAuth

Parameters

Path Parameters

category

required

integer

Numeric id of the community.

Responses

200

The trashed community.

application/json

A community (shared space) for posts.

object

required

integer

cuid

string

name

required

string

slug

required

string

description

string | null

emoji

string | null

cover_url

string | null

color

Hex colour, or null.

string | null

visibility

required

public — everyone in the company; private — only the people and groups it is shared with.

string

Allowed values: public private

group_id

Set when the community mirrors an Optiwork group; such communities are managed through the group, not here.

integer | null

created_at

string format: date-time

updated_at

string format: date-time

deleted_at

string | null format: date-time

pivot

Present when the community is returned as a pinned community.

object

key

additional properties

any

Examples

example

{
  "id": 864,
  "cuid": "7f3c2a10-5b8e-4d21-9c6a-0e4f1b2d3c4a",
  "name": "Announcements",
  "slug": "announcements",
  "description": "Company-wide announcements.",
  "created_at": "2026-09-02T12:10:14.000000Z",
  "updated_at": "2026-09-02T12:10:14.000000Z",
  "deleted_at": "2026-10-19T14:42:01.000000Z",
  "emoji": "📣",
  "cover_url": null,
  "color": "#863bff",
  "visibility": "public",
  "group_id": null
}

401

No authentication key was sent.

application/json

Authentication failures use an error key.

object

error

required

string

Examples

example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The caller is not allowed to perform this action.

application/json

object

message

required

string

Examples

example

{
  "message": "This action is unauthorized."
}

404

No matching resource, or it is not reachable through this path.

application/json

object

message

required

string

Examples

example

{
  "message": "No query results for model [App\\Models\\Category] 864"
}

419

The authentication key is expired or not recognised. Get a fresh one and retry.

application/json

Authentication failures use an error key.

object

error

required

string

Examples

example

{
  "error": "JWT passport expired: Passport expired"
}