Read a community by slug
GET
/categories/slugs/{slug}
const url = 'https://feed.work.optidata.cloud/api/categories/slugs/announcements';const options = {method: 'GET', 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 GET \ --url https://feed.work.optidata.cloud/api/categories/slugs/announcements \ --header 'Authorization: Bearer <token>'A single community by its slug.
Authorizations
Section titled “Authorizations”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters”slug
required
string
Slug of the community.
Responses
Section titled “ Responses ”The community.
Media typeapplication/json
A community (shared space) for posts.
object
id
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
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
Exampleexample
{ "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": null, "emoji": "📣", "cover_url": null, "color": "#863bff", "visibility": "public", "group_id": null}No authentication key was sent.
Media typeapplication/json
Authentication failures use an error key.
object
error
required
string
Examples
Exampleexample
{ "error": "JWT passport exception: Missing bearer token in request"}No matching resource, or it is not reachable through this path.
Media typeapplication/json
object
message
required
string
Examples
Exampleexample
{ "message": "No query results for model [App\\Models\\Category] 864"}The authentication key is expired or not recognised. Get a fresh one and retry.
Media typeapplication/json
Authentication failures use an error key.
object
error
required
string
Examples
Exampleexample
{ "error": "JWT passport expired: Passport expired"}