Projects
Last updated
Last updated
The projects
namespace provides API methods to retrieve all or specific projects a user has access to. This page covers the following API methods:
/projects
Returns all projects (a user has access to).
This method uses pagination so you might need to request additional pages to retrieve all projects.
This method supports the following expands so you can automatically include additional information for referenced objects:
users
200
400
401
422
(details)
/projects/{project_id}
Returns a single project (if the user has access to the project).
This method supports the following expands so you can automatically include additional information for referenced objects:
users
200
400
401
404
422
(details)
page
integer
Number of page to return (default: first page)
per_page
integer
Maximum number of projects to return (supported: 15
, 25
, 50
, 100
; default: 100
)
sort
string
Sort field for the list of projects (supported: projects:created_at
, projects:completed_at
; default: projects:created_at
)
order
string
Sort order (ascending or descending) (supported: asc
, desc
; default: desc
)
is_completed
boolean
Limit result to active or completed projects only.
expands
string
Comma-separated list of expands to return.
project_id
id
required
ID of the project to return.
expands
string
Comma-separated list of expands to return.