{
"opencollection": "1.0.0",
"info": {
"name": "Pipedrive API v1 Activities Projects API",
"version": "1.0.0"
},
"items": [
{
"info": {
"name": "Projects",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get all projects",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects",
"params": [
{
"name": "cursor",
"value": "",
"type": "query",
"description": "For pagination, the marker (an opaque string value) representing the first item on the next page"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "For pagination, the limit of entries to be returned. If not provided, 100 items will be returned."
},
{
"name": "filter_id",
"value": "",
"type": "query",
"description": "The ID of the filter to use"
},
{
"name": "status",
"value": "",
"type": "query",
"description": "If supplied, includes only projects with the specified statuses. Possible values are `open`, `completed`, `canceled` and `deleted`. By default `deleted` projects are not returned."
},
{
"name": "phase_id",
"value": "",
"type": "query",
"description": "If supplied, only projects in specified phase are returned"
},
{
"name": "include_archived",
"value": "",
"type": "query",
"description": "If supplied with `true` then archived projects are also included in the response. By default only not archived projects are returned."
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns all projects. This is a cursor-paginated endpoint. For more information, please refer to our documentation on pagination."
},
{
"info": {
"name": "Add a project",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/projects",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "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."
},
{
"info": {
"name": "Get details of a project",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "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."
},
{
"info": {
"name": "Update a project",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.pipedrive.com/v1/projects/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates a project."
},
{
"info": {
"name": "Update a project",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/projects/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates the properties of a project."
},
{
"info": {
"name": "Delete a project",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/projects/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a project as deleted."
},
{
"info": {
"name": "Archive a project",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/projects/:id/archive",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Archives a project."
},
{
"info": {
"name": "Returns project plan",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id/plan",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns information about items in a project plan. Items consists of tasks and activities and are linked to specific project phase and group."
},
{
"info": {
"name": "Update activity in project plan",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.pipedrive.com/v1/projects/:id/plan/activities/:activityId",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
},
{
"name": "activityId",
"value": "",
"type": "path",
"description": "The ID of the activity"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates an activity phase or group in a project."
},
{
"info": {
"name": "Update task in project plan",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.pipedrive.com/v1/projects/:id/plan/tasks/:taskId",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
},
{
"name": "taskId",
"value": "",
"type": "path",
"description": "The ID of the task"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates a task phase or group in a project."
},
{
"info": {
"name": "Returns project groups",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id/groups",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns all active groups under a specific project."
},
{
"info": {
"name": "Returns project tasks",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id/tasks",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns tasks linked to a specific project."
},
{
"info": {
"name": "Returns project activities",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id/activities",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns activities linked to a specific project."
},
{
"info": {
"name": "Get all archived projects",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/archived",
"params": [
{
"name": "filter_id",
"value": "",
"type": "query",
"description": "If supplied, only projects matching the specified filter are returned"
},
{
"name": "status",
"value": "",
"type": "query",
"description": "If supplied, includes only projects with the specified statuses. Possible values are `open`, `completed`, `canceled` and `deleted`. By default `deleted` projects are not returned."
},
{
"name": "phase_id",
"value": "",
"type": "query",
"description": "If supplied, only projects in the specified phase are returned"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed."
},
{
"name": "cursor",
"value": "",
"type": "query",
"description": "For pagination, the marker (an opaque string value) representing the first item on the next page"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns all archived projects."
},
{
"info": {
"name": "Search projects",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/search",
"params": [
{
"name": "term",
"value": "",
"type": "query",
"description": "The search term to look for. Minimum 2 characters (or 1 if using `exact_match`). Please note that the search term has to be URL encoded."
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "A comma-separated string array. The fields to perform the search from. Defaults to all of them. Only the following custom field types are searchable: `address`, `varchar`, `text`, `varchar_auto`, `double`, `monetary` and `phone`. Read more about searching by custom fields here."
},
{
"name": "exact_match",
"value": "",
"type": "query",
"description": "When enabled, only full exact matches against the given term are returned. It is not case sensitive."
},
{
"name": "person_id",
"value": "",
"type": "query",
"description": "Will filter projects by the provided person ID"
},
{
"name": "organization_id",
"value": "",
"type": "query",
"description": "Will filter projects by the provided organization ID"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed."
},
{
"name": "cursor",
"value": "",
"type": "query",
"description": "For pagination, the marker (an opaque string value) representing the first item on the next page"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Searches all projects by title, description, notes and/or custom fields. This endpoint is a wrapper of /v1/itemSearch with a narrower OAuth scope. Found projects can be filtered by person ID or organization ID."
},
{
"info": {
"name": "List permitted users",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id/permittedUsers",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Lists the users permitted to access a project."
},
{
"info": {
"name": "List updates about project field values",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projects/:id/changelog",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "For pagination, the limit of entries to be returned. If not provided, 100 items will be returned. Please note that a maximum value of 500 is allowed."
},
{
"name": "cursor",
"value": "",
"type": "query",
"description": "For pagination, the marker (an opaque string value) representing the first item on the next page"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Lists updates about field values of a project."
}
]
}
],
"bundled": true
}