✅Tasks

Create/Update/Get/Delete tasks within your tenant and account.

After creating a task, you can also assign subtasks inside of it via the Subtasks API.

Create task

POST https://app.ninjapipe.com/v1/tasks/create

Creates a new task in your tenant.

Make sure to add API_KEY as a header. This is your API Key found in the API & Integrations page.

Create Task

post

/api/v1/tasks/create

Authorizations

Header parameters

API_KEYstring

Example: API_KEY

Body

object

Example: {"taskName":"Website Redesign","description":"Redesign the company homepage to improve user experience.","startDate":"2023-06-15T09:00:00","endDate":"2023-07-15T17:00:00","local_date":"2023-06-15T09:00:00","isCompleted":false}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://app.ninjapipe.com/api/v1/tasks/create' \
  --header 'Authorization: noauth YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"taskName":"Website Redesign","description":"Redesign the company homepage to improve user experience.","startDate":"2023-06-15T09:00:00","endDate":"2023-07-15T17:00:00","local_date":"2023-06-15T09:00:00","isCompleted":false}'

200

200

No body

Successful response

Update a task

PUThttps://app.ninjapipe.com/v1/tasks/{task_id}/update

Update Task

put

/api/v1/tasks/749/update

Authorizations

Header parameters

API_KEYstring

Example: API_KEY

Body

object

Example: {"taskName":"Website Redesign!","description":"Redesign the company homepage to improve user experience.","startDate":"2023-06-15T09:00:00","endDate":"2023-07-15T17:00:00","local_date":"2023-06-15T09:00:00","isCompleted":false}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://app.ninjapipe.com/api/v1/tasks/749/update' \
  --header 'Authorization: noauth YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"taskName":"Website Redesign!","description":"Redesign the company homepage to improve user experience.","startDate":"2023-06-15T09:00:00","endDate":"2023-07-15T17:00:00","local_date":"2023-06-15T09:00:00","isCompleted":false}'

200

200

No body

Successful response

Get task

GEThttps://app.ninjapipe.com/v1/tasks/getTaskById?id={task_id}

Get Task

get

/api/v1/tasks/getTaskById

Authorizations

Query parameters

idinteger

Example: 749

Header parameters

API_KEYstring

Example: API_KEY

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app.ninjapipe.com/api/v1/tasks/getTaskById' \
  --header 'Authorization: noauth YOUR_SECRET_TOKEN'

200

200

No body

Successful response

Get all tasks

GEThttps://app.ninjapipe.com/v1/tasks/getall

Parameters:

• getall?page=1 - Use this to paginate

Get Tasks

get

/api/v1/tasks/getall

Authorizations

Query parameters

pageinteger

Example: 1

Header parameters

API_KEYstring

Example: API_KEY

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://app.ninjapipe.com/api/v1/tasks/getall' \
  --header 'Authorization: noauth YOUR_SECRET_TOKEN'

200

200

No body

Successful response

Mark task as complete

GEThttps://app.ninjapipe.com/v1/tasks/{task_id}/saveCheckStatus

Mark Task Complete

put

/api/v1/tasks/749/saveCheckStatus

Authorizations

Header parameters

API_KEYstring

Example: API_KEY

Body

object

Example: {"isCompleted":true}

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url 'https://app.ninjapipe.com/api/v1/tasks/749/saveCheckStatus' \
  --header 'Authorization: noauth YOUR_SECRET_TOKEN' \
  --header 'Content-Type: application/json' \
  --data '{"isCompleted":true}'

200

200

No body

Successful response