AHaha
Epics

Get a specific epic

Changed on

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/{id}

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.

Path parameters

idstring required

Id identifier

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