RecordLinks API


GET /api/v1/features/:id/record_links

Get all record links for a feature

Parameters

Name Description
id * Numeric ID, or key of the feature

GET /api/v1/features/1007868956/record_links

Example CURL command

curl -g "https://company.aha.io/api/v1/features/1007868956/record_links" -X GET \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "record_links": [
    {
      "id": 170959948,
      "link_type": "Depends on",
      "link_type_id": 20,
      "created_at": "2019-01-01T00:00:00.000Z",
      "parent_record_type": "feature",
      "parent_record_id": 1007868956,
      "child_record_type": "feature",
      "child_record_id": 622562724,
      "parent": true,
      "parent_record": {
        "id": "1007868956",
        "reference_num": "PRJ1-1",
        "name": "Feature 1",
        "created_at": "2019-01-01T00:00:00.000Z",
        "url": "http://company.aha.io/features/PRJ1-1",
        "resource": "http://company.aha.io/api/v1/features/PRJ1-1",
        "product_id": 131414752
      },
      "child_record": {
        "id": "622562724",
        "reference_num": "PRJ1-2",
        "name": "Another Feature",
        "created_at": "2019-01-01T00:00:00.000Z",
        "url": "http://company.aha.io/features/PRJ1-2",
        "resource": "http://company.aha.io/api/v1/features/PRJ1-2",
        "product_id": 131414752
      }
    }
  ]
}

GET /api/v1/record_links/:id

Get specific record link

Parameters

Name Description
id * Numeric ID, or key of the record link to be retrieved

GET /api/v1/record_links/170959948

Example CURL command

curl -g "https://company.aha.io/api/v1/record_links/170959948" -X GET \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "record_link": {
    "id": 170959948,
    "link_type": "Depends on",
    "link_type_id": 20,
    "created_at": "2019-01-01T00:00:00.000Z",
    "parent_record_type": "feature",
    "parent_record_id": 1007868956,
    "child_record_type": "feature",
    "child_record_id": 622562724,
    "parent": true,
    "parent_record": {
      "id": "1007868956",
      "reference_num": "PRJ1-1",
      "name": "Feature 1",
      "created_at": "2019-01-01T00:00:00.000Z",
      "url": "http://company.aha.io/features/PRJ1-1",
      "resource": "http://company.aha.io/api/v1/features/PRJ1-1",
      "product_id": 131414752
    },
    "child_record": {
      "id": "622562724",
      "reference_num": "PRJ1-2",
      "name": "Another Feature",
      "created_at": "2019-01-01T00:00:00.000Z",
      "url": "http://company.aha.io/features/PRJ1-2",
      "resource": "http://company.aha.io/api/v1/features/PRJ1-2",
      "product_id": 131414752
    }
  }
}

POST /api/v1/features/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/features/1007868956/record_links

Example CURL command

curl "https://company.aha.io/api/v1/features/1007868956/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/master_features/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/master_features/999605892/record_links

Example CURL command

curl "https://company.aha.io/api/v1/master_features/999605892/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/releases/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/releases/278327321/record_links

Example CURL command

curl "https://company.aha.io/api/v1/releases/278327321/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/release_phases/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/release_phases/20526005/record_links

Example CURL command

curl "https://company.aha.io/api/v1/release_phases/20526005/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/ideas/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/ideas/58056975/record_links

Example CURL command

curl "https://company.aha.io/api/v1/ideas/58056975/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/goals/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/goals/602095703/record_links

Example CURL command

curl "https://company.aha.io/api/v1/goals/602095703/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/initiatives/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/initiatives/423077122/record_links

Example CURL command

curl "https://company.aha.io/api/v1/initiatives/423077122/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

POST /api/v1/pages/:id/record_links

Create a record link

                When creating a record link specify the <code>record_type</code>
                <code>record_id</code> and <code>link_type</code>.

Parameters

Name Description
record_type * Type of the record being linked to. One of Feature, Release, Idea, MasterFeature, ReleasePhase, Initiative, Page, StrategicImperative.
record_id * Id of the record being linked to.
link_type * Type of link, one of 10 = Relates to, 20 = depends on, 30 = duplicated by, 40 = contained by, 50 = impacted by, 60 = blocked by.

POST /api/v1/pages/1051981226/record_links

Example CURL command

curl "https://company.aha.io/api/v1/pages/1051981226/record_links" -d '{"record_link":{"record_type":"feature","record_id":303873333,"link_type":10}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "record_link": {
    "record_type": "feature",
    "record_id": 303873333,
    "link_type": 10
  }
}

Response

Status: 204 No Content
  

DELETE /api/v1/record_links/:id

Delete record link

Parameters

Name Description
id * Numeric ID, or key of the record link to be deleted

DELETE /api/v1/record_links/170959948

Example CURL command

curl "https://company.aha.io/api/v1/record_links/170959948" -d '' -X DELETE \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json

Response

Status: 204 No Content
  

Overview

API Resources