List User Roles

GET

https://api.synup.com/api/v4/roles

This API retrieves a list of all available user roles in the system.

It includes:

Role names (e.g., Admin, Manager, Viewer)

Permissions associated with each role

Role IDs for assignment and management

Request

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.synup.com/api/v4/roles' \
--header 'Authorization: API T9V35W3xxxxxxxxxxx'

Responses

🟢200OK

application/json

Successfully retrieved user roles

Body

Example

{
    "data": {
        "fetchAccountRoles": [
            {
                "id": "Q3VzdG9tUm9sZToxODE3NzY=",
                "name": "Approval",
                "createdAt": "2025-01-21 19:05:43 UTC",
                "updatedAt": "2025-01-21 19:07:13 UTC"
            },
            {
                "id": "Q3VzdG9tUm9sZTo0NDUyMg==",
                "name": "Admin",
                "createdAt": "2020-02-12 07:27:46 UTC",
                "updatedAt": "2025-01-22 15:24:13 UTC"
            },
            {
                "id": "Q3VzdG9tUm9sZTo0NTI5MQ==",
                "name": "Corporate Role",
                "createdAt": "2020-02-12 07:28:05 UTC",
                "updatedAt": "2025-01-15 06:16:29 UTC"
            }
        ],
        "pagination": {
            "$ref": "#/components/schemas/Pagination"
        }
    }
}

🟠401Unauthorized

🟠403Forbidden

Modified at 2025-07-21 09:51:44

Add User and folder

Add folders to user