List roles

​

List the roles owned by your organization, ordered by name then id. Pass page.nextCursor unchanged as cursor to continue.

Query Parameters

  • Use page.nextCursor from the previous response. Omit for the first page. Keep the same filters while paging.

  • 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
  }
}