To-dos
post/tasks

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.

Request body

Example request

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

Response

Successful operation

Example response

{
  "task": {
    "id": "6776881149498002015",
    "name": "Approve press release",
    "due_date": null,
    "status": "pending",
    "created_at": "2019-01-01T00:00:00.000Z",
    "body": "<p>Can you please approve the press release</p>",
    "position": 2,
    "updated_at": "2019-01-01T00:00:00.000Z",
    "product_id": "131414752",
    "assigned_to_users": [],
    "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/PRJ1-TODO-1",
    "resource": "https://company.aha.io/api/v1/tasks/PRJ1-TODO-1",
    "comments_count": 0,
    "custom_fields": [],
    "taskable": {
      "id": "1007868956",
      "type": "Feature",
      "reference_num": "PRJ1-1",
      "name": "Feature 1",
      "url": "https://company.aha.io/features/PRJ1-1",
      "resource": "https://company.aha.io/api/v1/features/PRJ1-1"
    }
  }
}

Changes