Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Yoobic Roles API

Get the list of Roles available for the users in your organization. The roles are defined by a combination of `client_role` and `client_role_extension`The `client_role` refers to a YOOBIC specific role name between  ROLEFIELD, ROLEMANAGER, ROLEEDITOR, ROLESTOREMANAGER, ROLESTORE, ROLEADMIN, and ROLEVIEWER and has an impact on some default features of the platform. It also determines what license level the user is attached to.The `client_role_extension` refers to a customer-specific designation of a user role, usually based on the job or responsibility of the teams. It is used to differentiate users with the same license level but access to different modules of the platform.Each combination of client_role and `client_role_extension` is given a unique acl_role_id at creationRoles are created during the implementation of the platform and cannot be changed by an administrator either via the public API or from the admin interface.### Fields| Field | Type | Required | Readonly | OrderBy | Description ||------------------------|:--------------:|:--------:|:--------:|:-------:|---------------------------||`acl_role_id` | string | x | x | | Unique id of the role object ||`client_role` | string | x | x | | User roles: ROLEFIELD | ROLEMANAGER | ROLEEDITOR | ROLESTOREMANAGER | ROLESTORE | ROLEADMIN | ROLEVIEWER ||`client_role_extension` | string | x | x | | Additional role information ||`created_date` | date | | x | | Creation date ||`updated_date` | date | | x | x | Last update date |

Yoobic Roles API is one of 41 APIs that Yoobic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Roles. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a changelog.

This API exposes 4 operations across 4 paths, and defines 1 schema. It is described by OpenAPI 3.0.0.

Requests are made against a single base URL, https:///.

4 operations 4 paths 1 schemas 4 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
Base URL
https://api.yoobic.com/public/api
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Yoobic Roles API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow.

Paths & Operations 4

Across 4 paths, the API surfaces 4 operations — 4 GET. Each is listed below with its method, path, parameters, and response codes.

Roles 4

Get the list of Roles available for the users in your organization. The roles are defined by a combination of clientrole and clientroleextension The clientrole refers to a YOOBIC…

GET
/public/api/acl-roles/{id}
Get
Get 2 params → 200
GET
/public/api/acl-roles?filter={filter}
Get All
Get All 2 params body → 200
GET
/public/api/acl-roles/count?where={where}
Count
Count 2 params body → 200
GET
/public/api/acl-roles/export?type={type}&filter={filter}
Export
Export 3 params body → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Default_Header (1 property). Each schema is shown below with its type and property counts.

Default_Header
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yoobic-roles-api-openapi.yml Raw ↑

Other APIs Yoobic publishes across the network.

Yoobic Answers API
Yoobic Badges API
Yoobic Bot Messages API
Yoobic Bots API
Yoobic Business KPIs data - salesdata API
Yoobic Campaigns API
Yoobic Catalogs API
Yoobic Chats API
Yoobic Comments API
Yoobic Communities API
Yoobic Community Posts API
Yoobic Competencies API