⚙️
API Reference
  • Introduction
  • Features
  • Roadmaps & Requests
  • Frequently Asked Questions
  • Release notes
  • 💡START HERE
    • Terminology
    • Identity and Access Management (IAM)
      • Overview
      • Users in IAM
      • Policies in IAM
      • Roles in IAM
      • Security best practices
    • Dynamic Objects
      • Object Definition
      • Field Definition
      • Data Validation
      • Data Security
        • Encryption
      • Version Control
      • Audit Logs
    • System Architecture Diagram
    • How-To Guides
      • Clinic Project
  • 🔌CORE API Reference
    • Overview
    • Auth
    • Projects
    • Organization
    • Users
    • Roles
    • Policies
    • Objects
    • Item
    • Files
    • Notifications
    • API Request History
    • Auto-Documentation
    • Branches & Merging
    • API Performance
  • ☁️[Coming SOON] YOUR ACCELERATOR PLATFORM ACCOUNT
    • Help and Support
    • Account Page
    • Billing
    • Upgrading an Instance
    • Adjust Server Performance
    • Custom Domain
    • Change Server Region
    • Manage Team
    • API Rate Limit
    • Developer API
  • 🔓SECURITY AND COMPLIANCE
    • Best Practices
    • SOC 2 Type 2 & SOC 3
    • GDPR
    • HIPAA
    • ISO 27001:2013
    • ISO 9001:2015
    • Penetration Testing
  • Accelerator Platform - Core APIs
  • Identity and Access Management
Powered by GitBook
On this page
  1. CORE API Reference

Roles

"Roles" refer to a feature that enables the management and control of user roles and permissions within an application. Roles define different levels of access and permissions, ensuring users only have access to relevant functionality and data. Administrators can create and define roles based on application requirements, associating them with specific permissions. This role-based access control allows for granular control over user actions and data access. The Roles feature in our Accelerator product provides a scalable solution for secure and controlled access to application functionality and data based on user roles.

Roles Data Model

Name
Data
Description

_id

String

System-generated unique identifier assigned to each role.

_createdAt

Date

System-generated timestamp that denotes the date and time when a role was created.

_createdBy

String

System-generated field that indicates the account who created.

_modifiedAt

Date

System-generated generated timestamp that denotes the date and time when a role was modified.

_modifiedBy

String

System-generated field that indicates the account who modified.

org

String

Represents the organization associated with the role in the system.

name

String

Represents the name of the role in the system.

label

String

Represents the label of the role in the system.

description

String

Represents the description of the role in the system.

status

String

Represents the status of the role in the system.

policies

Array

Represents the list of policies attached to the role in the system.

Example Roles

{
    "_id":
        {
            "$oid":"64392c4f862be321e3598f65"
        },
    "_createdAt":
        {
            "$date":
                {
                    "$numberLong":"1681468495815"
                }
        },
    "_createdBy":"john@email.com",
    "_modifiedAt":
        {
            "$date":
                {
                    "$numberLong":"1687865984008"
                }
        },
    "_modifiedBy":"john@email.com",
    "org":"64392b37862be321e3598f58",
    "name":"Provider",
    "label":"Providers215",
    "description":"",
    "status":"active",
    "policies":["64392c1d862be321e3598f63"]
}
PreviousUsersNextPolicies

Last updated 1 year ago

🔌

Get all Roles

get
Authorizations
Responses
200
Success
401
Unauthorized
403
Forbidden
get
GET //api/v1/GetRoles HTTP/1.1
Host: api-qa.accelerator-platform.com
Authorization: YOUR_API_KEY
Accept: */*

No content

Get a Role

get
Authorizations
Path parameters
idstringRequired
Responses
200
Success
401
Unauthorized
403
Forbidden
get
GET //api/v1/GetRole/{id} HTTP/1.1
Host: api-qa.accelerator-platform.com
Authorization: YOUR_API_KEY
Accept: */*

No content

  • Roles Data Model
  • Example Roles
  • POSTCreate a Role
  • GETGet all Roles
  • GETGet a Role

Create a Role

post

Sample request:

POST api/v1/CreateRole
{        
  "name": "Patient",
  "policies": ["policyId"],
}
Authorizations
Body
namestringRequiredPattern: ^[a-zA-Z0-9_]*$
policiesstring[] | nullableOptional
Responses
200
Success
401
Unauthorized
403
Forbidden
post
POST //api/v1/CreateRole HTTP/1.1
Host: api-qa.accelerator-platform.com
Authorization: YOUR_API_KEY
Content-Type: application/json-patch+json
Accept: */*
Content-Length: 35

{
  "name": "text",
  "policies": [
    "text"
  ]
}

No content