Update user list

Update user list

Permission Required: lists:write

PATCH /v2/access/users/lists/:listId

Update user list

cURL

curl --request PATCH \
  --url https://api.ofauth.com/v2/access/users/lists/:listId \
  --header 'Content-Type: application/json' \
  --header 'apiKey: <api-key>' \
  --header 'x-connection-id: <api-key>' \
  --data '
{
  "name": "<string>"
}
'

200

{
  "id": "<string>",
  "type": "<string>",
  "name": "<string>",
  "sortList": [
    {
      "order": "<string>",
      "direction": "<string>"
    }
  ],
  "users": [
    {
      "id": 123,
      "username": "<string>",
      "name": "<string>",
      "isVerified": true,
      "avatar": "<string>",
      "avatarThumbs": {
        "c50": "<string>",
        "c144": "<string>"
      }
    }
  ],
  "usersCount": 123,
  "postsCount": 123,
  "order": "<string>",
  "direction": "<string>",
  "canUpdate": true,
  "canDelete": true,
  "canManageUsers": true,
  "canAddUsers": true,
  "canPinnedToFeed": true,
  "isPinnedToFeed": true,
  "canPinnedToChat": true,
  "isPinnedToChat": true
}

Authorizations

apiKey · string · header · required

Your OFAuth API key for authenticating requests.

x-connection-id · string · header · required

Requires a connection via the x-connection-id header.

Path Parameters

listId · string · required

Body

application/json

name · string · required

New name for the user list

Required string length: 1 - 100

Response

200

application/json

Successful response

id · string number · required

type · string · required

name · string · required

sortList · object[] · required

Show child attributes

users · object[] · required

Show child attributes

usersCount · number

postsCount · number

order · string

direction · string

canUpdate · boolean

canDelete · boolean

canManageUsers · boolean

canAddUsers · boolean

canPinnedToFeed · boolean

isPinnedToFeed · boolean

canPinnedToChat · boolean

isPinnedToChat · boolean