---
title: "Convert a Score specification, optional overrides, and extensions into the contents for a deployment set."
method: POST
path: "/orgs/{orgId}/artefact-versions/convert-score"
tags: ["public", "ArtefactVersion"]
---

# Convert a Score specification, optional overrides, and extensions into the contents for a deployment set.

`POST /orgs/{orgId}/artefact-versions/convert-score`

## Path parameters

- `orgId` string, required

## Request body

- ConvertScoreToSetBody — Request body for converting a Score manifest to Humanitec deployment set.
  - `spec` object, required — A Json object containing the workload specification. Score v1b1 is expected.
  - `image` string — An optional default image to assign to any containers in the workload that do not have an image set or whose image is '.'
  - `overrides` object — An optional Json object containing the workload overrides. Score v1b1 is expected.
  - `property_overrides` object — An optional set of path overrides that will be applied to the workload.
  - `resource_type_aliases` object — An optional set of resource types overrides that will be applied in the deployment set.
  - `extensions` ScoreHumanitecExtensions — Humanitec workload extensions for the Workload Artefact Version. These can be used to override the profile, or workload module spec and resource attributes.
    - `apiVersion` string, required — The api version describing the format of the extensions.
    - `profile` string — An optional override for the workload profile
    - `spec` object — A map of additional workload spec fields that will be merged.
    - `deploy` object — An optional deploy condition for the workload.
      - `when` 'before' | 'deploy' | 'after' — The stage the deployment should occur. "deploy", deployed in-parallel with other workloads (the default). "before", deployed before other workloads. "after", deployed after other workloads.
      - `success` 'deploy' | 'available' | 'complete' — The success criteria for the deployment. "deploy", workload deployed. "available", workload available. "complete", workload complete (often used with jobs).
      - `timeout` integer — The timeout in seconds for the deployment to reach it's success condition.

## Response `200`

The deployment set contents.

- WorkloadArtefactVersionDeploymentSet — Humanitec definition for a Workload Artefact.
  - `modules` object, required — The set of workloads to add when deployed, the key is the name of the workload.
  - `shared` object, required — The set of shared resources to depend on, the key is the resource identifier.

## Other responses

- `400` — Either one or more request body parameters are missing or invalid, or the requested payload is not provided or malformed.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)