---
title: "GET /workflows/published/{workflowId}/workflowVersions"
method: GET
path: "/workflows/published/{workflowId}/workflowVersions"
tags: ["workflows"]
---

# GET /workflows/published/{workflowId}/workflowVersions

`GET /workflows/published/{workflowId}/workflowVersions`

Return paginated versions in an public entry

## Path parameters

- `workflowId` integer, required

## Query parameters

- `limit` integer
- `offset` integer
- `sortCol` string
- `sortOrder` string
- `include` string

## Response `200`

Get workflow versions in an entry. Default is 100 versions

- WorkflowVersion[]
  - `aiTopicProcessed` boolean
  - `aliases` object
  - `author` string
  - `authors` Author[]
    - `affiliation` string
    - `email` string
    - `name` string
    - `role` string
  - `commitID` string
  - `dbUpdateDate` integer
  - `descriptionSource` 'README' | 'CUSTOM_README' | 'DESCRIPTOR'
  - `descriptorTypeVersionsFromSourceFiles` SourceFile[]
    - `absolutePath` string, required — Absolute path of sourcefile in git repo
    - `checksums` Checksum[]
      - `checksum` string, required — The hex-string encoded checksum for the data.
      - `type` string, required — The digest method used to create the checksum. The value (e.g. `sha-256`) SHOULD be listed as `Hash Name String` in the https://github.com/ga4gh-discovery/ga4gh-checksum/blob/master/hash-alg.csv[GA4GH Checksum Hash Algorithm Registry]. Other values MAY be used, as long as implementors are aware of the issues discussed in https://tools.ietf.org/html/rfc6920#section-9.4[RFC6920]. GA4GH may provide more explicit guidance for use of non-IANA-registered algorithms in the future.
    - `content` string
    - `frozen` boolean
    - `id` integer
    - `metadata` SourceFileMetadata
      - `id` integer
      - `parent` SourceFile — recursive
      - `typeVersion` string — The language version for the given descriptor file type
    - `path` string, required — Path to sourcefile relative to its parent
    - `state` 'COMPLETE' | 'NOT_STORED' | 'STUB', required — Enumerates the file state
    - `type` 'DOCKSTORE_SMK' | 'SMK_TEST_PARAMS' | 'DOCKSTORE_CWL' | 'CWL_TEST_JSON' | 'DOCKSTORE_WDL' | 'WDL_TEST_JSON' | 'DOCKSTORE_WORKFLOW_OTHER' | 'DOCKERFILE' | 'NEXTFLOW' | 'NEXTFLOW_CONFIG' | 'NEXTFLOW_TEST_PARAMS' | 'DOCKSTORE_YML' | 'DOCKSTORE_SERVICE_YML' | 'DOCKSTORE_SERVICE_TEST_JSON' | 'DOCKSTORE_SERVICE_OTHER' | 'DOCKSTORE_GXFORMAT2' | 'GXFORMAT2_TEST_FILE' | 'DOCKSTORE_SWL' | 'SWL_TEST_JSON' | 'DOCKSTORE_JUPYTER' | 'DOCKSTORE_NOTEBOOK_REES' | 'DOCKSTORE_NOTEBOOK_DEVCONTAINER' | 'DOCKSTORE_NOTEBOOK_TEST_FILE' | 'DOCKSTORE_NOTEBOOK_OTHER', required — Enumerates the type of file
    - `verifiedBySource` object
  - `dirtyBit` boolean
  - `doiStatus` 'NOT_REQUESTED' | 'REQUESTED' | 'CREATED'
  - `doiURL` string
  - `dois` object — The DOIs for the version of the entry
  - `email` string
  - `frozen` boolean
  - `hidden` boolean
  - `id` integer
  - `images` Image[]
    - `architecture` string
    - `checksums` Checksum[]
      - `checksum` string, required — The hex-string encoded checksum for the data.
      - `type` string, required — The digest method used to create the checksum. The value (e.g. `sha-256`) SHOULD be listed as `Hash Name String` in the https://github.com/ga4gh-discovery/ga4gh-checksum/blob/master/hash-alg.csv[GA4GH Checksum Hash Algorithm Registry]. Other values MAY be used, as long as implementors are aware of the issues discussed in https://tools.ietf.org/html/rfc6920#section-9.4[RFC6920]. GA4GH may provide more explicit guidance for use of non-IANA-registered algorithms in the future.
    - `dbUpdateDate` string, date-time
    - `imageID` string
    - `imageRegistry` 'QUAY_IO' | 'DOCKER_HUB' | 'GITLAB' | 'AMAZON_ECR' | 'SEVEN_BRIDGES' | 'GITHUB_CONTAINER_REGISTRY'
    - `imageUpdateDate` string
    - `os` string
    - `repository` string
    - `size` integer
    - `specifier` 'PARAMETER' | 'NO_TAG' | 'LATEST' | 'TAG' | 'DIGEST'
    - `tag` string
  - `input_file_formats` FileFormat[]
    - `value` string
  - `kernelImagePath` string — User-specified notebook kernel image reference
  - `last_modified` integer
  - `legacyVersion` boolean
  - `metricsByPlatform` object
  - `name` string, required — Implementation specific, can be a quay.io or docker hub tag name
  - `orcidAuthors` OrcidAuthor[]
    - `id` integer
    - `orcid` string
  - `output_file_formats` FileFormat[]
    - `value` string
  - `readMePath` string
  - `reference` string, required — git commit/tag/branch
  - `referenceType` 'COMMIT' | 'TAG' | 'BRANCH' | 'NOT_APPLICABLE' | 'UNSET'
  - `synced` boolean
  - `userFiles` string[]
  - `valid` boolean
  - `validations` Validation[]
    - `id` integer
    - `message` string
    - `type` 'DOCKSTORE_SMK' | 'SMK_TEST_PARAMS' | 'DOCKSTORE_CWL' | 'CWL_TEST_JSON' | 'DOCKSTORE_WDL' | 'WDL_TEST_JSON' | 'DOCKSTORE_WORKFLOW_OTHER' | 'DOCKERFILE' | 'NEXTFLOW' | 'NEXTFLOW_CONFIG' | 'NEXTFLOW_TEST_PARAMS' | 'DOCKSTORE_YML' | 'DOCKSTORE_SERVICE_YML' | 'DOCKSTORE_SERVICE_TEST_JSON' | 'DOCKSTORE_SERVICE_OTHER' | 'DOCKSTORE_GXFORMAT2' | 'GXFORMAT2_TEST_FILE' | 'DOCKSTORE_SWL' | 'SWL_TEST_JSON' | 'DOCKSTORE_JUPYTER' | 'DOCKSTORE_NOTEBOOK_REES' | 'DOCKSTORE_NOTEBOOK_DEVCONTAINER' | 'DOCKSTORE_NOTEBOOK_TEST_FILE' | 'DOCKSTORE_NOTEBOOK_OTHER'
    - `valid` boolean
  - `verified` boolean
  - `verifiedPlatforms` string[] — Verified platforms for the version
  - `verifiedSource` string
  - `verifiedSources` string[]
  - `versionEditor` User
    - `avatarUrl` string
    - `curator` boolean — Indicates whether this user is a curator. The value is always false unless requested for oneself or by an admin
    - `id` integer
    - `isAdmin` boolean — Indicates whether the user is an admin. The value is always false unless requested for oneself or by an admin
    - `metricsRobot` boolean
    - `metricsRobotPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this user is a robot that submits metrics
    - `name` string
    - `orcid` string
    - `platformPartner` 'GALAXY' | 'TERRA' | 'DNA_STACK' | 'DNA_NEXUS' | 'CGC' | 'NHLBI_BIODATA_CATALYST' | 'ANVIL' | 'CAVATICA' | 'NEXTFLOW_TOWER' | 'ELWAZI' | 'AGC' | 'TOIL' | 'OTHER' | 'ALL' — Indicates whether this account corresponds to a platform partner
    - `privacyPolicyVersion` 'NONE' | 'PRIVACY_POLICY_VERSION_2_5'
    - `privacyPolicyVersionAcceptanceDate` integer
    - `setupComplete` boolean
    - `tosacceptanceDate` integer
    - `tosversion` 'NONE' | 'TOS_VERSION_1' | 'TOS_VERSION_2'
    - `tosversionAcceptanceDate` integer
    - `userProfiles` object
    - `username` string
    - `usernameChangeRequired` boolean — Indicates whether the user is required to change their username before being allowed to do various operations on Dockstore.
  - `versionMetadata` VersionMetadata
    - `aiTopicProcessed` boolean — True if Dockstore has processed this version for an AI topic
    - `descriptorTypeVersions` string[]
    - `dois` object — The DOIs for the version of the entry
    - `engineVersions` string[]
    - `id` integer
    - `latestMetricsAggregationDate` integer — The timestamp of the last metrics aggregation
    - `latestMetricsSubmissionDate` integer — The timestamp of the last metrics submission
    - `parsedInformationSet` ParsedInformation[]
      - `descriptorLanguage` 'SMK' | 'CWL' | 'WDL' | 'gxformat2' | 'SWL' | 'NFL' | 'service' | 'jupyter'
      - `hasHTTPImports` boolean
      - `hasLocalImports` boolean
    - `publicAccessibleTestParameterFile` boolean — Whether the version has everything needed to run without restricted access permissions
    - `userIdToOrcidPutCode` object — The presence of the put code for a userid indicates the version was exported to ORCID for the corresponding Dockstore user.
  - `workflow_path` string
  - `workingDirectory` string

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.dev/dockstore/apis/dockstore-api.md) · [All operations](https://skmtc.dev/dockstore/apis/dockstore-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dockstore/dockstore-api/revisions/9d82a4e96aa7/schema)
