---
title: "POST /containers/{containerId}/publish"
method: POST
path: "/containers/{containerId}/publish"
tags: ["containers"]
---

# POST /containers/{containerId}/publish

`POST /containers/{containerId}/publish`

Publish or unpublish a tool.

## Path parameters

- `containerId` integer, required

## Request body

- PublishRequest
  - `publish` boolean

## Response `default`

default response

- DockstoreTool — This describes one entry in the dockstore. Logically, this currently means one tuple of registry (either quay or docker hub), organization, image name, and toolname which can be associated with CWL and Dockerfile documents
  - `aliases` object
  - `approvedAITopic` boolean — Indicates if the topicAI has been approved by the user
  - `archived` boolean
  - `authors` Author[] — Non-ORCID authors for the entry, retrieved from the default version
    - `affiliation` string
    - `email` string
    - `name` string
    - `role` string
  - `checker_id` integer
  - `conceptDoi` string — The Digital Object Identifier (DOI) representing all of the versions of your workflow
  - `conceptDois` object — The Digital Object Identifier (DOI) representing all of the versions of your workflow
  - `custom_docker_registry_path` string
  - `customerDockerRegistryPath` string
  - `dbCreateDate` integer
  - `dbUpdateDate` integer
  - `defaultCWLTestParameterFile` string
  - `defaultVersion` string
  - `defaultWDLTestParameterFile` string
  - `default_cwl_path` string
  - `default_dockerfile_path` string
  - `default_wdl_path` string
  - `deletable` boolean
  - `description` string
  - `descriptorType` string[]
  - `doiSelection` 'USER' | 'DOCKSTORE' | 'GITHUB' — The Digital Object Identifier (DOI) to display publicly
  - `entryType` 'TOOL' | 'WORKFLOW' | 'SERVICE' | 'APPTOOL' | 'NOTEBOOK' — Entry type
  - `entryTypeMetadata` EntryTypeMetadata — Information about an entry type
    - `searchEntryType` string — Search 'entryType' parameter value for this entry type
    - `searchSupported` boolean — Search support for this entry type
    - `sitePath` string — Relative path from the root of the site to the 'pages' where entries of this type are displayed
    - `term` string — Singular term used to refer to an instance of this entry type
    - `termPlural` string — Plural term used to refer to instances of this entry type
    - `trsPrefix` string — TRS ID prefix for this entry type
    - `trsSupported` boolean — TRS support for this entry type
    - `type` 'TOOL' | 'WORKFLOW' | 'SERVICE' | 'APPTOOL' | 'NOTEBOOK' — Entry type
  - `forumUrl` string
  - `gitUrl` string
  - `has_checker` boolean
  - `id` integer
  - `input_file_formats` FileFormat[]
    - `value` string
  - `is_published` boolean
  - `labels` Label[]
    - `id` integer
    - `value` string
  - `lastBuild` string, date-time
  - `lastUpdated` integer
  - `last_modified` integer
  - `last_modified_date` integer
  - `licenseInformation` LicenseInformation
    - `licenseName` string
  - `metadataFromEntry` DockstoreTool — recursive
  - `metadataFromVersion` Version — This describes a version of an entry in Dockstore
    - `aiTopicProcessed` boolean
    - `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
    - `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'
    - `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.
    - `workingDirectory` string
  - `metricsByPlatform` object
  - `mode` 'AUTO_DETECT_QUAY_TAGS_AUTOMATED_BUILDS' | 'AUTO_DETECT_QUAY_TAGS_WITH_MIXED' | 'MANUAL_IMAGE_PATH' | 'HOSTED'
  - `name` string
  - `namespace` string
  - `orcidAuthors` OrcidAuthor[] — ORCID authors for the entry, retrieved from the default version
    - `id` integer
    - `orcid` string
  - `output_file_formats` FileFormat[]
    - `value` string
  - `path` string
  - `private_access` boolean
  - `registry` 'QUAY_IO' | 'DOCKER_HUB' | 'GITLAB' | 'AMAZON_ECR' | 'SEVEN_BRIDGES' | 'GITHUB_CONTAINER_REGISTRY'
  - `registry_string` string
  - `starredUsers` 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.
  - `tags` Tag[]
    - `aiTopicProcessed` boolean
    - `author` string
    - `authors` Author[]
      - `affiliation` string
      - `email` string
      - `name` string
      - `role` string
    - `automated` boolean
    - `commitID` string
    - `cwl_path` 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
    - `dockerfile_path` string
    - `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
    - `image_id` string
    - `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
    - `last_built` integer
    - `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'
    - `size` integer
    - `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.
    - `wdl_path` string
    - `workingDirectory` string
  - `tool_maintainer_email` string
  - `tool_path` string
  - `toolname` string
  - `topic` string
  - `topicAI` string — Short description of the entry generated by AI
  - `topicAutomatic` string — Short description of the entry gotten automatically
  - `topicId` integer
  - `topicManual` string — Short description of the entry manually updated
  - `topicSelection` 'AUTOMATIC' | 'MANUAL' | 'AI' — Which topic to display to the public users
  - `trsId` string
  - `userIdToOrcidPutCode` object — The presence of the put code for a userid indicates the entry was exported to ORCID for the corresponding Dockstore user.
  - `users` 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.
  - `workflowVersions` Tag[]
    - `aiTopicProcessed` boolean
    - `author` string
    - `authors` Author[]
      - `affiliation` string
      - `email` string
      - `name` string
      - `role` string
    - `automated` boolean
    - `commitID` string
    - `cwl_path` 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
    - `dockerfile_path` string
    - `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
    - `image_id` string
    - `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
    - `last_built` integer
    - `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'
    - `size` integer
    - `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.
    - `wdl_path` string
    - `workingDirectory` string

## Changes

- **2025-12-09** `e7ba6b990428` — 4 info
  - added the optional property `metadataFromVersion/metricsByPlatform/additionalProperties/executionStatusCount/allOf[subschema #2]/count/additionalProperties/executionTimeHistogram` to the response with the `default` status
  - added the optional property `metricsByPlatform/additionalProperties/executionStatusCount/allOf[subschema #2]/count/additionalProperties/executionTimeHistogram` to the response with the `default` status
  - added the optional property `tags/items/metricsByPlatform/additionalProperties/executionStatusCount/allOf[subschema #2]/count/additionalProperties/executionTimeHistogram` to the response with the `default` status
  - added the optional property `workflowVersions/items/metricsByPlatform/additionalProperties/executionStatusCount/allOf[subschema #2]/count/additionalProperties/executionTimeHistogram` to the response with the `default` status
- …earlier changes not shown

[Full history](https://skmtc.dev/dockstore/apis/dockstore-api/changes/containers/:containerId/publish/post.md)

---

[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)