List roles
List the roles owned by your organization, ordered by name then id. Pass page.nextCursor unchanged as cursor to continue.
Query Parameters
- Type: stringcursormin length:1
Use page.nextCursor from the previous response. Omit for the first page. Keep the same filters while paging.
- Type: integerlimitmin:1max:100
Maximum number of records to return on this page.
Responses
- application/json
- application/json
- application/json
- application/json
- application/json
- application/json
Request Example for get/external/v2/roles
curl 'https://sales-api.artemis.solar/external/v2/roles?limit=25' \
--header 'x-api-key: YOUR_SECRET_TOKEN'
Final page of organization roles
{
"data": [
{
"id": "da7c1b2e-39f4-4c95-a816-8e27b4d1f530",
"name": "Project coordinator",
"description": "Coordinates assigned projects",
"permissions": [
"project:view_team",
"project:edit_details"
],
"createdAt": "2026-09-05T12:00:00.000Z",
"updatedAt": "2026-09-05T12:00:00.000Z"
}
],
"page": {
"nextCursor": null
}
}
