Returns the specified repository item by path

get/repository/paths

Get the specified repository item by path.

Authorization: Requires read permission.

Request Samples

Response Samples

1{
2 "value": {
3 "version": 1,
4 "createdBy": "sastest1",
5 "creationTimeStamp": "2023-08-29T12:23:24Z",
6 "modifiedBy": "sastest1",
7 "modifiedTimeStamp": "2023-09-19T19:01:21Z",
8 "id": "cac68a83-2f9b-4e45-859f-1163581edf1e",
9 "typeId": "businessunit",
10 "createdByDisplayName": "SAS Test User 1 (sastest1)",
11 "modifiedByDisplayName": "SAS Test User 1 (sastest1)",
12 "primaryType": "CONTEXT",
13 "name": "BU",
14 "location": "/",
15 "path": "/BU",
16 "size": 5318049,
17 "propertiesModifiedTimeStamp": "2023-08-29T12:23:24Z",
18 "propertiesModifiedBy": "sastest1",
19 "propertiesModifiedByDisplayName": "SAS Test User 1 (sastest1)",
20 "state": "ACTIVE",
21 "owner": "sastest1",
22 "ownerDisplayName": "SAS Test User 1 (sastest1)",
23 "syncable": "ALLOW",
24 "defaultOwner": "sastest1",
25 "defaultOwnerDisplayName": "SAS Test User 1 (sastest1)",
26 "defaultMajorVersionLimit": 5,
27 "defaultMinorVersionLimit": 10,
28 "tags": []
29 }
30}

Query Parameters

NameTypeRequiredDescription
digest
string
false

The hash value of a file based on the MD5 algorithm. This only applies to repository files. This property is not required. However, if provided, and the file exists on the server based on the other parameters provided, but the digest of the server file does not match the digest provided, a 404 error response will be returned.

fileVersion
string
false

The version of the repository file to return if the path is to a versioned file. If the path is to a container or the file is unversioned, an error is returned. If the file is versioned and no version is specified then the latest version is returned.'

itemId
string
false

The unique identifier of the item. This property is not required. However, if provided, and the item exists based on the other parameters provided, but the id of the server item does not match the id provided, a 404 error response will be returned.

path
string
true

The full path for the repository item.

Responses

StatusMeaningDescription
200OK

OK

Schema
404Not Found

Not found - the repository item could not be found.