Integration Fields API


POST /api/v1/features/:feature_id/integrations/:integration_id/fields

Create an integration field for a feature by integration id

Parameters

Name Description
feature_id * Numeric ID or key of the feature the integration field should be created for
integration_id * ID of integration the field is for

POST /api/v1/features/PRJ1-1/integrations/204584239/fields

Example CURL command

curl "https://account1.aha.io/api/v1/features/PRJ1-1/integrations/204584239/fields" -d '{"integration_field":{"name":"key","value":"JRA-34"}}' -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
{
  "integration_field": {
    "name": "key",
    "value": "JRA-34"
  }
}

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "integration_field": {
    "id": "728894778",
    "name": "key",
    "value": "JRA-34",
    "integration_id": 204584239,
    "service_name": "jira",
    "created_at": "2018-10-22T20:28:57.000Z",
    "integratable": {
      "url": "http://account1.example.org/features/PRJ1-1",
      "resource": "http://account1.example.org/api/v1/features/PRJ1-1"
    }
  }
}

POST /api/v1/features/:feature_id/integrations/:integration_id/fields

Create multiple integration fields for a feature by integration id

Parameters

Name Description
feature_id * Numeric ID or key of the feature the integration field should be created for
integration_id * ID of integration the field is for

POST /api/v1/features/PRJ1-1/integrations/204584239/fields

Example CURL command

curl "https://account1.aha.io/api/v1/features/PRJ1-1/integrations/204584239/fields" -d '{"integration_fields":[{"name":"key","value":"JRA-34"},{"name":"id","value":"34"}]}' -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
{
  "integration_fields": [
    {
      "name": "key",
      "value": "JRA-34"
    },
    {
      "name": "id",
      "value": "34"
    }
  ]
}

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
[
  728894778,
  846945422
]

POST /api/v1/features/:feature_id/integrations/:service_name/fields

Create an integration field for a feature by service name

DEPRECATED: pass :integration_id rather than :service_name to identify the integration.

Parameters

Name Description
feature_id * Numeric ID or key of the feature the integration field should be created for
service_name * Name of the integration service the field is for

POST /api/v1/features/PRJ1-1/integrations/jira/fields

Example CURL command

curl "https://account1.aha.io/api/v1/features/PRJ1-1/integrations/jira/fields" -d '{"integration_field":{"name":"key","value":"JRA-34"}}' -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
{
  "integration_field": {
    "name": "key",
    "value": "JRA-34"
  }
}

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "integration_field": {
    "id": "6615281147390445822",
    "name": "key",
    "value": "JRA-34",
    "integration_id": 413207847,
    "service_name": "jira",
    "created_at": "2018-10-22T20:29:27.495Z",
    "integratable": {
      "url": "http://account1.example.org/features/PRJ1-1",
      "resource": "http://account1.example.org/api/v1/features/PRJ1-1"
    }
  }
}

POST /api/v1/features/:feature_id/integrations/:service_name/fields

Create multiple integration fields for a feature by service name

DEPRECATED: pass :integration_id rather than :service_name to identify the integration.

Parameters

Name Description
feature_id * Numeric ID or key of the feature the integration field should be created for
service_name * Name of the integration service the field is for

POST /api/v1/features/PRJ1-1/integrations/jira/fields

Example CURL command

curl "https://account1.aha.io/api/v1/features/PRJ1-1/integrations/jira/fields" -d '{"integration_fields":[{"name":"key","value":"JRA-34"},{"name":"id","value":"34"}]}' -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
{
  "integration_fields": [
    {
      "name": "key",
      "value": "JRA-34"
    },
    {
      "name": "id",
      "value": "34"
    }
  ]
}

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
[
  "6615281147913150125",
  "6615281147986682543"
]

POST /api/v1/idea_endorsements/:idea_endorsement_id/integrations/:integration_id/fields

Create an integration field for an idea endorsement

Parameters

Name Description
idea_endorsement_id * Numeric ID of the idea endorsement the integration field should be created for
integration_id * ID of integration the field is for

POST /api/v1/idea_endorsements/53377392/integrations/204584239/fields

Example CURL command

curl "https://account1.aha.io/api/v1/idea_endorsements/53377392/integrations/204584239/fields" -d '{"integration_field":{"name":"key","value":"JRA-34"}}' -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
{
  "integration_field": {
    "name": "key",
    "value": "JRA-34"
  }
}

Response

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "integration_field": {
    "id": "975466318",
    "name": "key",
    "value": "JRA-34",
    "integration_id": 204584239,
    "service_name": "jira",
    "created_at": "2018-10-22T20:28:57.000Z",
    "integratable": {
      "url": "http://account1.example.org/ideas/idea_endorsements/53377392",
      "resource": "http://account1.example.org/api/v1/ideas/idea_endorsements/53377392"
    }
  }
}

GET /api/v1/features/:feature_id/integrations/:integration_id/fields/:field_name

Get an integration field value

Parameters

Name Description
feature_id * Numeric ID or key of the feature the integration field belongs to
integration_id * ID of integration the field is for
field_name * Name of the field to retrieve

GET /api/v1/features/PRJ1-1/integrations/204584239/fields/key

Example CURL command

curl -g "https://account1.aha.io/api/v1/features/PRJ1-1/integrations/204584239/fields/key" -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
{
  "integration_field": {
    "id": "728894778",
    "name": "key",
    "value": "JRA-123",
    "integration_id": 204584239,
    "service_name": "jira",
    "created_at": "2018-10-22T20:28:57.000Z",
    "integratable": {
      "url": "http://account1.example.org/features/PRJ1-1",
      "resource": "http://account1.example.org/api/v1/features/PRJ1-1"
    }
  }
}

GET /api/v1/integrations/:integration_id/fields/:field_name/value/:field_value

Find objects (releases, initiatives, features, master_features, requirements or idea endorsements) based on an integration field value

Parameters

Name Description
integration_id * ID of integration the field belongs to
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/integrations/204584239/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/integrations/204584239/fields/key/value/JRA-123" -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
{
  "records": [
    {
      "idea_endorsement": {
        "integration_id": 204584239,
        "id": "53377392",
        "idea_id": "58056975",
        "created_at": "2018-10-22T20:28:57.000Z",
        "value": null,
        "endorsed_by_portal_user": {
          "id": "646391926",
          "name": "John Long",
          "email": "john@long.com",
          "created_at": "2018-10-22T20:28:57.000Z"
        },
        "integration_fields": [
          {
            "id": "975466318",
            "name": "key",
            "value": "JRA-123",
            "integration_id": 204584239,
            "service_name": "jira",
            "created_at": "2018-10-22T20:28:57.000Z"
          }
        ],
        "idea": {
          "id": "58056975",
          "reference_num": "PRJ1-I-1",
          "name": "Idea 1",
          "created_at": "2018-10-22T20:28:58.000Z",
          "workflow_status": {
            "id": "3259216",
            "name": "New",
            "position": 1,
            "complete": false,
            "color": "#dce7c6"
          },
          "description": {
            "id": "103757394",
            "body": "Description of idea 1",
            "created_at": "2018-10-22T20:28:58.000Z",
            "attachments": [

            ]
          },
          "url": "http://account1.example.org/ideas/ideas/PRJ1-I-1",
          "resource": "http://account1.example.org/api/v1/ideas/PRJ1-I-1"
        }
      }
    },
    {
      "feature": {
        "integration_id": 204584239,
        "id": "1007868956",
        "name": "Feature 1",
        "reference_num": "PRJ1-1",
        "position": 1,
        "score": 0,
        "created_at": "2018-10-22T20:28:58.000Z",
        "updated_at": "2018-10-22T20:28:58.000Z",
        "start_date": null,
        "due_date": null,
        "product_id": 131414752,
        "workflow_kind": {
          "id": "98484309",
          "name": "New"
        },
        "workflow_status": {
          "id": "934242751",
          "name": "New",
          "position": 1,
          "complete": false,
          "color": "#dce7c6"
        },
        "description": {
          "id": "793547626",
          "body": "Body of note 1",
          "created_at": "2018-10-22T20:28:58.000Z",
          "attachments": [
            {
              "id": "724655692",
              "download_url": "http://account1.lvh.me/attachments/724655692/token/64b218daffc693c0b2ce0f2a4cd547f210d6e4299004beacc3749aa2cd0e2d69.download?size=original",
              "created_at": "2018-10-22T20:28:57.000Z",
              "updated_at": "2018-10-22T20:29:27.893Z",
              "file_size": 123,
              "content_type": "text/plain",
              "file_name": "uploaded_file_name.txt"
            }
          ]
        },
        "attachments": [
          {
            "id": "180276963",
            "download_url": "http://account1.lvh.me/attachments/180276963/token/c4fb989ecff6c33754eba8d905e7236f6c44abbdbba4fafaae8621f7346d3a41.download?size=original",
            "created_at": "2018-10-22T20:28:57.000Z",
            "updated_at": "2018-10-22T20:29:27.931Z",
            "file_size": 123,
            "content_type": "text/plain",
            "file_name": "uploaded_file_name.txt"
          }
        ],
        "integration_fields": [
          {
            "id": "846945422",
            "name": "id",
            "value": "435",
            "integration_id": 204584239,
            "service_name": "jira",
            "created_at": "2018-10-22T20:28:57.000Z"
          },
          {
            "id": "728894778",
            "name": "key",
            "value": "JRA-123",
            "integration_id": 204584239,
            "service_name": "jira",
            "created_at": "2018-10-22T20:28:57.000Z"
          }
        ],
        "url": "http://account1.example.org/features/PRJ1-1",
        "resource": "http://account1.example.org/api/v1/features/PRJ1-1",
        "release": {
          "id": "278327321",
          "reference_num": "PRJ1-R-1",
          "name": "Release 1",
          "start_date": "2018-10-29",
          "release_date": "2018-10-29",
          "parking_lot": false,
          "created_at": "2018-10-22T20:28:57.000Z",
          "product_id": 131414752,
          "integration_fields": [
            {
              "id": "68217473",
              "name": "id",
              "value": "777",
              "integration_id": 204584239,
              "service_name": "jira",
              "created_at": "2018-10-22T20:28:57.000Z"
            }
          ],
          "url": "http://account1.example.org/releases/PRJ1-R-1",
          "resource": "http://account1.example.org/api/v1/releases/PRJ1-R-1",
          "owner": {
            "id": "16338845",
            "name": "John Smith",
            "email": "john.smith@account1.com",
            "created_at": "2018-10-22T20:28:57.000Z",
            "updated_at": "2018-10-22T20:28:57.000Z"
          },
          "project": {
            "id": "131414752",
            "reference_prefix": "PRJ1",
            "name": "Project 1",
            "product_line": false,
            "created_at": "2018-10-22T20:28:58.000Z"
          }
        },
        "master_feature": {
          "id": "999605892",
          "reference_num": "PRJ1-E-1",
          "name": "Epic 1",
          "created_at": "2018-10-22T20:28:57.000Z",
          "url": "http://account1.example.org/epics/PRJ1-E-1",
          "resource": "http://account1.example.org/api/v1/master_features/PRJ1-E-1"
        },
        "created_by_user": {
          "id": "16338845",
          "name": "John Smith",
          "email": "john.smith@account1.com",
          "created_at": "2018-10-22T20:28:57.000Z",
          "updated_at": "2018-10-22T20:28:57.000Z"
        },
        "assigned_to_user": {
          "id": "16338845",
          "name": "John Smith",
          "email": "john.smith@account1.com",
          "created_at": "2018-10-22T20:28:57.000Z",
          "updated_at": "2018-10-22T20:28:57.000Z",
          "default_assignee": false
        },
        "requirements": [
          {
            "id": "483368544",
            "name": "Body of requirement 1",
            "reference_num": "PRJ1-1-1",
            "position": 1,
            "created_at": "2018-10-22T20:28:58.000Z",
            "updated_at": "2018-10-22T20:28:58.000Z",
            "release_id": 278327321,
            "workflow_status": {
              "id": "934242751",
              "name": "New",
              "position": 1,
              "complete": false,
              "color": "#dce7c6"
            },
            "url": "http://account1.example.org/requirements/PRJ1-1-1",
            "resource": "http://account1.example.org/api/v1/requirements/PRJ1-1-1",
            "description": {
              "id": "910541534",
              "body": "Body of requirement 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "attachments": [

              ]
            },
            "feature": {
              "id": "1007868956",
              "reference_num": "PRJ1-1",
              "name": "Feature 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "url": "http://account1.example.org/features/PRJ1-1",
              "resource": "http://account1.example.org/api/v1/features/PRJ1-1",
              "product_id": 131414752
            },
            "assigned_to_user": {
              "id": "689956296",
              "name": "Henry Humpty",
              "email": "henry.humpty@account1.com",
              "created_at": "2018-10-22T20:28:57.000Z",
              "updated_at": "2018-10-22T20:28:57.000Z",
              "default_assignee": true
            },
            "created_by_user": {
              "id": "1020675218",
              "name": "Mary Humpty",
              "email": "mary.humpty@account1.com",
              "created_at": "2018-10-22T20:28:57.000Z",
              "updated_at": "2018-10-22T20:28:57.000Z"
            },
            "attachments": [

            ],
            "custom_fields": [
              {
                "key": "expected_completion_date",
                "name": "Expected completion date",
                "value": null,
                "type": "date"
              }
            ],
            "integration_fields": [
              {
                "id": "417785887",
                "name": "id",
                "value": "991",
                "integration_id": 342659513,
                "service_name": "jira",
                "created_at": "2018-10-22T20:28:57.000Z"
              },
              {
                "id": "32487847",
                "name": "key",
                "value": "JRA-987",
                "integration_id": 342659513,
                "service_name": "jira",
                "created_at": "2018-10-22T20:28:57.000Z"
              }
            ],
            "comments_count": 1
          }
        ],
        "initiative": {
          "id": "423077122",
          "name": "Initiative 1",
          "url": "http://account1.example.org/initiatives/423077122",
          "resource": "http://account1.example.org/api/v1/initiatives/423077122",
          "created_at": "2018-10-22T20:28:57.000Z",
          "description": {
            "id": "673273729",
            "body": "Description of initiative 1",
            "created_at": "2018-10-22T20:28:58.000Z",
            "attachments": [

            ]
          },
          "integration_fields": [
            {
              "id": "213995437",
              "name": "id",
              "value": "9913333",
              "integration_id": 342659513,
              "service_name": "jira",
              "created_at": "2018-10-22T20:28:57.000Z"
            },
            {
              "id": "365436441",
              "name": "key",
              "value": "JRA-987222",
              "integration_id": 342659513,
              "service_name": "jira",
              "created_at": "2018-10-22T20:28:57.000Z"
            }
          ]
        },
        "goals": [
          {
            "id": "602095703",
            "name": "Goal 1",
            "url": "http://account1.example.org/strategic_imperatives/602095703",
            "resource": "http://account1.example.org/api/v1/goals/602095703",
            "created_at": "2018-10-22T20:28:57.000Z",
            "description": {
              "id": "166463080",
              "body": "Description of goal 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "attachments": [

              ]
            }
          }
        ],
        "comments_count": 1,
        "score_facts": [

        ],
        "tags": [
          "Engineering",
          "Infrastructure"
        ],
        "full_tags": [
          {
            "id": 3412727,
            "name": "Engineering",
            "color": "#e09052"
          },
          {
            "id": 775582684,
            "name": "Infrastructure",
            "color": "#7552e0"
          }
        ],
        "custom_fields": [
          {
            "key": "expected_completion_date",
            "name": "Expected completion date",
            "value": null,
            "type": "date"
          }
        ],
        "feature_links": [
          {
            "link_type": "Depends on",
            "link_type_id": 20,
            "created_at": "2018-10-22T20:28:58.000Z",
            "parent_record": {
              "id": "1007868956",
              "reference_num": "PRJ1-1",
              "name": "Feature 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "url": "http://account1.example.org/features/PRJ1-1",
              "resource": "http://account1.example.org/api/v1/features/PRJ1-1",
              "product_id": 131414752
            },
            "child_record": {
              "id": "622562724",
              "reference_num": "PRJ1-2",
              "name": "Another Feature",
              "created_at": "2018-10-22T20:28:58.000Z",
              "url": "http://account1.example.org/features/PRJ1-2",
              "resource": "http://account1.example.org/api/v1/features/PRJ1-2",
              "product_id": 131414752
            }
          }
        ],
        "feature_only_original_estimate": null,
        "feature_only_remaining_estimate": null,
        "feature_only_work_done": null
      }
    }
  ],
  "pagination": {
    "total_records": 2,
    "total_pages": 1,
    "current_page": 1
  }
}

GET /api/v1/releases/fields/:field_name/value/:field_value

Find objects based on integration field value

Parameters

Name Description
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/releases/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/releases/fields/key/value/JRA-123" -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
{
  "records": [

  ],
  "pagination": {
    "total_records": 0,
    "total_pages": 0,
    "current_page": 1
  }
}

GET /api/v1/initiatives/fields/:field_name/value/:field_value

Find objects based on integration field value

Parameters

Name Description
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/initiatives/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/initiatives/fields/key/value/JRA-123" -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
{
  "records": [

  ],
  "pagination": {
    "total_records": 0,
    "total_pages": 0,
    "current_page": 1
  }
}

GET /api/v1/features/fields/:field_name/value/:field_value

Find objects based on integration field value

Parameters

Name Description
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/features/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/features/fields/key/value/JRA-123" -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
{
  "records": [
    {
      "feature": {
        "integration_id": 204584239,
        "id": "1007868956",
        "name": "Feature 1",
        "reference_num": "PRJ1-1",
        "position": 1,
        "score": 0,
        "created_at": "2018-10-22T20:28:58.000Z",
        "updated_at": "2018-10-22T20:28:58.000Z",
        "start_date": null,
        "due_date": null,
        "product_id": 131414752,
        "workflow_kind": {
          "id": "98484309",
          "name": "New"
        },
        "workflow_status": {
          "id": "934242751",
          "name": "New",
          "position": 1,
          "complete": false,
          "color": "#dce7c6"
        },
        "description": {
          "id": "793547626",
          "body": "Body of note 1",
          "created_at": "2018-10-22T20:28:58.000Z",
          "attachments": [
            {
              "id": "724655692",
              "download_url": "http://account1.lvh.me/attachments/724655692/token/a99626c2ab9430fe1ee80c5c0ffc80aaeede9795d9ef99d84be6cb3effdbf911.download?size=original",
              "created_at": "2018-10-22T20:28:57.000Z",
              "updated_at": "2018-10-22T20:29:28.174Z",
              "file_size": 123,
              "content_type": "text/plain",
              "file_name": "uploaded_file_name.txt"
            }
          ]
        },
        "attachments": [
          {
            "id": "180276963",
            "download_url": "http://account1.lvh.me/attachments/180276963/token/01dc4d7cfbfbb189902195966e00845285b542d3757a2cbc81f5c3b140715832.download?size=original",
            "created_at": "2018-10-22T20:28:57.000Z",
            "updated_at": "2018-10-22T20:29:28.211Z",
            "file_size": 123,
            "content_type": "text/plain",
            "file_name": "uploaded_file_name.txt"
          }
        ],
        "integration_fields": [
          {
            "id": "846945422",
            "name": "id",
            "value": "435",
            "integration_id": 204584239,
            "service_name": "jira",
            "created_at": "2018-10-22T20:28:57.000Z"
          },
          {
            "id": "728894778",
            "name": "key",
            "value": "JRA-123",
            "integration_id": 204584239,
            "service_name": "jira",
            "created_at": "2018-10-22T20:28:57.000Z"
          }
        ],
        "url": "http://account1.example.org/features/PRJ1-1",
        "resource": "http://account1.example.org/api/v1/features/PRJ1-1",
        "release": {
          "id": "278327321",
          "reference_num": "PRJ1-R-1",
          "name": "Release 1",
          "start_date": "2018-10-29",
          "release_date": "2018-10-29",
          "parking_lot": false,
          "created_at": "2018-10-22T20:28:57.000Z",
          "product_id": 131414752,
          "integration_fields": [
            {
              "id": "68217473",
              "name": "id",
              "value": "777",
              "integration_id": 204584239,
              "service_name": "jira",
              "created_at": "2018-10-22T20:28:57.000Z"
            }
          ],
          "url": "http://account1.example.org/releases/PRJ1-R-1",
          "resource": "http://account1.example.org/api/v1/releases/PRJ1-R-1",
          "owner": {
            "id": "16338845",
            "name": "John Smith",
            "email": "john.smith@account1.com",
            "created_at": "2018-10-22T20:28:57.000Z",
            "updated_at": "2018-10-22T20:28:57.000Z"
          },
          "project": {
            "id": "131414752",
            "reference_prefix": "PRJ1",
            "name": "Project 1",
            "product_line": false,
            "created_at": "2018-10-22T20:28:58.000Z"
          }
        },
        "master_feature": {
          "id": "999605892",
          "reference_num": "PRJ1-E-1",
          "name": "Epic 1",
          "created_at": "2018-10-22T20:28:57.000Z",
          "url": "http://account1.example.org/epics/PRJ1-E-1",
          "resource": "http://account1.example.org/api/v1/master_features/PRJ1-E-1"
        },
        "created_by_user": {
          "id": "16338845",
          "name": "John Smith",
          "email": "john.smith@account1.com",
          "created_at": "2018-10-22T20:28:57.000Z",
          "updated_at": "2018-10-22T20:28:57.000Z"
        },
        "assigned_to_user": {
          "id": "16338845",
          "name": "John Smith",
          "email": "john.smith@account1.com",
          "created_at": "2018-10-22T20:28:57.000Z",
          "updated_at": "2018-10-22T20:28:57.000Z",
          "default_assignee": false
        },
        "requirements": [
          {
            "id": "483368544",
            "name": "Body of requirement 1",
            "reference_num": "PRJ1-1-1",
            "position": 1,
            "created_at": "2018-10-22T20:28:58.000Z",
            "updated_at": "2018-10-22T20:28:58.000Z",
            "release_id": 278327321,
            "workflow_status": {
              "id": "934242751",
              "name": "New",
              "position": 1,
              "complete": false,
              "color": "#dce7c6"
            },
            "url": "http://account1.example.org/requirements/PRJ1-1-1",
            "resource": "http://account1.example.org/api/v1/requirements/PRJ1-1-1",
            "description": {
              "id": "910541534",
              "body": "Body of requirement 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "attachments": [

              ]
            },
            "feature": {
              "id": "1007868956",
              "reference_num": "PRJ1-1",
              "name": "Feature 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "url": "http://account1.example.org/features/PRJ1-1",
              "resource": "http://account1.example.org/api/v1/features/PRJ1-1",
              "product_id": 131414752
            },
            "assigned_to_user": {
              "id": "689956296",
              "name": "Henry Humpty",
              "email": "henry.humpty@account1.com",
              "created_at": "2018-10-22T20:28:57.000Z",
              "updated_at": "2018-10-22T20:28:57.000Z",
              "default_assignee": true
            },
            "created_by_user": {
              "id": "1020675218",
              "name": "Mary Humpty",
              "email": "mary.humpty@account1.com",
              "created_at": "2018-10-22T20:28:57.000Z",
              "updated_at": "2018-10-22T20:28:57.000Z"
            },
            "attachments": [

            ],
            "custom_fields": [
              {
                "key": "expected_completion_date",
                "name": "Expected completion date",
                "value": null,
                "type": "date"
              }
            ],
            "integration_fields": [
              {
                "id": "417785887",
                "name": "id",
                "value": "991",
                "integration_id": 342659513,
                "service_name": "jira",
                "created_at": "2018-10-22T20:28:57.000Z"
              },
              {
                "id": "32487847",
                "name": "key",
                "value": "JRA-987",
                "integration_id": 342659513,
                "service_name": "jira",
                "created_at": "2018-10-22T20:28:57.000Z"
              }
            ],
            "comments_count": 1
          }
        ],
        "initiative": {
          "id": "423077122",
          "name": "Initiative 1",
          "url": "http://account1.example.org/initiatives/423077122",
          "resource": "http://account1.example.org/api/v1/initiatives/423077122",
          "created_at": "2018-10-22T20:28:57.000Z",
          "description": {
            "id": "673273729",
            "body": "Description of initiative 1",
            "created_at": "2018-10-22T20:28:58.000Z",
            "attachments": [

            ]
          },
          "integration_fields": [
            {
              "id": "213995437",
              "name": "id",
              "value": "9913333",
              "integration_id": 342659513,
              "service_name": "jira",
              "created_at": "2018-10-22T20:28:57.000Z"
            },
            {
              "id": "365436441",
              "name": "key",
              "value": "JRA-987222",
              "integration_id": 342659513,
              "service_name": "jira",
              "created_at": "2018-10-22T20:28:57.000Z"
            }
          ]
        },
        "goals": [
          {
            "id": "602095703",
            "name": "Goal 1",
            "url": "http://account1.example.org/strategic_imperatives/602095703",
            "resource": "http://account1.example.org/api/v1/goals/602095703",
            "created_at": "2018-10-22T20:28:57.000Z",
            "description": {
              "id": "166463080",
              "body": "Description of goal 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "attachments": [

              ]
            }
          }
        ],
        "comments_count": 1,
        "score_facts": [

        ],
        "tags": [
          "Engineering",
          "Infrastructure"
        ],
        "full_tags": [
          {
            "id": 3412727,
            "name": "Engineering",
            "color": "#e09052"
          },
          {
            "id": 775582684,
            "name": "Infrastructure",
            "color": "#7552e0"
          }
        ],
        "custom_fields": [
          {
            "key": "expected_completion_date",
            "name": "Expected completion date",
            "value": null,
            "type": "date"
          }
        ],
        "feature_links": [
          {
            "link_type": "Depends on",
            "link_type_id": 20,
            "created_at": "2018-10-22T20:28:58.000Z",
            "parent_record": {
              "id": "1007868956",
              "reference_num": "PRJ1-1",
              "name": "Feature 1",
              "created_at": "2018-10-22T20:28:58.000Z",
              "url": "http://account1.example.org/features/PRJ1-1",
              "resource": "http://account1.example.org/api/v1/features/PRJ1-1",
              "product_id": 131414752
            },
            "child_record": {
              "id": "622562724",
              "reference_num": "PRJ1-2",
              "name": "Another Feature",
              "created_at": "2018-10-22T20:28:58.000Z",
              "url": "http://account1.example.org/features/PRJ1-2",
              "resource": "http://account1.example.org/api/v1/features/PRJ1-2",
              "product_id": 131414752
            }
          }
        ],
        "feature_only_original_estimate": null,
        "feature_only_remaining_estimate": null,
        "feature_only_work_done": null
      }
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

GET /api/v1/master_features/fields/:field_name/value/:field_value

Find objects based on integration field value

Parameters

Name Description
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/master_features/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/master_features/fields/key/value/JRA-123" -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
{
  "records": [

  ],
  "pagination": {
    "total_records": 0,
    "total_pages": 0,
    "current_page": 1
  }
}

GET /api/v1/requirements/fields/:field_name/value/:field_value

Find objects based on integration field value

Parameters

Name Description
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/requirements/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/requirements/fields/key/value/JRA-123" -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
{
  "records": [

  ],
  "pagination": {
    "total_records": 0,
    "total_pages": 0,
    "current_page": 1
  }
}

GET /api/v1/idea_endorsements/fields/:field_name/value/:field_value

Find objects based on integration field value

Parameters

Name Description
field_name * Integration fields to search for the value
field_value * Value that matching objects must have in the integration field

GET /api/v1/idea_endorsements/fields/key/value/JRA-123

Example CURL command

curl -g "https://account1.aha.io/api/v1/idea_endorsements/fields/key/value/JRA-123" -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
{
  "records": [

  ],
  "pagination": {
    "total_records": 0,
    "total_pages": 0,
    "current_page": 1
  }
}

DELETE /api/v1/integration_fields/:id

Delete an integration field

Parameters

Name Description
id * Numeric ID of the integration field to be deleted

DELETE /api/v1/integration_fields/728894778

Example CURL command

curl "https://account1.aha.io/api/v1/integration_fields/728894778" -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