Share this page

# POST: Create an epic

The POST operation can be used to create an epic and associate it with the backlog.

In this topic:

## Identifying the backlog root

Each workspace has its own backlog, so the first step is to identify the ID for the backlog for the workspace.

You cannot create "orphan" epics. Each epic must have the Backlog as a parent.

In the following example, we see that the ID for the backlog is 1001.

    *** Request ***

    GET .../api/shared_spaces/{shared_space_uid}/workspaces/{workspace_id}/work_item_roots

    *** Response ***

    {
      "total_count": 1,
      "data": [
        {
          "type": "work_item_root",
          "id": "1001"

        }
      ],
      "exceeds_total_count": false
    }

Back to top

## Creating the epic

After identifying the root of the backlog, you can create the epic. The parent of the epic is the work_item_root whose ID is is 1001. This is the root of the backlog for this workspace.

    *** Request ***

    POST .../api/shared_spaces/<space_id>/workspaces/<workspace_id>/epics

    { "data": [
        {
          "description": "This is the description for my epic",
          "name": "MyEpic",
          "parent": {
            "type": "work_item_root",
            "id": "1001"
          }
        } ]

    }

    *** Response ***

    {
      "total_count": 1,
      "data": [
        {
          "type": "epic",
          "id": "1002"
        }
      ],
      "exceeds_total_count": false
    }

Back to top

https://admhelp.microfocus.com ALM Octane 8942
Tips to improve your search results... ALM Octane Help Center ALM Octane Help 15.1.90 All View Local Help Center View Online Help Center back Go back in browser history forward Go forward in browser history Remove search highlights next topic Go to next topic previous topic Go to previous topic Print the current topic Version: