---
title: "Create a new release candidate for one or more items."
method: POST
path: "/releasepackages/release/{wfid}"
tags: ["ReleasePackage"]
---

# Create a new release candidate for one or more items.

`POST /releasepackages/release/{wfid}`

This endpoint creates a release candidate with items added to it. It does <b>not</b> release the candidate. Once the release candidate is successfully created, use [updateReleasePackage](#/ReleasePackage/updateReleasePackage) to update all desired item/candidate properties, and transition it to the desired release state. See [API Guide: Release Management](https://onshape-public.github.io/docs/api-adv/relmgmt/) for examples. 
 
To add items from other documents, you must select `Allow adding items from other documents` in your [Release management settings](https://cad.onshape.com/help/Content/Plans/release_management_2.htm#rel_candidate_dialog).

## Path parameters

- `wfid` string, required

## Query parameters

- `debugMode` boolean

## Response `default`

default response

---

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