To-dos
put/tasks/{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

Request body

Example request

{
  "task": {
    "body": "<p>Can you please review this press release</p>"
  }
}

Response

Successful operation

Example response

{
  "task": {
    "id": "356548669",
    "name": "Work request",
    "due_date": "2019-01-01",
    "status": "pending",
    "created_at": "2019-01-01T00:00:00.000Z",
    "body": "Some simple work to be done",
    "position": 1,
    "updated_at": "2019-01-01T00:00:00.000Z",
    "product_id": "517761884",
    "assigned_to_products": [
      {
        "id": "909771936",
        "status": "pending",
        "completed_date": null,
        "product": {
          "id": "702241743",
          "reference_prefix": "PRJ3",
          "name": "Project 3"
        }
      }
    ],
    "created_by_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": "https://company.aha.io/tasks/356548669",
    "resource": "https://company.aha.io/api/v1/tasks/356548669",
    "comments_count": 0,
    "custom_fields": [],
    "taskable": {
      "id": "622562724",
      "type": "Feature",
      "reference_num": "PRJ1-2",
      "name": "Another Feature",
      "url": "https://company.aha.io/features/PRJ1-2",
      "resource": "https://company.aha.io/api/v1/features/PRJ1-2"
    }
  }
}

Changes

    • warning

      removed the optional property / from the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status