PEpermit
Condition Sets

List Condition Sets

Changed on

Lists all condition sets matching a filter.

get/v2/schema/{proj_id}/{env_id}/condition_sets

Request

  • Base URL
    https://api.permit.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

proj_idstring required

Either the unique id of the project, or the URL-friendly key of the project (i.e: the "slug").

env_idstring required

Either the unique id of the environment, or the URL-friendly key of the environment (i.e: the "slug").

Query parameters

searchstring

Text search for the condition sets name or key

type'userset' | 'resourceset'

An enumeration.

if provided, will return only the condition sets of the specified type. e.g: only user sets.

include_total_countboolean

Include total count in response

pageinteger

Page number of the results to fetch, starting at 1.

per_pageinteger

The number of results per page (max 100).

Response

Successful Response

OR

Example response

{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "organization_id": "7c60d51f-b44e-4682-87d6-449835ea4de6",
      "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9",
      "resource_id": "e05f8571-f31e-20b2-2c45-15ae74cfb0f1",
      "environment_id": "40ef0e48-a11f-4963-a229-e396c9f7e7c4",
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z",
      "key": "na_based_employees",
      "name": "US or Canada based employees",
      "description": "All employees based in the US or Canada",
      "type": "userset",
      "autogenerated": false,
      "conditions": {
        "allOf": [
          {
            "user.role": {
              "equals": "employee"
            }
          },
          {
            "user.location": {
              "in": [
                "US",
                "Canada"
              ]
            }
          }
        ]
      }
    }
  ]
}

Changes