Get a role by ID

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

role_idstringRequired

Successful Response

idstringformat: "uuid"

UUID role ID

created_atdatetime

UTC datetime

updated_atdatetime

UTC datetime

namestring>=1 character

Role name

permissionsobject

Access permissions

statusenum

record status, 'active' by default

Allowed values:

400

Get Roles ID Request Bad Request Error

401

Get Roles ID Request Unauthorized Error

404

Get Roles ID Request Not Found Error

422

Get Roles ID Request Unprocessable Entity Error

429

Get Roles ID Request Too Many Requests Error

$	curl https://api.sandbox.monite.com/v1/roles/role_id \
>	-H "x-monite-version: 2024-05-25" \
>	-H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>	-H "Authorization: Bearer <token>"

1	{
2	"id": "id",
3	"created_at": "2024-01-15T09:30:00Z",
4	"updated_at": "2024-01-15T09:30:00Z",
5	"name": "name",
6	"permissions": {
7	"objects": [
8	{
9	"object_type": "accounting_tax_rate",
10	"actions": [
11	{
12	"action_name": "create",
13	"permission": "allowed"
14	}
15	]
16	}
17	]
18	},
19	"status": "active"
20	}

$	curl https://api.sandbox.monite.com/v1/roles/role_id \
>	-H "x-monite-version: 2024-05-25" \
>	-H "x-monite-entity-id: 9d2b4c8f-2087-4738-ba91-7359683c49a4" \
>	-H "Authorization: Bearer <token>"

1	{
2	"id": "id",
3	"created_at": "2024-01-15T09:30:00Z",
4	"updated_at": "2024-01-15T09:30:00Z",
5	"name": "name",
6	"permissions": {
7	"objects": [
8	{
9	"object_type": "accounting_tax_rate",
10	"actions": [
11	{
12	"action_name": "create",
13	"permission": "allowed"
14	}
15	]
16	}
17	]
18	},
19	"status": "active"
20	}