To-dos API

Create a task

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 ID of the record the task belongs to

parent_type

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

  • Model
  • Competitor
  • Creative brief
  • Epic
  • Feature
  • Ideas feedback widget
  • Idea
  • Empathy session
  • Initiative
  • Sprint
  • Roll-up Release
  • Note template
  • Note
  • Vision component
  • Persona
  • Workspace
  • Vision
  • Presentation
  • Release
  • Release phase
  • Requirement
  • Goal
  • Goals chart
parent_id

The ID of the record the task belongs to

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"}]}}' -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

Sign up today!
Start your 30 day trial. No credit card required.
© 2022 Aha! Labs Inc.All rights reserved