EmbodiFlowDocs
Open console
Get startedDataWorkflows and algorithmsTraining and deploymentDeveloper reference
  • Developer reference

Authentication

  • Authentication overview
  • API keys
  • Personal access tokens
  • Browser sessions

REST API

  • Using the REST API
  • All endpoints
  • Projects
    • Recordings
      • Upload
        • Episodes and versions
          • Annotation
            • Quality and tasks
              • Search
                • GET
                  Asset cards across dataset versions and artifacts.
                • GET
                  Single asset card with recent events.
                • POST
                  Preview a structured query against canonical parquet for one dataset version.
                • GET
                  L0 Postgres coarse filter across dataset versions visible to the caller.
                • GET
                  Facet counts for the same visible version scope as dataset-versions list.
                • GET
                  How many recordings are not in the search index yet.
                • POST
                  Explicit team Owner/Admin action: build the search profile for recordings processed before indexing existed. Derived cache, never dataset history.
                • POST
                  Structured + optional semantic catalog search (ADR 0012 / 0014).
                • GET
                  Structured catalog search schema for query builders (ADR 0012).
                • GET
                  Search this team for projects, recordings, versions, and commands
              • Workflows
                • Algorithms
                  • Models
                    • Artifacts and export
                      • Billing and usage
                        • Team and governance
                          • Account and notifications
                            • Webhook endpoints

                              Events

                              • Outbound events
                              • Signature verification

                              Tools

                              • CLI
                              • SDK
                              • MCP

                              Updates

                              • Changelog

                              © 2026 EmbodiFlow

                              llms.txtOpenAPI JSON
                              1. Developer reference
                              2. REST API
                              3. Search
                              4. L0 Postgres coarse filter across dataset versions visible to the caller.

                              L0 Postgres coarse filter across dataset versions visible to the caller.

                              GET
                              /v1/catalog/dataset-versions
                              curl -X GET 'https://api.embodiflow.io/v1/catalog/dataset-versions' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT'

                              Authorization

                              Send a personal access token with every request.

                              • Authorization: Bearer PAT
                              Authentication guide

                              Query parameters

                              • pageSizenumber

                                Page size (default 25, maximum 100). Over-maximum is refused.

                              • pageTokenstring

                                Opaque page token from the previous response.

                              • sortBystring
                                Allowed values
                                updatedAt
                                createdAt
                                version
                              • sortOrderstring
                                Allowed values
                                asc
                                desc
                              • projectIdstring (uuid)
                              • datasetIdstring (uuid)
                              • sourceTypestring
                              • dataSourcestring
                                Allowed values
                                ego_human
                              • metadataTypestring
                              • qualityStatusstring
                              • statusstring
                              • fpsMinnumber
                              • fpsMaxnumber
                              • lerobotEpisodeCountMinnumber
                              • lerobotEpisodeCountMaxnumber
                              • frameCountMinnumber
                              • frameCountMaxnumber
                              • startTimeNsMinnumber
                              • startTimeNsMaxnumber
                              • endTimeNsMinnumber
                              • endTimeNsMaxnumber
                              • metadataKeystring
                                Allowed values
                                profile
                                task
                                robotType
                                cameraCount
                                fpsBucket
                              • metadataEqualsstring
                              • includeSoftHiddenboolean

                              Responses

                              Success

                              • dataarray<CatalogDatasetVersionSummaryDto>required
                                • idstringrequired
                                • projectIdstringrequired
                                • datasetIdstringrequired
                                • datasetNamestringrequired
                                • sourceTypestringrequired
                                • dataSourcestring | null
                                • episodeStatisticsGranularitystring
                                  Allowed values
                                  coarse
                                • versionnumberrequired
                                • versionNamestring | nullrequired
                                • descriptionstring | nullrequired
                                • statusstringrequired
                                • manifestVersionnumber
                                • metadataTypestring | null
                                • codebaseVersionstring | null
                                • episodeCountnumber | null
                                • lerobotEpisodeCountnumber | null
                                • featureCountnumber | null
                                • fpsnumber | null
                                • topicCountnumber | null
                                • frameCountnumber | null
                                • startTimeNsnumber | null
                                • endTimeNsnumber | null
                                • metadataProjectionJsonobject | null
                                • itemCountnumberrequired
                                • totalBytesnumber | nullrequired
                                • finalizedAtstring | nullrequired
                                • createdAtstringrequired
                                • updatedAtstringrequired
                                • qualityStatusstring
                                • visibilityStatusstring
                                  Allowed values
                                  active
                                  soft_hidden
                                • assetHealthobject
                              • metaobjectrequired
                                • pageSizenumberrequired
                                • requestIdstring
                              • nextPageTokenstring

                                Opaque AIP-158 page token. Omitted when the collection is exhausted.

                              Response example
                              {
                                "data": [
                                  {
                                    "id": "string",
                                    "projectId": "string",
                                    "datasetId": "string",
                                    "datasetName": "string",
                                    "sourceType": "string",
                                    "dataSource": "string",
                                    "episodeStatisticsGranularity": "coarse",
                                    "version": 0,
                                    "versionName": "string",
                                    "description": "string",
                                    "status": "string",
                                    "manifestVersion": 0,
                                    "metadataType": "string",
                                    "codebaseVersion": "string",
                                    "episodeCount": 0,
                                    "lerobotEpisodeCount": 0,
                                    "featureCount": 0,
                                    "fps": 0,
                                    "topicCount": 0,
                                    "frameCount": 0,
                                    "startTimeNs": 0,
                                    "endTimeNs": 0,
                                    "metadataProjectionJson": {},
                                    "itemCount": 0,
                                    "totalBytes": 0,
                                    "finalizedAt": "string",
                                    "createdAt": "string",
                                    "updatedAt": "string",
                                    "qualityStatus": "string",
                                    "visibilityStatus": "active",
                                    "assetHealth": {
                                      "healthStatus": "failed",
                                      "lastEventAt": "string",
                                      "summary": "string",
                                      "qualityStatus": "string"
                                    }
                                  }
                                ],
                                "meta": {
                                  "pageSize": 0,
                                  "requestId": "string"
                                },
                                "nextPageToken": "string"
                              }
                              Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1
                              Previous

                              POST /catalog/dataset-version-queries

                              Next

                              GET /catalog/facets

                              curl -X GET 'https://api.embodiflow.io/v1/catalog/dataset-versions' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT'
                              Response example
                              Status code
                              200
                              ​
                              {
                                "data": [
                                  {
                                    "id": "string",
                                    "projectId": "string",
                                    "datasetId": "string",
                                    "datasetName": "string",
                                    "sourceType": "string",
                                    "dataSource": "string",
                                    "episodeStatisticsGranularity": "coarse",
                                    "version": 0,
                                    "versionName": "string",
                                    "description": "string",
                                    "status": "string",
                                    "manifestVersion": 0,
                                    "metadataType": "string",
                                    "codebaseVersion": "string",
                                    "episodeCount": 0,
                                    "lerobotEpisodeCount": 0,
                                    "featureCount": 0,
                                    "fps": 0,
                                    "topicCount": 0,
                                    "frameCount": 0,
                                    "startTimeNs": 0,
                                    "endTimeNs": 0,
                                    "metadataProjectionJson": {},
                                    "itemCount": 0,
                                    "totalBytes": 0,
                                    "finalizedAt": "string",
                                    "createdAt": "string",
                                    "updatedAt": "string",
                                    "qualityStatus": "string",
                                    "visibilityStatus": "active",
                                    "assetHealth": {
                                      "healthStatus": "failed",
                                      "lastEventAt": "string",
                                      "summary": "string",
                                      "qualityStatus": "string"
                                    }
                                  }
                                ],
                                "meta": {
                                  "pageSize": 0,
                                  "requestId": "string"
                                },
                                "nextPageToken": "string"
                              }