EPepilot
Roles

listCurrentRoles

Changed on

Returns roles and grants assigned to current user.

When the calling token itself is restricted (read-only, anonymized, or an AI agent token with an access profile), token_restrictions describes those restrictions. Effective permissions are the roles' grants narrowed by them.

get/v1/permissions/me

Request

  • Base URL
    https://permissions.sls.epilot.io
  • URL
    https://permissions.sls.epilot.io/v1/permissions/me
  • Auth
    • HTTP bearer
    • or API key in header x-epilot-org-id

Response

ok

Example response

{
  "roles": [
    {
      "id": "123:owner",
      "name": "Owner",
      "slug": "owner",
      "expires_at": "2028-07-21T17:32:28Z",
      "organization_id": "123",
      "grants": [
        {
          "action": "entity-read",
          "resource": "entity:123:contact:f7c22299-ca72-4bca-8538-0a88eeefc947",
          "conditions": [
            {
              "attribute": "workflows.primary.task_name",
              "values": [
                "Qualification"
              ]
            }
          ]
        }
      ],
      "parent_role": "123:owner"
    }
  ],
  "token_restrictions": {
    "allowed_actions": [
      "journey:*",
      "entity:view"
    ],
    "actor": {
      "type": "agent"
    }
  }
}

Changes

  • 8e258152bbd8Revision changes
    • info

      added the optional property to the response with the status

  • 546c43723a60Revision changes
    • info

      added the optional property /////// to the response with the status