GET

/api/v1/documents/{DocumentId}/path

http://workdocs.{region}.amazonaws.com/api/v1/documents/{DocumentId}/path

<p>Retrieves the path information (the hierarchy from the root folder) for the requested document.</p> <p>By default, Amazon WorkDocs returns a maximum of 100 levels upwards from the requested document and only includes the IDs of the parent folders in the path. You can limit the maximum number of levels. You can also request the names of the parent folders.</p>

Access Token Required: API Key

Path Parameters

DocumentIdstringrequired

The ID of the document.

Query Params

limitinteger

The maximum number of levels in the hierarchy to return.

fieldsstring

A comma-separated list of values. Specify <code>NAME</code> to include the names of the parent folders.

markerstring

This value is not supported.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://workdocs.{region}.amazonaws.com/api/v1/documents/{DocumentId}/path' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}

GET