Projects represent ongoing, completed or canceled projects attached to an organization, person or to deals. Each project has an owner and must be placed in a phase. Each project consists of standard data fields but can also contain a number of custom fields. The custom fields can be recognized by long hashes as keys.
Returns all projects. This is a cursor-paginated endpoint. For more information, please refer to our documentation on pagination.
/v1/projects
cursor
string
For pagination, the marker (an opaque string value) representing the first item on the next page
limit
integer
For pagination, the limit of entries to be returned. If not provided, 100 items will be returned.
filter_id
integer
The ID of the filter to use
status
string
If supplied, includes only projects with the specified statuses. Possible values are open
, completed
, canceled
and deleted
. By default deleted
projects are not returned.
phase_id
integer
If supplied, only projects in specified phase are returned
include_archived
boolean
If supplied with true
then archived projects are also included in the response. By default only not archived projects are returned.
OK
Returns the details of a specific project. Also note that custom fields appear as long hashes in the resulting data. These hashes can be mapped against the key
value of project fields.
/v1/projects/{id}
id
integer
required
The ID of the project
OK
Returns information about items in a project plan. Items consists of tasks and activities and are linked to specific project phase and group.
/v1/projects/{id}/plan
id
integer
required
The ID of the project
OK
Returns all active groups under a specific project.
/v1/projects/{id}/groups
id
integer
required
The ID of the project
OK
Returns tasks linked to a specific project.
/v1/projects/{id}/tasks
id
integer
required
The ID of the project
OK
Returns activities linked to a specific project.
/v1/projects/{id}/activities
id
integer
required
The ID of the project
OK
Returns all projects boards that are not deleted.
/v1/projects/boards
OK
Returns the details of a specific project board.
/v1/projects/boards/{id}
id
integer
required
The ID of the project board
OK
Returns all active project phases under a specific board.
/v1/projects/phases
board_id
integer
required
ID of the board for which phases are requested
OK
Returns the details of a specific project phase.
/v1/projects/phases/{id}
id
integer
required
The ID of the project phase
OK
Adds a new project. Note that you can supply additional custom fields along with the request that are not described here. These custom fields are different for each Pipedrive account and can be recognized by long hashes as keys.
/v1/projects
application/json
title
string
required
The title of the project
board_id
number
required
The ID of a project board
phase_id
number
required
The ID of a phase on a project board
description
string
The description of the project
status
string
The status of the project
owner_id
number
The ID of a project owner
start_date
string
The start date of the project. Format: YYYY-MM-DD.
Format
date
end_date
string
The end date of the project. Format: YYYY-MM-DD.
Format
date
deal_ids
array
An array of IDs of the deals this project is associated with
org_id
number
The ID of the organization this project is associated with
person_id
number
The ID of the person this project is associated with
labels
array
An array of IDs of the labels this project has
template_id
number
The ID of the template the project will be based on
Created
Archives a project.
/v1/projects/{id}/archive
id
integer
required
The ID of the project
OK
Updates a project.
/v1/projects/{id}
id
integer
required
The ID of the project
application/json
title
string
The title of the project
board_id
number
The ID of the board this project is associated with
phase_id
number
The ID of the phase this project is associated with
description
string
The description of the project
status
string
The status of the project
owner_id
number
The ID of a project owner
start_date
string
The start date of the project. Format: YYYY-MM-DD.
Format
date
end_date
string
The end date of the project. Format: YYYY-MM-DD.
Format
date
deal_ids
array
An array of IDs of the deals this project is associated with
org_id
number
The ID of the organization this project is associated with
person_id
number
The ID of the person this project is associated with
labels
array
An array of IDs of the labels this project has
OK
Updates an activity phase or group in a project.
/v1/projects/{id}/plan/activities/{activityId}
id
integer
required
The ID of the project
activityId
integer
required
The ID of the activity
application/json
phase_id
number
The ID of a phase on a project board
group_id
number
The ID of a group on a project board
OK
Updates a task phase or group in a project.
/v1/projects/{id}/plan/tasks/{taskId}
id
integer
required
The ID of the project
taskId
integer
required
The ID of the task
application/json
phase_id
number
The ID of a phase on a project board
group_id
number
The ID of a group on a project board
OK
Marks a project as deleted.
/v1/projects/{id}
id
integer
required
The ID of the project
OK