Comments API

Comments can be added to and listed as a sub-resource on any resource that supports them. These resources support comments:

They can be listed product-wide, or retrieved from anywhere in the system using the root comments resource.

POST /api/v1/features/:feature_id/comments

Create a comment for a feature

Parameters

Name Description
feature_id * Numeric ID or key of the feature the comment should be created for

POST /api/v1/features/1007868956/comments

Example CURL command 

curl "https://company.aha.io/api/v1/features/1007868956/comments" -d '{"comment":{"body":"\u003cp\u003eThis is the comment body for a feature.\u003c/p\u003e"}}' -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
{
  "comment": {
    "body": "<p>This is the comment body for a feature.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "6778869984061628363",
    "body": "<p>This is the comment body for a feature.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [

    ],
    "url": "http://company.aha.io/comments/6778869984061628363",
    "resource": "http://company.aha.io/api/v1/comments/6778869984061628363",
    "commentable": {
      "type": "Feature",
      "id": "1007868956",
      "url": "http://company.aha.io/features/PRJ1-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/features/PRJ1-1"
    }
  }
}

POST /api/v1/master_features/:master_feature_id/comments

Create a comment for a master feature

Parameters

Name Description
master_feature_id * Numeric ID or key of the master feature feature the comment should be created for

POST /api/v1/master_features/999605892/comments

Example CURL command 

curl "https://company.aha.io/api/v1/master_features/999605892/comments" -d '{"comment":{"body":"\u003cp\u003eThis is the comment body for a master feature.\u003c/p\u003e"}}' -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
{
  "comment": {
    "body": "<p>This is the comment body for a master feature.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "6778869985176781887",
    "body": "<p>This is the comment body for a master feature.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [

    ],
    "url": "http://company.aha.io/comments/6778869985176781887",
    "resource": "http://company.aha.io/api/v1/comments/6778869985176781887",
    "commentable": {
      "type": "Epic",
      "id": "999605892",
      "url": "http://company.aha.io/epics/PRJ1-E-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/epics/PRJ1-E-1"
    }
  }
}

POST /api/v1/requirements/:requirement_id/comments

Create a comment for a requirement

Parameters

Name Description
requirement_id * Numeric ID or key of the requirement the comment should be created for

POST /api/v1/requirements/483368544/comments

Example CURL command 

curl "https://company.aha.io/api/v1/requirements/483368544/comments" -d '{"comment":{"body":"\u003cp\u003eThis is the comment body for a requirement.\u003c/p\u003e"}}' -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
{
  "comment": {
    "body": "<p>This is the comment body for a requirement.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "6778869986094136132",
    "body": "<p>This is the comment body for a requirement.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [

    ],
    "url": "http://company.aha.io/comments/6778869986094136132",
    "resource": "http://company.aha.io/api/v1/comments/6778869986094136132",
    "commentable": {
      "type": "Requirement",
      "id": "483368544",
      "url": "http://company.aha.io/requirements/PRJ1-1-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/requirements/PRJ1-1-1"
    }
  }
}

POST /api/v1/ideas/:idea_id/comments

Create a private comment for an idea

Parameters

Name Description
idea_id * Numeric ID or key of the idea the comment should be created for

POST /api/v1/ideas/58056975/comments

Example CURL command 

curl "https://company.aha.io/api/v1/ideas/58056975/comments" -d '{"comment":{"body":"\u003cp\u003eThis is the comment body for an idea.\u003c/p\u003e"}}' -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
{
  "comment": {
    "body": "<p>This is the comment body for an idea.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "6778869987584444517",
    "body": "<p>This is the comment body for an idea.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [

    ],
    "url": "http://company.aha.io/comments/6778869987584444517",
    "resource": "http://company.aha.io/api/v1/comments/6778869987584444517",
    "commentable": {
      "type": "Ideas::Idea",
      "id": "58056975",
      "url": "http://company.aha.io/ideas/ideas/PRJ1-I-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/ideas/ideas/PRJ1-I-1"
    }
  }
}

POST /api/v1/initiatives/:initiative_id/comments

Create a comment for an initiative

Parameters

Name Description
initiative_id * Numeric ID or key of the initiative the comment should be created for

POST /api/v1/initiatives/423077122/comments

Example CURL command 

curl "https://company.aha.io/api/v1/initiatives/423077122/comments" -d '{"comment":{"body":"\u003cp\u003eThis is the comment body for an initiative.\u003c/p\u003e"}}' -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
{
  "comment": {
    "body": "<p>This is the comment body for an initiative.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "6778869988535696223",
    "body": "<p>This is the comment body for an initiative.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [

    ],
    "url": "http://company.aha.io/comments/6778869988535696223",
    "resource": "http://company.aha.io/api/v1/comments/6778869988535696223",
    "commentable": {
      "type": "Initiative",
      "id": "423077122",
      "url": "http://company.aha.io/initiatives/PRJ1-S-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/initiatives/PRJ1-S-1"
    }
  }
}

POST /api/v1/goals/:goal_id/comments

Create a comment for a goal

Parameters

Name Description
goal_id * Numeric ID or key of the goal the comment should be created for

POST /api/v1/goals/602095703/comments

Example CURL command 

curl "https://company.aha.io/api/v1/goals/602095703/comments" -d '{"comment":{"body":"\u003cp\u003eThis is the comment body for a goal.\u003c/p\u003e"}}' -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
{
  "comment": {
    "body": "<p>This is the comment body for a goal.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "6778869989374349472",
    "body": "<p>This is the comment body for a goal.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [

    ],
    "url": "http://company.aha.io/comments/6778869989374349472",
    "resource": "http://company.aha.io/api/v1/comments/6778869989374349472",
    "commentable": {
      "type": "StrategicImperative",
      "id": "602095703",
      "url": "http://company.aha.io/strategic_imperatives/DEMOENT-G-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/goals/DEMOENT-G-1"
    }
  }
}

GET /api/v1/products/:project_id/comments

Get all comments on a product

Parameters

Name Description
project_id * Numeric ID of the product to get comments for

GET /api/v1/products/131414752/comments

Example CURL command 

curl -g "https://company.aha.io/api/v1/products/131414752/comments" -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
{
  "comments": [
    {
      "id": "55160124",
      "body": "Comment on project",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/55160124",
      "resource": "http://company.aha.io/api/v1/comments/55160124",
      "commentable": {
        "type": "Task",
        "id": "748715293",
        "url": "http://company.aha.io/tasks/748715293",
        "product_id": null,
        "resource": "http://company.aha.io/api/v1/tasks/748715293"
      }
    },
    {
      "id": "933135074",
      "body": "Comment on project",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [
        {
          "id": "744925247",
          "download_url": "http://company.aha.io/attachments/744925247/token/b88461b37c1c12673c93ab326cb94d7428480f65b246afd87eb5e9850d9c0c43.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "text/plain",
          "file_name": "uploaded_file_name.txt",
          "file_size": 123
        },
        {
          "id": "896530823",
          "download_url": "http://company.aha.io/attachments/896530823/token/aaabbbccc111223.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "application/pdf",
          "file_name": "google_doc.pdf",
          "file_size": null
        },
        {
          "id": "1005425561",
          "download_url": "http://company.aha.io/attachments/1005425561/token/627db25fbaf7c8a68e4981a79889b0e4a83c041e493b60b8e4830666b2f89514.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "application/pdf",
          "file_name": "dropbox_doc.pdf",
          "file_size": 677794
        },
        {
          "id": "793976649",
          "download_url": "http://company.aha.io/attachments/793976649/token/7d3600e242c8c48ea1f6cea9050580b3e6dd2ab7e1ab768a68e36e46d603d0e4.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "application/pdf",
          "file_name": "box_doc.pdf",
          "file_size": 677794
        },
        {
          "id": "109125418",
          "download_url": "http://company.aha.io/attachments/109125418/token/7eee35f6ca8c4d6886544306daee901ea7229daece8122af65048a00635adc33.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "application/pdf",
          "file_name": "google_doc.pdf",
          "file_size": 67794
        },
        {
          "id": "221084308",
          "download_url": "http://company.aha.io/attachments/221084308/token/eaabb9038534cddddc1a62c9741fd66f9394f8af78a4504e56724ed51d8a4e2c.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "image/png",
          "file_name": "Mockup.png",
          "file_size": 123
        },
        {
          "id": "229957526",
          "download_url": "http://company.aha.io/attachments/229957526/token/aaabbbccc111224.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "image/png",
          "file_name": "not-a-mockup.png",
          "file_size": 123
        }
      ],
      "url": "http://company.aha.io/comments/933135074",
      "resource": "http://company.aha.io/api/v1/comments/933135074",
      "commentable": {
        "type": "Project",
        "id": "131414752",
        "url": "http://company.aha.io/projects/PRJ1",
        "resource": "http://company.aha.io/api/v1/products/PRJ1"
      }
    },
    {
      "id": "781701978",
      "body": "Comment on feature",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [
        {
          "id": "822785180",
          "download_url": "http://company.aha.io/attachments/822785180/token/7691815d8586f097ece263afc80d28f474a04a53a4744ce4895da1479dfd3360.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "text/plain",
          "file_name": "uploaded_file_name.txt",
          "file_size": 123
        },
        {
          "id": "180276963",
          "download_url": "http://company.aha.io/attachments/180276963/token/b280e4df5408a8af207661407353142b54a5d7472d6fc9f11837a041e242560f.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "text/plain",
          "file_name": "uploaded_file_name.txt",
          "file_size": 123
        }
      ],
      "url": "http://company.aha.io/comments/781701978",
      "resource": "http://company.aha.io/api/v1/comments/781701978",
      "commentable": {
        "type": "Feature",
        "id": "1007868956",
        "url": "http://company.aha.io/features/PRJ1-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/features/PRJ1-1"
      }
    },
    {
      "id": "428925905",
      "body": "Comment on release",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "601067208",
        "name": "Jeremy Smith",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/428925905",
      "resource": "http://company.aha.io/api/v1/comments/428925905",
      "commentable": {
        "type": "Release",
        "id": "278327321",
        "url": "http://company.aha.io/releases/PRJ1-R-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/releases/PRJ1-R-1"
      }
    },
    {
      "id": "133461614",
      "body": "Comment on initiative",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "601067208",
        "name": "Jeremy Smith",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/133461614",
      "resource": "http://company.aha.io/api/v1/comments/133461614",
      "commentable": {
        "type": "Initiative",
        "id": "423077122",
        "url": "http://company.aha.io/initiatives/PRJ1-S-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/initiatives/PRJ1-S-1"
      }
    },
    {
      "id": "821249787",
      "body": "Comment on goal",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "601067208",
        "name": "Jeremy Smith",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/821249787",
      "resource": "http://company.aha.io/api/v1/comments/821249787",
      "commentable": {
        "type": "StrategicImperative",
        "id": "602095703",
        "url": "http://company.aha.io/strategic_imperatives/DEMOENT-G-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/goals/DEMOENT-G-1"
      }
    },
    {
      "id": "110125740",
      "body": "Comment on competitor 1",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/110125740",
      "resource": "http://company.aha.io/api/v1/comments/110125740",
      "commentable": {
        "type": "Competitor",
        "id": "892399625",
        "url": "http://company.aha.io/competitors/892399625",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/competitors/892399625"
      }
    },
    {
      "id": "340318108",
      "body": "This feature is integrated",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/340318108",
      "resource": "http://company.aha.io/api/v1/comments/340318108",
      "commentable": {
        "type": "Feature",
        "id": "303873333",
        "url": "http://company.aha.io/features/PRJ1-3",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/features/PRJ1-3"
      }
    },
    {
      "id": "971503243",
      "body": "This is a requirement comment",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/971503243",
      "resource": "http://company.aha.io/api/v1/comments/971503243",
      "commentable": {
        "type": "Requirement",
        "id": "483368544",
        "url": "http://company.aha.io/requirements/PRJ1-1-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/requirements/PRJ1-1-1"
      }
    }
  ],
  "pagination": {
    "total_records": 9,
    "total_pages": 1,
    "current_page": 1
  }
}

GET /api/v1/features/:feature_id/comments

Get all comments on a feature

Parameters

Name Description
feature_id * Numeric ID of the feature to get comments for

GET /api/v1/features/1007868956/comments

Example CURL command 

curl -g "https://company.aha.io/api/v1/features/1007868956/comments" -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
{
  "comments": [
    {
      "id": "781701978",
      "body": "Comment on feature",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [
        {
          "id": "822785180",
          "download_url": "http://company.aha.io/attachments/822785180/token/fdfb41eb15028d5ca4f2f1f6fbb2cf2edd9a6983fd12e534a83f855b4c5bbd5e.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "text/plain",
          "file_name": "uploaded_file_name.txt",
          "file_size": 123
        },
        {
          "id": "180276963",
          "download_url": "http://company.aha.io/attachments/180276963/token/7b76f67a1274b22840ca0ff54087a48247c4591b0ae5a11fd7be1fa3b131fa1a.download?size=original",
          "created_at": "2019-01-01T00:00:00.000Z",
          "updated_at": "2019-01-01T00:00:00.000Z",
          "content_type": "text/plain",
          "file_name": "uploaded_file_name.txt",
          "file_size": 123
        }
      ],
      "url": "http://company.aha.io/comments/781701978",
      "resource": "http://company.aha.io/api/v1/comments/781701978",
      "commentable": {
        "type": "Feature",
        "id": "1007868956",
        "url": "http://company.aha.io/features/PRJ1-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/features/PRJ1-1"
      }
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

GET /api/v1/requirements/:requirement_id/comments

Get all comments on a requirement

Parameters

Name Description
requirement_id * Numeric ID of the requirement to get comments for

GET /api/v1/requirements/483368544/comments

Example CURL command 

curl -g "https://company.aha.io/api/v1/requirements/483368544/comments" -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
{
  "comments": [
    {
      "id": "971503243",
      "body": "This is a requirement comment",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "1020675218",
        "name": "Mary Humpty",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/971503243",
      "resource": "http://company.aha.io/api/v1/comments/971503243",
      "commentable": {
        "type": "Requirement",
        "id": "483368544",
        "url": "http://company.aha.io/requirements/PRJ1-1-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/requirements/PRJ1-1-1"
      }
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

GET /api/v1/ideas/:idea_id/comments

Get all comments on an idea

Parameters

Name Description
idea_id * Numeric ID of the idea to get comments for

GET /api/v1/ideas/58056975/comments

Example CURL command 

curl -g "https://company.aha.io/api/v1/ideas/58056975/comments" -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
{
  "comments": [

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

GET /api/v1/initiatives/:initiative_id/comments

Get all comments on an initiative

Parameters

Name Description
initiative_id * Numeric ID of the initiative to get comments for

GET /api/v1/initiatives/423077122/comments

Example CURL command 

curl -g "https://company.aha.io/api/v1/initiatives/423077122/comments" -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
{
  "comments": [
    {
      "id": "133461614",
      "body": "Comment on initiative",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "601067208",
        "name": "Jeremy Smith",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/133461614",
      "resource": "http://company.aha.io/api/v1/comments/133461614",
      "commentable": {
        "type": "Initiative",
        "id": "423077122",
        "url": "http://company.aha.io/initiatives/PRJ1-S-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/initiatives/PRJ1-S-1"
      }
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

GET /api/v1/goals/:goal_id/comments

Get all comments on a goal

Parameters

Name Description
goal_id * Numeric ID of the goal to get comments for

GET /api/v1/goals/602095703/comments

Example CURL command 

curl -g "https://company.aha.io/api/v1/goals/602095703/comments" -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
{
  "comments": [
    {
      "id": "821249787",
      "body": "Comment on goal",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z",
      "user": {
        "id": "601067208",
        "name": "Jeremy Smith",
        "email": "no-reply@aha.io",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z"
      },
      "attachments": [

      ],
      "url": "http://company.aha.io/comments/821249787",
      "resource": "http://company.aha.io/api/v1/comments/821249787",
      "commentable": {
        "type": "StrategicImperative",
        "id": "602095703",
        "url": "http://company.aha.io/strategic_imperatives/DEMOENT-G-1",
        "product_id": 131414752,
        "resource": "http://company.aha.io/api/v1/goals/DEMOENT-G-1"
      }
    }
  ],
  "pagination": {
    "total_records": 1,
    "total_pages": 1,
    "current_page": 1
  }
}

PUT /api/v1/comments/:id

Update a comment

Parameters

Name Description
id * Numeric ID, or key of the comment to be edited

PUT /api/v1/comments/781701978

Example CURL command 

curl "https://company.aha.io/api/v1/comments/781701978" -d '{"comment":{"body":"\u003cp\u003eUpdated comment body.\u003c/p\u003e"}}' -X PUT \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request 

Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
Content-Type: application/json
Accept: application/json
{
  "comment": {
    "body": "<p>Updated comment body.</p>"
  }
}

Response 

Status: 200 OK
  Content-Type: application/json; charset=utf-8
{
  "comment": {
    "id": "781701978",
    "body": "<p>Updated comment body.</p>",
    "created_at": "2019-01-01T00:00:00.000Z",
    "updated_at": "2019-01-01T00:00:00.000Z",
    "user": {
      "id": "1020675218",
      "name": "Mary Humpty",
      "email": "no-reply@aha.io",
      "created_at": "2019-01-01T00:00:00.000Z",
      "updated_at": "2019-01-01T00:00:00.000Z"
    },
    "attachments": [
      {
        "id": "822785180",
        "download_url": "http://company.aha.io/attachments/822785180/token/47722516f452bfb6f8e6b05c4ed9ce2883ae227a8882dc5aada869ed0449fbf9.download?size=original",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z",
        "content_type": "text/plain",
        "file_name": "uploaded_file_name.txt",
        "file_size": 123
      },
      {
        "id": "180276963",
        "download_url": "http://company.aha.io/attachments/180276963/token/a6353f7ec126ad981fbdc0a208a87865c3e97818aaecfc3aec83c51fc42d610b.download?size=original",
        "created_at": "2019-01-01T00:00:00.000Z",
        "updated_at": "2019-01-01T00:00:00.000Z",
        "content_type": "text/plain",
        "file_name": "uploaded_file_name.txt",
        "file_size": 123
      }
    ],
    "url": "http://company.aha.io/comments/781701978",
    "resource": "http://company.aha.io/api/v1/comments/781701978",
    "commentable": {
      "type": "Feature",
      "id": "1007868956",
      "url": "http://company.aha.io/features/PRJ1-1",
      "product_id": 131414752,
      "resource": "http://company.aha.io/api/v1/features/PRJ1-1"
    }
  }
}

DELETE /api/v1/comments/:id

Delete comment

Parameters

Name Description
id * Numeric ID of the comment to be deleted

DELETE /api/v1/comments/55160124

Example CURL command 

curl "https://company.aha.io/api/v1/comments/55160124" -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