Working with draft entities

Whether drafts of work items (epics, features, user stories, and defects) can be created.

Use drafts to bypass validation business rules when POSTing work items via the API. This allows integrations using the API to quickly create work items without, for example, validating required fields.

Example: A partner is building a mobile app for submitting defects to ALM Octane. The mobile app shows a simple dialog with only the following fields: name, description, severity, and attachments. The app users can use this dialog to quickly submit defects, and fill it defect details later. If, however, ALM Octane has a business rule that makes some other field mandatory when Severity is Critical, the mobile app cannot be used as a quick and easy method for creating a defect. The solution is to use drafts for the initial defect submission by the mobile app, and later on edit the details when not using the mobile app.

To see which entities support the draft feature, get metadata for the entity. For details, see Drafts.

By default, when creating draft work items, the work items are automatically created as drafts.

POST .../api/shared_spaces/<shared_space_id>/workspaces/1002/defects
  "data": [{
      "subtype": "defect",
      "name": "Takes too long to load shopping cart."
       "parent": {
            "type": "work_item",
            "id": "1001"
      "is_draft": false