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
          • GET
            Get a dataset version composition profile
          • GET
            List quality findings for a dataset version composition profile
          • POST
            Create a composition profile request
          • GET
            List composition profiles for a dataset version
          • GET
            Count episodes matching a filter
          • POST
            Apply label and segment operations to a selection of episodes
          • GET
            Semantic search availability and index coverage for the project
          • GET
            List episodes in a project
          • GET
            Get an episode
          • GET
            List revisions of an episode
          • POST
            Append one episode revision (never If-Match)
          • GET
            Find similar episodes in the same project
          • GET
            List version aliases in a project
          • DELETE
            Delete a version alias
          • PUT
            Create or move a version alias
          • GET
            List versions in a project
          • POST
            Create a version from a selection of episodes
          • DELETE
            Move a version to trash
          • GET
            Get a version
          • PATCH
            Patch version name, readme, and licence
          • GET
            Get a version citation
          • GET
            List episodes in a version
          • POST
            Preview a version selection without writing
        • Annotation
          • Quality and tasks
            • Search
              • 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. Episodes and versions

                              Episodes and versions

                              Episodes, dataset versions, version aliases, and composition profiles.

                              Endpoints

                              /dataset-version-composition-profiles

                              GET

                              Get a dataset version composition profile

                              /v1/dataset-version-composition-profiles/{profileId}
                              GET

                              List quality findings for a dataset version composition profile

                              /v1/dataset-version-composition-profiles/{profileId}/quality-findings

                              /dataset-versions

                              POST

                              Create a composition profile request

                              /v1/dataset-versions/{versionId}/composition-profile-requests
                              GET

                              List composition profiles for a dataset version

                              /v1/dataset-versions/{versionId}/composition-profiles

                              /projects

                              GET

                              Count episodes matching a filter

                              /v1/projects/{projectId}/episode-count
                              POST

                              Apply label and segment operations to a selection of episodes

                              /v1/projects/{projectId}/episode-operations
                              GET

                              Semantic search availability and index coverage for the project

                              /v1/projects/{projectId}/episode-search-status
                              GET

                              List episodes in a project

                              /v1/projects/{projectId}/episodes
                              GET

                              Get an episode

                              /v1/projects/{projectId}/episodes/{episodeId}
                              GET

                              List revisions of an episode

                              /v1/projects/{projectId}/episodes/{episodeId}/revisions
                              POST

                              Append one episode revision (never If-Match)

                              /v1/projects/{projectId}/episodes/{episodeId}/revisions
                              GET

                              Find similar episodes in the same project

                              /v1/projects/{projectId}/episodes/{episodeId}/similar
                              GET

                              List version aliases in a project

                              /v1/projects/{projectId}/version-aliases
                              DELETE

                              Delete a version alias

                              /v1/projects/{projectId}/version-aliases/{aliasName}
                              PUT

                              Create or move a version alias

                              /v1/projects/{projectId}/version-aliases/{aliasName}
                              GET

                              List versions in a project

                              /v1/projects/{projectId}/versions
                              POST

                              Create a version from a selection of episodes

                              /v1/projects/{projectId}/versions
                              DELETE

                              Move a version to trash

                              /v1/projects/{projectId}/versions/{versionNumber}
                              GET

                              Get a version

                              /v1/projects/{projectId}/versions/{versionNumber}
                              PATCH

                              Patch version name, readme, and licence

                              /v1/projects/{projectId}/versions/{versionNumber}
                              GET

                              Get a version citation

                              /v1/projects/{projectId}/versions/{versionNumber}/citation
                              GET

                              List episodes in a version

                              /v1/projects/{projectId}/versions/{versionNumber}/episodes
                              POST

                              Preview a version selection without writing

                              /v1/projects/{projectId}/versions/previews
                              Previous

                              Upload

                              Next

                              Annotation