Get a list of allowed paths

get/providers/{providerId}/allowedPaths

Returns a collection of allowed paths for the specified provider. Allowed paths define authorization rules for paths that users can access. Standard paging, filtering, and sorting options are specified in the Parameters section below. When the Accept header is set to text/plain, the response returns a space-separated list of quoted paths suitable for use in SAS code. Each path is automatically quoted according to SAS quoting rules:

  • Paths containing single quotes are wrapped in double quotes - Paths containing double quotes are wrapped in single quotes - Paths containing both single and double quotes are wrapped in double quotes, with internal double quotes escaped by doubling them (e.g., "" represents a literal " in SAS) - Paths without quotes are wrapped in double quotes for safety Only paths that the user is authorized to access are included in the response.

Request Samples

1

Response Samples

1{
2  "name": "allowedPaths",
3  "accept": "application/vnd.sas.data.source.allowed.path+json",
4  "start": 0,
5  "count": 2,
6  "limit": 10,
7  "version": 2,
8  "items": [
9    {
10      "id": "f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
11      "path": "/data/shared/projects",
12      "createdBy": "sasjoe",
13      "modifiedBy": "sasjoe",
14      "creationTimeStamp": "2026-02-05T10:30:00.000Z",
15      "modifiedTimeStamp": "2026-02-05T10:30:00.000Z",
16      "version": 1,
17      "links": [
18        {
19          "method": "GET",
20          "rel": "self",
21          "href": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
22          "uri": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f"
23        },
24        {
25          "method": "PUT",
26          "rel": "update",
27          "href": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
28          "uri": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f"
29        },
30        {
31          "method": "DELETE",
32          "rel": "delete",
33          "href": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f",
34          "uri": "/dataSources/providers/Compute/allowedPaths/f3b4c8a1-5d2e-4a9b-8c7f-1e3d5a7b9c2f"
35        },
36        {
37          "method": "GET",
38          "rel": "up",
39          "href": "/dataSources/providers/Compute/allowedPaths",
40          "uri": "/dataSources/providers/Compute/allowedPaths"
41        }
42      ]
43    },
44    {
45      "id": "a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d",
46      "path": "/opt/sas/data",
47      "createdBy": "sasadmin",
48      "modifiedBy": "sasadmin",
49      "creationTimeStamp": "2026-02-04T14:20:00.000Z",
50      "modifiedTimeStamp": "2026-02-04T14:20:00.000Z",
51      "version": 1,
52      "links": [
53        {
54          "method": "GET",
55          "rel": "self",
56          "href": "/dataSources/providers/Compute/allowedPaths/a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d",
57          "uri": "/dataSources/providers/Compute/allowedPaths/a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d"
58        },
59        {
60          "method": "PUT",
61          "rel": "update",
62          "href": "/dataSources/providers/Compute/allowedPaths/a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d",
63          "uri": "/dataSources/providers/Compute/allowedPaths/a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d"
64        },
65        {
66          "method": "DELETE",
67          "rel": "delete",
68          "href": "/dataSources/providers/Compute/allowedPaths/a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d",
69          "uri": "/dataSources/providers/Compute/allowedPaths/a7d9e2b4-1c3f-4e8a-9b6d-2f5c7e9a1b3d"
70        },
71        {
72          "method": "GET",
73          "rel": "up",
74          "href": "/dataSources/providers/Compute/allowedPaths",
75          "uri": "/dataSources/providers/Compute/allowedPaths"
76        }
77      ]
78    }
79  ],
80  "links": [
81    {
82      "method": "GET",
83      "rel": "self",
84      "href": "/dataSources/providers/Compute/allowedPaths?start=0&limit=10",
85      "uri": "/dataSources/providers/Compute/allowedPaths?start=0&limit=10",
86      "type": "application/vnd.sas.collection"
87    },
88    {
89      "method": "GET",
90      "rel": "collection",
91      "href": "/dataSources/providers/Compute/allowedPaths",
92      "uri": "/dataSources/providers/Compute/allowedPaths",
93      "type": "application/vnd.sas.collection"
94    },
95    {
96      "method": "POST",
97      "rel": "create",
98      "href": "/dataSources/providers/Compute/allowedPaths",
99      "uri": "/dataSources/providers/Compute/allowedPaths"
100    },
101    {
102      "method": "GET",
103      "rel": "up",
104      "href": "/dataSources/providers/Compute",
105      "uri": "/dataSources/providers/Compute",
106      "type": "application/vnd.sas.data.provider"
107    }
108  ]
109}

Path Parameters

NameTypeRequiredDescription
providerId
string
true

The ID for the provider.

Query Parameters

NameTypeRequiredDescription
filter
string<filter-criteria>
false

Filter criteria for returned allowed paths. The supported functions are and, or, not, eq, lt, le, gt, ge, contains, startsWith, endsWith, and isNull. Some sample queries include the following:

  • Search by path starting with: /dataSources/providers/{providerId}/allowedPaths?filter=startsWith(path, '/data')
  • Search by path: /dataSources/providers/{providerId}/allowedPaths?filter=eq(path, '/data/mypath')
limit
integer
false

Maximum number of objects to return. Defaults to 10.

sortBy
string<sort-criteria>
false

Sort returned allowed paths. The sort criteria supports the following fields in either ascending or descending order (path, createdBy, modifiedBy, creationTimeStamp, and modifiedTimeStamp). Some sample sorts include the following:

  • Sort ascending by path: /dataSources/providers/{providerId}/allowedPaths?sortBy=path:ascending
  • Sort descending by path: /dataSources/providers/{providerId}/allowedPaths?sortBy=path:descending The default sort is by path in ascending order.
start
integer
false

0-based Offset of first object to return. Defaults to 0.

Responses

StatusMeaningDescription
200OK

The request succeeded. Any allowed paths are returned in a resource collection or as plain text depending on the Accept header.

Schema
400Bad Request

The request was invalid. Invalid requests occur in the following scenarios:

  • A negative start value is provided.
  • A negative limit value is provided.
  • An unsupported field is specified in the sortBy parameter.
Schema
404Not Found

No provider exists at the requested path.

Schema