v2

latestOpenAPI 3.1.02026-07-26143251806.6 KB

folders

List Folder Entities

get/api/public/v2/folders/entities

workspace_idinteger required

The ID of the workspace to list entities from.

folder_idinteger

The ID of the folder to list entities from. If not provided, lists entities at the workspace root level.

string[]

search_querystring

Search entities by name (case-insensitive partial match).

flattenboolean

When true, returns all entities recursively within the folder hierarchy instead of only direct children.

include_metadataboolean

When true, includes type-specific metadata for each entity (e.g., prompt type, latest version number).

created_by_emailstring

Filter by the creator's email address.

created_afterstring date-time

Filter resources created at or after this timestamp.

created_beforestring date-time

Filter resources created at or before this timestamp.

updated_afterstring date-time

Filter resources updated at or after this timestamp.

updated_beforestring date-time

Filter resources updated at or before this timestamp.

external_sourcestring

External ID source to filter by. Must be provided with external_id.

external_idstring

External ID value to filter by. Must be provided with external_source.

sort_by'created_at' | 'updated_at' | 'name' | 'id'

Sort field.

sort_order'asc' | 'desc'

Sort direction.

string

string[]

Filter entities by tags. Applies to entity types that support tags.

semantic_searchboolean

Use semantic search instead of text matching. Requires search_query.

semantic_search_top_kinteger

Maximum number of semantic search results to consider.

semantic_search_thresholdnumber

Maximum semantic search distance threshold.

Successful Response