---
title: "Create a Draft Registration"
method: POST
path: "/draft_registrations/"
tags: ["Draft Registrations"]
---

# Create a Draft Registration

`POST /draft_registrations/`

This creates a Draft Registration that can be used to edit and register research.
Draft Registrations contain Registration questions that will become part of the Registration. A Registration is a frozen version of the project that can never be deleted, but can be withdrawn and have it's metadata edited.
A Draft Registration created by this endpoint will not have a Project linked with it by default, but if the user includes a `branched_from` attribute in their Draft Registration creation payload with the value of the `branched_from` being guid of a Project they have permissions for the Draft Registration will be linked to the Project. If you linked your Draft Registration on a Project, your original Project remains editable and will now have the Draft Registration linked to it. 
#### Permissions
Any user can create a Draft Registration. If the `branched_from` attribute is provided, then the user must be an ADMIN contributor on the Project being registered.
#### Required
Required fields for creating a Draft Registration include:

    `schema_id`
#### Returns
Returns a JSON object with a `data` key containing the representation of the created Draft Registration, if the request is successful.

If the request is unsuccessful, an `errors` key containing information about the failure will be returned. Refer to the [list of error codes](#tag/Errors-and-Error-Codes) to understand why this request may have failed.

## Request body

- object
  - `id` string, required — The unique identifier of the draft registration entity.
  - `type` string, required — The type identifier of the draft registration entity (`draft_registrations`).
  - `attributes` object, required — The properties of the Draft Registration entity.
    - `title` string — The title of the Draft Registration.
    - `description` string — The description of the Draft Registration.
    - `category` string — The category of the Draft Registration.
    - `tags` string[] — The searchable tags of the Draft Registration.
    - `node_license` object
      - `copyright_holders` string[] — A list of names of copyright holders for the license.
      - `year` integer — The year the copyright was made.
    - `current_user_permissions` string[] — The current users permission level for the Draft Registration.
    - `has_project` boolean — This indicates whether a Draft Registration was branched from a project.
    - `datetime_initiated` string, date-time — The time at which the draft registration was first initiated, as an iso8601 formatted timestamp.
    - `datetime_updated` string, date-time — The time at which the draft registration was last updated, as an iso8601 formatted timestamp.
    - `registration_metadata` object — This is a legacy format for `registration_responses`.
    - `registration_responses` object — A dictionary of question IDs and responses from the registration schema.
  - `relationships` object, required — URLs to other entities or entity collections that have a relationship to the draft registration entity.
    - `branched_from` string — A link to the node that this draft registration was created from.
    - `initiator` string — A link to the user who initiated the draft registration.
    - `registration_schema` string — A link to the detailed registration schema that this draft conforms to.
  - `links` object, required — URLs to alternative representations of the draft registration entity.
    - `html` string, URL, required — A link to the draft registration's page on the OSF.

## Response `201`

Created

---

[API](https://skmtc.net/osf/apis/osf-apiv2-documentation.md) · [All operations](https://skmtc.net/osf/apis/osf-apiv2-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/osf/osf-apiv2-documentation/versions/ca701048eb0d/schema)