Roles

Endpointhttps://app.monad.com/api

Download schema

Role management endpoints

List roles

GET

https://app.monad.com/api

/v2/{organization_id}/roles

Authorization (header)

x-api-key (header)

List roles with their associated permissions

List roles › path Parameters

organization_id

string · required

Organization ID

List roles › query Parameters

limit

integer

Limit the number of roles returned (default: 10)

offset

integer

Offset the roles returned (default: 0)

List roles › Responses

Roles retrieved successfully

object

object[]

Create role

POST

https://app.monad.com/api

/v2/{organization_id}/roles

Authorization (header)

x-api-key (header)

Create a new role with permissions

Create role › path Parameters

organization_id

string · required

Organization ID

Create role › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: name, permission_ids

Properties for Variant 1:

Create role › Responses

Role created successfully

created_at

string

description

string

id

string

name

string

organization_id

string

object[]

protected

boolean

updated_at

string

Get role

GET

https://app.monad.com/api

/v2/{organization_id}/roles/{role_id}

Authorization (header)

x-api-key (header)

Get a role with its associated permissions

Get role › path Parameters

organization_id

string · required

Organization ID

role_id

string · required

Role ID

Get role › Responses

Role retrieved successfully

created_at

string

description

string

id

string

name

string

organization_id

string

object[]

protected

boolean

updated_at

string

Delete role

DELETE

https://app.monad.com/api

/v2/{organization_id}/roles/{role_id}

Authorization (header)

x-api-key (header)

Delete a role

Delete role › path Parameters

organization_id

string · required

Organization ID

role_id

string · required

Role ID

Delete role › Responses

Update role

PATCH

https://app.monad.com/api

/v2/{organization_id}/roles/{role_id}

Authorization (header)

x-api-key (header)

Update a role and its permissions

Update role › path Parameters

organization_id

string · required

Organization ID

role_id

string · required

Role ID

Update role › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

Update role › Responses

Role updated successfully

created_at

string

description

string

id

string

name

string

organization_id

string

object[]

protected

boolean

updated_at

string

Oauth Permissions

List roles

GET

https://app.monad.com/api

/v2/{organization_id}/roles

Authorization (header)

x-api-key (header)

List roles with their associated permissions

List roles › path Parameters

organization_id

string · required

Organization ID

List roles › query Parameters

limit

integer

Limit the number of roles returned (default: 10)

offset

integer

Offset the roles returned (default: 0)

List roles › Responses

Roles retrieved successfully

object

object[]

Create role

POST

https://app.monad.com/api

/v2/{organization_id}/roles

Authorization (header)

x-api-key (header)

Create a new role with permissions

Create role › path Parameters

organization_id

string · required

Organization ID

Create role › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object · requires: name, permission_ids

Properties for Variant 1:

Create role › Responses

Role created successfully

created_at

string

description

string

id

string

name

string

organization_id

string

object[]

protected

boolean

updated_at

string

Get role

GET

https://app.monad.com/api

/v2/{organization_id}/roles/{role_id}

Authorization (header)

x-api-key (header)

Get a role with its associated permissions

Get role › path Parameters

organization_id

string · required

Organization ID

role_id

string · required

Role ID

Get role › Responses

Role retrieved successfully

created_at

string

description

string

id

string

name

string

organization_id

string

object[]

protected

boolean

updated_at

string

Update role

PATCH

https://app.monad.com/api

/v2/{organization_id}/roles/{role_id}

Authorization (header)

x-api-key (header)

Update a role and its permissions

Update role › path Parameters

organization_id

string · required

Organization ID

role_id

string · required

Role ID

Update role › Request Body

oneOf

Exactly one variant must match.

Decision Table

Variant	Matching Criteria
	type = object
	type = object

Properties for Variant 1:

Update role › Responses

Role updated successfully

created_at

string

description

string

id

string

name

string

organization_id

string

object[]

protected

boolean

updated_at

string