{
"opencollection": "1.0.0",
"info": {
"name": "Pipedrive API v1 Activities Beta API",
"version": "1.0.0"
},
"items": [
{
"info": {
"name": "Beta",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get all project fields",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projectFields",
"params": [
{
"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 metadata about all project fields in the company."
},
{
"info": {
"name": "Create one project field",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/projectFields",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Creates a new project custom field."
},
{
"info": {
"name": "Get one project field",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/projectFields/:field_code",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns metadata about a specific project field."
},
{
"info": {
"name": "Update one project field",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/projectFields/:field_code",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates a project custom field. The field_code and field_type cannot be changed. At least one field must be provided in the request body."
},
{
"info": {
"name": "Delete one project field",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/projectFields/:field_code",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a custom field as deleted."
},
{
"info": {
"name": "Add project field options in bulk",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/projectFields/:field_code/options",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Adds new options to a project custom field that supports options (enum or set field types). This operation is atomic - all options are added or none are added. Returns only the newly added options."
},
{
"info": {
"name": "Update project field options in bulk",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/projectFields/:field_code/options",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates existing options for a project custom field. This operation is atomic and fails if any of the specified option IDs do not exist. Returns only the updated options."
},
{
"info": {
"name": "Delete project field options in bulk",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/projectFields/:field_code/options",
"params": [
{
"name": "field_code",
"value": "",
"type": "path",
"description": "The unique code identifying the field"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Removes existing options from a project custom field. This operation is atomic and fails if any of the specified option IDs do not exist. Returns only the deleted options."
},
{
"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": "Get all tasks",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/tasks",
"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. Please note that a maximum value of 500 is allowed."
},
{
"name": "is_done",
"value": "",
"type": "query",
"description": "Whether the task is done or not. If omitted, both done and not done tasks are returned."
},
{
"name": "is_milestone",
"value": "",
"type": "query",
"description": "Whether the task is a milestone or not. If omitted, both milestone and non-milestone tasks are returned."
},
{
"name": "assignee_id",
"value": "",
"type": "query",
"description": "If supplied, only tasks assigned to this user are returned"
},
{
"name": "project_id",
"value": "",
"type": "query",
"description": "If supplied, only tasks belonging to this project are returned"
},
{
"name": "parent_task_id",
"value": "",
"type": "query",
"description": "If `null` is supplied, only root-level tasks (without a parent) are returned. If an integer is supplied, only subtasks of that specific task are returned. By default all tasks are returned."
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns all tasks."
},
{
"info": {
"name": "Add a task",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/tasks",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Adds a new task."
},
{
"info": {
"name": "Get details of a task",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/tasks/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the task"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns the details of a specific task."
},
{
"info": {
"name": "Update a task",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/tasks/:id",
"params": [
{
"name": "id",
"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."
},
{
"info": {
"name": "Delete a task",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/tasks/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the task"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a task as deleted. If the task has subtasks, those will also be deleted."
},
{
"info": {
"name": "Get all project boards",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/boards",
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns all active project boards."
},
{
"info": {
"name": "Add a project board",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/boards",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Adds a new project board."
},
{
"info": {
"name": "Get details of a project board",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/boards/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project board"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns the details of a specific project board."
},
{
"info": {
"name": "Update a project board",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/boards/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project board"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates the properties of a project board."
},
{
"info": {
"name": "Delete a project board",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/boards/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project board"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a project board as deleted."
},
{
"info": {
"name": "Get project phases",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/phases",
"params": [
{
"name": "board_id",
"value": "",
"type": "query",
"description": "The ID of the board for which phases are requested"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns all active project phases under a specific board."
},
{
"info": {
"name": "Add a project phase",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.pipedrive.com/v1/phases",
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Adds a new project phase to a board."
},
{
"info": {
"name": "Get details of a project phase",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.pipedrive.com/v1/phases/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project phase"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Returns the details of a specific project phase."
},
{
"info": {
"name": "Update a project phase",
"type": "http"
},
"http": {
"method": "PATCH",
"url": "https://api.pipedrive.com/v1/phases/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project phase"
}
],
"body": {
"type": "json",
"data": "{}"
},
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Updates the properties of a project phase."
},
{
"info": {
"name": "Delete a project phase",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.pipedrive.com/v1/phases/:id",
"params": [
{
"name": "id",
"value": "",
"type": "path",
"description": "The ID of the project phase"
}
],
"auth": {
"type": "apikey",
"key": "x-api-token",
"value": "{{x-api-token}}",
"placement": "header"
}
},
"docs": "Marks a project phase as deleted."
}
]
}
],
"bundled": true
}