Skip to content
Optiwork API Docs

List a community's per-user permissions (legacy)

GET
/categories/{category}/permissions/users
curl --request GET \
  --url https://feed.work.optidata.cloud/api/categories/864/permissions/users \
  --header 'Authorization: Bearer <token>'

A per-user view of a community’s permissions, kept for older mobile builds. New integrations should use listCommunityMembers. Returns only what the caller is allowed to see.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters”
category
required
integer

Numeric id of the community.

Responses

Section titled “ Responses ”

200

Section titled “200”

Per-user permissions.

Media typeapplication/json
Array<object>

A per-user permission row (legacy view).

object
id
required
integer
category_id
required
integer
user_id
required
integer
actions
required

What a member may do in a community.

string
Allowed values: none view interact edit manage
user

A light user record for pickers.

object
id
required
integer
name
string | null
uuid
required
string format: uuid
email
string | null
avatar_url
string | null
created_at
string format: date-time
updated_at
string format: date-time
Examples
Exampleexample
[
  {
    "id": 2958,
    "category_id": 864,
    "user_id": 38,
    "actions": "manage",
    "created_at": "2026-10-19T14:38:00.000000Z",
    "updated_at": "2026-10-19T14:38:00.000000Z",
    "user": {
      "id": 38,
      "uuid": "9ba64b0e-69b4-4639-a01b-4ac5c5f70a24",
      "name": "Ana Souza",
      "email": "ana.souza@example.com",
      "avatar_url": "https://media.optidata.cloud/avatars/ana.webp"
    }
  }
]

401

Section titled “401”

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"
}

404

Section titled “404”

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"
}

419

Section titled “419”

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"
}