> ## Documentation Index > Fetch the complete documentation index at: https://developers.askparable.com/llms.txt > Use this file to discover all available pages before exploring further. # browseArtifacts > List artifacts and virtual subfolders at a given path for the current workspace. Pass `path` to drill into a folder; omit (or pass empty) to list the workspace root. ## OpenAPI ````yaml /api-reference/openapi.json get /api/artifacts/browse openapi: 3.0.3 info: title: Parable API description: >- The REST API for your Parable workspace: manage connectors and taps, explore your data catalog, upload artifacts, and administer users and roles. version: v1 servers: - url: https://api.askparable.com description: Production security: [] paths: /api/artifacts/browse: get: tags: - artifacts summary: browseArtifacts description: >- List artifacts and virtual subfolders at a given path for the current workspace. Pass `path` to drill into a folder; omit (or pass empty) to list the workspace root. operationId: ArtifactsBrowseArtifactsHandler parameters: - description: >- Workspace slug. Overrides subdomain-based workspace resolution when provided. in: header name: X-Tenant required: false schema: example: acme type: string - description: Optional request correlation ID echoed back in the response. in: header name: X-Request-ID required: false schema: example: 550e8400-e29b-41d4-a716-446655440000 format: uuid type: string - in: query name: path required: false schema: description: >- Hierarchical path expressed as a dot-separated ltree (e.g., 'reports.q1.draft'). type: string responses: '200': content: application/json: schema: properties: data: $ref: '#/components/schemas/BrowseArtifactsResult' links: $ref: '#/components/schemas/ResponseLinks' meta: $ref: '#/components/schemas/ResponseMeta' required: - data - meta type: object description: Successful response '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad request '500': content: application/json: schema: $ref: '#/components/schemas/Error' description: Internal server error security: - bearerAuth: [] components: schemas: BrowseArtifactsResult: description: >- Listing of artifacts and immediate child folders at a given path for the current workspace. Folders are virtual: each entry in `folders` is the next label below `path` for which at least one non-deleted artifact exists. properties: artifacts: description: |- Artifacts whose `path` equals `path` (or whose `path` is NULL when listing the root). Sorted by createdAt descending. items: $ref: '#/components/schemas/ArtifactInfo' type: array folders: description: |- Immediate child folder names (single label, not full path). Sorted alphabetically. items: type: string type: array path: description: The path that was browsed; NULL when listing the workspace root. type: string required: - folders - artifacts type: object ResponseLinks: properties: first: nullable: true type: string last: nullable: true type: string next: nullable: true type: string prev: nullable: true type: string type: object ResponseMeta: properties: requestId: description: Unique identifier for the request type: string totalCount: description: Total count of items for paginated responses nullable: true type: integer required: - requestId type: object Error: properties: error: type: string type: object ArtifactInfo: description: Artifact metadata for customer display. properties: attributedTapId: description: >- ID of the TenantConnectorTap that was derived from this artifact, if any. Populated by a query-time lookup from `tenant_connector_tap.artifact_id` rather than a stored column (the inverse FK is intentionally one-way; see EDR-0021 Phase 1 cycle-breaking decision). Null until the artifact has been processed and its derived tap has been created. type: string createdAt: description: ISO8601 datetime string type: string createdBy: description: UUID v4 string as base62 type: string dataSchema: description: Current persisted schema. Null until a schema is generated or saved. type: object fileName: type: string fileSize: description: File size in bytes (non-negative, BIGINT-backed) format: int64 type: integer fileType: $ref: '#/components/schemas/ArtifactTypeEnum' id: description: UUID v4 with automatic base62 encoding for client-facing APIs type: string path: description: >- Virtual-folder path for this artifact, dot-separated ltree. NULL means the artifact lives at the workspace root. type: string schemaInferenceStatus: $ref: '#/components/schemas/ArtifactSchemaInferenceStatusEnum' updatedAt: description: ISO8601 datetime string type: string updatedBy: description: UUID v4 string as base62 type: string uploadStatus: $ref: '#/components/schemas/ArtifactUploadStatusEnum' uploadedBy: $ref: '#/components/schemas/UserInfo' required: - id - createdAt - createdBy - updatedAt - updatedBy - fileName - fileType - fileSize - uploadStatus - schemaInferenceStatus - uploadedBy type: object ArtifactTypeEnum: description: Type of uploaded artifact file enum: - csv - xlsx - xls - numbers - ods - zip type: string ArtifactSchemaInferenceStatusEnum: description: Status of optional schema inference for an artifact enum: - not_requested - processing - succeeded - failed type: string ArtifactUploadStatusEnum: description: Availability status of an uploaded artifact file enum: - pending - processing - ready - failed type: string UserInfo: description: |- A type for general info about a user for returning enough public facing user info for fields like createdBy or updatedBy. properties: email: description: An email address type: string id: description: UUID v4 with automatic base62 encoding for client-facing APIs type: string name: description: An objects name type: string required: - id - name - email type: object securitySchemes: bearerAuth: bearerFormat: JWT scheme: bearer type: http ````