Early access: these pages are being written and reviewed. Facts in the header boxes come straight from the product.
List tasks
GET
/api/v1/tasks
const url = 'https://api.pitch2sale.com/api/v1/tasks?page=1&limit=25&status=open&type=task&priority=low&sort_by=due_date&sort_order=asc';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.pitch2sale.com/api/v1/tasks?page=1&limit=25&status=open&type=task&priority=low&sort_by=due_date&sort_order=asc' \ --header 'Authorization: Bearer <token>'Paginated. Limited to tasks the caller may view (assigned to them, their team, or all, by role).
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”page
number
limit
number
assigned_to
string
lead_id
string
project_id
string
is_complete
boolean
status
string
type
string
priority
string
due_from
string format: date-time
due_to
string format: date-time
sort_by
string
sort_order
string
Responses
Section titled “Responses”A page of tasks
Media typeapplication/json
object
tasks
required
Array<object>
object
_id
required
string
title
required
string
key
additional properties
any
total
required
number
page
required
number
limit
required
number
Examplegenerated
{ "tasks": [ { "_id": "example", "title": "example" } ], "total": 1, "page": 1, "limit": 1}Validation failed
Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Authentication required or token invalid
Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Feature not available on the organization plan
Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Role permission or token scope missing; OAuth app tokens are not accepted on this route
Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}Rate limit exceeded
Media typeapplication/json
object
error
required
string
code
string
message
string
details
Array<object>
object
field
required
string
message
required
string
code
required
string
Examplegenerated
{ "error": "example", "code": "example", "message": "example", "details": [ { "field": "example", "message": "example", "code": "example" } ]}