Access Control

Access Control APIs

API specs to map actions to roles.

Get the list of actions based on either roles or features.

post

Get the list of actions based on the input parameters.

Query parameters

rolesstring[]Optional

The list of role codes.

featuresinteger[]Optional

The list of feature id's.

Body

apiIdstringRequired

unique API ID

verstringRequired

API version

tsstringRequired

response timestamp YYYY-MM-DDThh:mm:ss+/-nn:nn (timezone defaulted to +5.30)

actionstringOptional

api action like GET/POST/PUT/DELETE in case of http calls

didstringOptional

device UUID from which API is called

keystringOptional

API key (dynamic)

msgIdstringOptional

unique request message id, UUID, for handling API idempotency

requesterIdstringOptional

UserId of the user calling

authTokenstringOptional

//session/jwt/saml token/oauth token

Responses

200

Successful response

*/*

400

Invalid input.

*/*

post

HTTPcURLJavaScriptPython

POST /v1/actions/_search HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 138

{
  "apiId": "text",
  "ver": "text",
  "ts": "text",
  "action": "text",
  "did": "text",
  "key": "text",
  "msgId": "text",
  "requesterId": "text",
  "authToken": "text"
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "actions": [
    {
      "id": 1,
      "name": "text",
      "queryParams": "text",
      "url": "text",
      "parentModule": 1,
      "orderNumber": 1,
      "displayName": "text",
      "enabled": true,
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06",
      "tenantId": "text",
      "serviceCode": 1
    }
  ]
}

Create a new action.

post

To create new action(s) in the system. An action entry is required for each and every path to authenticate the access based on the assigned role of an user.

Body

actionMasterstringOptional

action master

enabledbooleanOptional

if enabled or not

featureIdsinteger[]Optional

unique id for feature

leftIconstringOptional

left icon

navigationURLstringOptional

url for navigating

rightIconstringOptional

right icon

roleCodesstring[]Optional

codes specifying role

tenantIdstringOptional

Unique Identifier of the tenant, Like AP, AP.Kurnool etc.

Responses

200

Action(s) created sucessfully

*/*

400

Action(s) creation failed

*/*

post

HTTPcURLJavaScriptPython

POST /v1/actions/_create HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 1019

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  },
  "actions": [
    {
      "id": 1,
      "name": "text",
      "queryParams": "text",
      "url": "text",
      "parentModule": 1,
      "orderNumber": 1,
      "displayName": "text",
      "enabled": true,
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06",
      "tenantId": "text",
      "serviceCode": 1
    }
  ],
  "actionMaster": "text",
  "enabled": true,
  "featureIds": [
    1
  ],
  "leftIcon": "text",
  "navigationURL": "text",
  "rightIcon": "text",
  "roleCodes": [
    "text"
  ],
  "tenantId": "text"
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "actions": [
    {
      "id": 1,
      "name": "text",
      "queryParams": "text",
      "url": "text",
      "parentModule": 1,
      "orderNumber": 1,
      "displayName": "text",
      "enabled": true,
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06",
      "tenantId": "text",
      "serviceCode": 1
    }
  ]
}

Update existing action(s).

put

To update the existing action(s) in the system.

Body

actionMasterstringOptional

action master

enabledbooleanOptional

if enabled or not

featureIdsinteger[]Optional

unique id for feature

leftIconstringOptional

left icon

navigationURLstringOptional

url for navigating

rightIconstringOptional

right icon

roleCodesstring[]Optional

codes specifying role

tenantIdstringOptional

Unique Identifier of the tenant, Like AP, AP.Kurnool etc.

Responses

200

Update action(s) successful

*/*

400

Update action(s) failed

*/*

put

HTTPcURLJavaScriptPython

PUT /v1/actions/_update HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 1019

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  },
  "actions": [
    {
      "id": 1,
      "name": "text",
      "queryParams": "text",
      "url": "text",
      "parentModule": 1,
      "orderNumber": 1,
      "displayName": "text",
      "enabled": true,
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06",
      "tenantId": "text",
      "serviceCode": 1
    }
  ],
  "actionMaster": "text",
  "enabled": true,
  "featureIds": [
    1
  ],
  "leftIcon": "text",
  "navigationURL": "text",
  "rightIcon": "text",
  "roleCodes": [
    "text"
  ],
  "tenantId": "text"
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "actions": [
    {
      "id": 1,
      "name": "text",
      "queryParams": "text",
      "url": "text",
      "parentModule": 1,
      "orderNumber": 1,
      "displayName": "text",
      "enabled": true,
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06",
      "tenantId": "text",
      "serviceCode": 1
    }
  ]
}

Validate a particular action for a given tenant and roles of the tenant

post

Validate a particular action for a given tenant and roles of the tenant.

Body

Responses

200

Successful response without any content

*/*

400

Invalid input.

*/*

post

HTTPcURLJavaScriptPython

POST /v1/actions/_validate HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 833

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  },
  "validateAction": {
    "tenantRole": {
      "tenantId": "text",
      "roles": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ]
    },
    "actionUrl": "text"
  }
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": "text",
    "resMsgId": "text",
    "msgId": "text",
    "status": "text"
  },
  "actionValidation": {
    "allowed": true
  }
}

Create mapping for feature and role.

post

Create mapping for feature and role.

Body

roleIdstringRequired

List of Role Id to be provided for mapping it to feature.

tenantIdstringRequired

Unique Identifier of the tenant, Like AP, AP.Kurnool etc.

Responses

200

Successful response

*/*

400

Invalid input.

*/*

post

HTTPcURLJavaScriptPython

POST /v1/feature-role/_create HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 285

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": "text",
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text"
  },
  "roleId": "text",
  "feature": {
    "id": 1,
    "code": 1,
    "name": "text",
    "description": "text",
    "serviceCode": 1,
    "tenantId": "text"
  },
  "tenantId": "text"
}

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": "text",
    "resMsgId": "text",
    "msgId": "text",
    "status": "text"
  },
  "role": {
    "id": 1,
    "name": "text"
  },
  "feature": {
    "id": 1,
    "code": 1,
    "name": "text",
    "description": "text",
    "serviceCode": 1,
    "tenantId": "text"
  }
}

Get the list of roles based on role codes.

post

Get the list of roles based on role codes in the input parameters.

Query parameters

codestring[]Optional

The list of comma separated codes to filter Roles against. No providing any would end up in all Roles as there is nothing to filter against

Body

Responses

200

Successful response

*/*

400

Invalid input.

*/*

post

HTTPcURLJavaScriptPython

POST /v1/roles/_search HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 602

{
  "RequestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  }
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "roles": [
    {
      "name": "text",
      "description": "text",
      "id": 1,
      "code": "text",
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06"
    }
  ]
}

Create a new role.

post

To create new Role(s) in the system.

Body

Responses

200

Role(s) created sucessfully

*/*

400

Role(s) creation failed

*/*

post

HTTPcURLJavaScriptPython

POST /v1/roles/_create HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 762

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  },
  "roles": [
    {
      "name": "text",
      "description": "text",
      "id": 1,
      "code": "text",
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06"
    }
  ]
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "roles": [
    {
      "name": "text",
      "description": "text",
      "id": 1,
      "code": "text",
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06"
    }
  ]
}

Update existing role(s).

put

To update the existing role(s) in the system.

Body

Responses

200

Update role(s) successful

*/*

400

Update role(s) failed

*/*

put

HTTPcURLJavaScriptPython

PUT /v1/roles/_update HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 762

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  },
  "roles": [
    {
      "name": "text",
      "description": "text",
      "id": 1,
      "code": "text",
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06"
    }
  ]
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "roles": [
    {
      "name": "text",
      "description": "text",
      "id": 1,
      "code": "text",
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06"
    }
  ]
}

Create mapping for role and action(s).

post

Create mapping for role and action(s).

Body

tenantIdstringRequired

Unique Identifier of the tenant, Like AP, AP.Kurnool etc.

Responses

200

Role - Action(s) mapping created sucessfully

*/*

400

Role - Action(s) mapping failed

*/*

post

HTTPcURLJavaScriptPython

POST /v1/role-actions/_create HTTP/1.1
Host: access
Content-Type: */*
Accept: */*
Content-Length: 1041

{
  "requestInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "action": "text",
    "did": "text",
    "key": "text",
    "msgId": "text",
    "requesterId": "text",
    "authToken": "text",
    "userInfo": {
      "tenantId": "text",
      "id": 1,
      "userName": "text",
      "mobile": "text",
      "email": "text",
      "primaryrole": [
        {
          "name": "text",
          "description": "text",
          "id": 1,
          "code": "text",
          "createdBy": 1,
          "createdDate": "2025-06-06",
          "lastModifiedBy": 1,
          "lastModifiedDate": "2025-06-06"
        }
      ],
      "additionalroles": [
        {
          "tenantId": "text",
          "roles": [
            {
              "name": "text",
              "description": "text",
              "id": 1,
              "code": "text",
              "createdBy": 1,
              "createdDate": "2025-06-06",
              "lastModifiedBy": 1,
              "lastModifiedDate": "2025-06-06"
            }
          ]
        }
      ]
    }
  },
  "role": {
    "name": "text",
    "description": "text",
    "id": 1,
    "code": "text",
    "createdBy": 1,
    "createdDate": "2025-06-06",
    "lastModifiedBy": 1,
    "lastModifiedDate": "2025-06-06"
  },
  "actions": [
    {
      "id": 1,
      "name": "text",
      "queryParams": "text",
      "url": "text",
      "parentModule": 1,
      "orderNumber": 1,
      "displayName": "text",
      "enabled": true,
      "createdBy": 1,
      "createdDate": "2025-06-06",
      "lastModifiedBy": 1,
      "lastModifiedDate": "2025-06-06",
      "tenantId": "text",
      "serviceCode": 1
    }
  ],
  "tenantId": "text"
}

{
  "responseInfo": {
    "apiId": "text",
    "ver": "text",
    "ts": 1,
    "resMsgId": "text",
    "msgId": "text",
    "status": "SUCCESSFUL"
  },
  "roleActions": [
    {
      "roleCode": "text",
      "actionId": 1,
      "tenantId": "text"
    }
  ]
}