To-dos API

Create a to-do with a due date

POST /api/v1/tasks

Parameters
NameDescription
name *

The name of the task

body *

The description of the task

taskable_type

The type of record the task belongs to. taskable_type can be one of the following:

  • BusinessModel
  • Competitor
  • CreativeBrief
  • Epic
  • Feature
  • Ideas::FeedbackCampaign
  • Ideas::Idea
  • Ideas::IdeaSession
  • Initiative
  • Iteration
  • MasterRelease
  • NoteTemplate
  • Page
  • ProjectStrategyComponent
  • Persona
  • Project
  • ProjectStrategy
  • Publish::Notebook
  • Release
  • ReleasePhase
  • Requirement
  • StrategicImperative
  • StrategicImperativeBackground
taskable_id

The reference number or ID of the record the task belongs to

taskable_type

The type of record the task belongs to. taskable_type can be one of the following:

  • BusinessModel
  • Competitor
  • CreativeBrief
  • Epic
  • Feature
  • Ideas::FeedbackCampaign
  • Ideas::Idea
  • Ideas::IdeaSession
  • Initiative
  • Iteration
  • MasterRelease
  • NoteTemplate
  • Page
  • ProjectStrategyComponent
  • Persona
  • Project
  • ProjectStrategy
  • Publish::Notebook
  • Release
  • ReleasePhase
  • Requirement
  • StrategicImperative
  • StrategicImperativeBackground
taskable_id

The reference number or ID of the record the task belongs to

type

The type of the task. type can be one of the following:

  • Task
  • Approval
  • WorkRequest
assigned_to_users

Email addresses of assigned users

due_date

The date the task is due

Example request

POST /api/v1/tasks

Example CURL command

curl "https://company.aha.io/api/v1/tasks" -d '{"task":{"name":"Review press release","body":"\u003cp\u003eCan you please review the press release\u003c/p\u003e","assigned_to_users":[{"email":"no-reply@aha.io"}],"due_date":"2019-01-01"}}' -X POST \
	-H "Authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

authorization: Bearer 15b60d42d4bc417284a246ced6877b0bf13fb4aca415f7b55f7006bc3694a8ab
contentType: application/json
accept: application/json

Request body

Response

Status: 200 OK
contentType: application/json; charset=utf-8

Response body