This endpoint is in preview and may be modified or removed at any time.
To use this endpoint, add preview=true to the request query parameters.
Get the Resource with the specified rid.
Third-party applications using this endpoint via OAuth2 must request the following operation scope: api:filesystem-read.
objectstringThe unique resource identifier (RID) of a Resource.
stringThe display name of the Resource
stringThe description of the Resource
stringThe documentation associated with the Resource
stringThe full path to the resource, including the resource name itself
string (enum)The type of the Resource derived from the Resource Identifier (RID).
Enum values: AIP_PROFILE, AIP_AGENTS_AGENT, AIP_AGENTS_SESSION, AIP_ASSIST_FLOW_CAPTURE, AIP_ASSIST_WALKTHROUGH, ARTIFACTS_REPOSITORY, BELLASO_CIPHER_CHANNEL, BELLASO_CIPHER_LICENSE, BLACKSMITH_DOCUMENT, BLOBSTER_ARCHIVE, BLOBSTER_AUDIO, BLOBSTER_BLOB, BLOBSTER_CODE, BLOBSTER_CONFIGURATION, BLOBSTER_DOCUMENT, BLOBSTER_IMAGE, BLOBSTER_JUPYTERNOTEBOOK, BLOBSTER_PDF, BLOBSTER_PRESENTATION, BLOBSTER_SPREADSHEET, BLOBSTER_VIDEO, BLOBSTER_XML, CARBON_WORKSPACE, COMPASS_FOLDER, COMPASS_WEB_LINK, CONTOUR_ANALYSIS, DATA_HEALTH_MONITORING_VIEW, DECISIONS_EXPLORATION, DREDDIE_PIPELINE, EDDIE_LOGIC, EDDIE_PIPELINE, FFORMS_FORM, FLOW_WORKFLOW, FOUNDRY_DATASET, FOUNDRY_DEPLOYED_APP, FOUNDRY_ACADEMY_TUTORIAL, FOUNDRY_CONTAINER_SERVICE_CONTAINER, FOUNDRY_ML_OBJECTIVE, FOUNDRY_TEMPLATES_TEMPLATE, FUSION_DOCUMENT, GEOTIME_CATALOG_INTEGRATION, GPS_VIEW, HUBBLE_EXPLORATION_LAYOUT, HYPERAUTO_INTEGRATION, LOGIC_FLOWS_CONNECTED_FLOW, MACHINERY_DOCUMENT, MAGRITTE_AGENT, MAGRITTE_DRIVER, MAGRITTE_EXPORT, MAGRITTE_SOURCE, MARKETPLACE_BLOCK_SET_INSTALLATION, MARKETPLACE_BLOCK_SET_REPO, MARKETPLACE_LOCAL, MARKETPLACE_REMOTE_STORE, MIO_MEDIA_SET, MODELS_MODEL, MODELS_MODEL_VERSION, MONOCLE_GRAPH, NOTEPAD_NOTEPAD, NOTEPAD_NOTEPAD_TEMPLATE, OBJECT_SENTINEL_MONITOR, OBJECT_SET_VERSIONED_OBJECT_SET, OPUS_GRAPH, OPUS_GRAPH_TEMPLATE, OPUS_MAP, OPUS_MAP_LAYER, OPUS_MAP_TEMPLATE, OPUS_SEARCH_AROUND, QUIVER_ANALYSIS, QUIVER_ARTIFACT, QUIVER_DASHBOARD, QUIVER_FUNCTION, QUIVER_OBJECT_SET_PATH, REPORT_REPORT, SLATE_DOCUMENT, SOLUTION_DESIGN_DIAGRAM, STEMMA_REPOSITORY, TABLES_TABLE, TAURUS_WORKFLOW, THIRD_PARTY_APPLICATIONS_APPLICATION, TIME_SERIES_CATALOG_SYNC, VECTOR_TEMPLATE, VECTOR_WORKBOOK, WORKSHOP_MODULE, WORKSHOP_STATE
stringThe user that created the Resource.
stringThe user that last updated the Resource.
stringThe timestamp that the Resource was last created.
stringThe timestamp that the Resource was last modified. For folders, this includes any of its descendants. For top level folders (spaces and projects), this is not updated by child updates for performance reasons.
string (enum)The trash status of the Resource. If trashed, this could either be because the Resource itself has been trashed or because one of its ancestors has been trashed.
Enum values: DIRECTLY_TRASHED, ANCESTOR_TRASHED, NOT_TRASHED
stringThe parent folder Resource Identifier (RID). For projects, this will be the Space RID.
stringThe Project Resource Identifier (RID) that the Resource lives in. If the Resource itself is a Project, this value will still be populated with the Project RID.
stringThe Space Resource Identifier (RID) that the Resource lives in.
1
2
3
curl \
\t-H "Authorization: Bearer $TOKEN" \
"https://$HOSTNAME/api/v2/filesystem/resources/ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da?preview=true"1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"projectRid": "ri.compass.main.folder.4cae7c13-b59f-48f6-9ef2-dbde603e4e33",
"updatedTime": "2024-09-25T17:29:35.974Z",
"updatedBy": "f05f8da4-b84c-4fca-9c77-8af0b13d11de",
"displayName": "My Dataset",
"description": "This dataset contains important data about Empyrean Airlines",
"rid": "ri.foundry.main.dataset.c26f11c8-cdb3-4f44-9f5d-9816ea1c82da",
"type": "FOUNDRY_DATASET",
"spaceRid": "ri.compass.main.folder.a86ad5f5-3db5-48e4-9fdd-00aa3e5731ca",
"trashStatus": "NOT_TRASHED",
"parentFolderRid": "ri.compass.main.folder.4cae7c13-b59f-48f6-9ef2-dbde603e4e33",
"path": "/Empyrean Airlines/My Important Project/My Dataset",
"createdBy": "f05f8da4-b84c-4fca-9c77-8af0b13d11de",
"createdTime": "2024-09-25T17:29:35.974Z"
}| Error Name | ||
|---|---|---|
Get | Error Code | INVALID_ARGUMENT |
| Status Code | 400 | |
| Description | Getting the root folder as a resource is not supported. | |
| Parameters | | |
Get | Error Code | INVALID_ARGUMENT |
| Status Code | 400 | |
| Description | Getting a space as a resource is not supported. | |
| Parameters | spaceRid | |
Resource | Error Code | NOT_FOUND |
| Status Code | 404 | |
| Description | The given Resource could not be found. | |
| Parameters | resourceRid | |
See Errors for a general overview of errors in the platform.