SHshiprush
Epics

List epics

Epics belong to releases. This means that if you want to create one then you must scope it to a release.

You can list them all at once, or filter by release or product. All these means of listing epics can be further filtered by specific critera like name, modification date, tag, or assignee.

Once you have the id of a specific epic, you can inspect, modify, or delete them on the root epics resource.

get/epics

Request

  • Base URL
    https://company.aha.io/api/v1
  • Auth
    • OAuth 2
      Authorization codehttps://{account-domain}.aha.io/oauth/authorize
      Token URLhttps://{account-domain}.aha.io/oauth/token
    • or HTTP bearer
    • or API key in cookie session
  • TypeScript
    A function with typed inputs. Its response is checked against the schema.

Query parameters

pagestring
per_pagestring
custom_fieldsstring
fieldsstring
workflow_statusstring

Response

Successful operation

Example response

{
  "epics": [
    {
      "id": "362457003",
      "name": "And a third",
      "reference_num": "PRJ1-E-3",
      "created_at": "2019-01-01T00:00:00.000Z",
      "url": "https://company.aha.io/epics/PRJ1-E-3",
      "resource": "https://company.aha.io/api/v1/epics/PRJ1-E-3"
    },
    {
      "id": "580753216",
      "name": "Here's another epic",
      "reference_num": "PRJ1-E-2",
      "created_at": "2019-01-01T00:00:00.000Z",
      "url": "https://company.aha.io/epics/PRJ1-E-2",
      "resource": "https://company.aha.io/api/v1/epics/PRJ1-E-2"
    },
    {
      "id": "999605892",
      "name": "Epic 1",
      "reference_num": "PRJ1-E-1",
      "created_at": "2019-01-01T00:00:00.000Z",
      "url": "https://company.aha.io/epics/PRJ1-E-1",
      "resource": "https://company.aha.io/api/v1/epics/PRJ1-E-1"
    }
  ],
  "pagination": {
    "total_records": 3,
    "total_pages": 1,
    "current_page": 1
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.