Update a pipeline

PUT  https://:account.api-us1.com/api/3/dealGroups/id

• JSON

{
  "dealGroup": {
    "allgroups": 1,
    "allusers": 0,
    "autoassign": 1,
    "currency": "eur",
    "title": "Qualifications",
    "users": ["3"],
    "groups": []
  }
}

 

200 OK

{
  "dealGroup": {
    "allgroups": 1,
    "allusers": 0,
    "autoassign": 1,
    "cdate": "2017-03-30T12:11:30-05:00",
    "currency": "eur",
    "dealGroupGroups": [],
    "dealGroupUsers": [
      "4"
    ],
    "id": "4",
    "links": {
      "dealGroupGroups": "/api/3/dealGroups/4/dealGroupGroups",
      "dealGroupUsers": "/api/3/dealGroups/4/dealGroupUsers",
      "stages": "/api/3/dealGroups/4/stages"
    },
    "title": "Qualifications",
    "udate": "2017-03-30T13:44:32-05:00"
  },
  "dealGroupGroups": [],
  "dealGroupUsers": [
    {
      "cdate": null,
      "dealGroup": "4",
      "id": "4",
      "links": {
        "dealGroup": "/api/3/dealGroupUsers/4/dealGroup",
        "user": "/api/3/dealGroupUsers/4/user"
      },
      "user": "3"
    }
  ]
}

PATH PARAMS

id                                                    REQUIRED

int32                                              Pipeline's id

 

BODY PARAMS

dealGroup

object

 

dealGroup.title

string                                             Pipeline's title

 

dealGroup.currency

string                                             Default currency to assign to new deals that belong to this deal group.

 

dealGroup.allgroups

int32                                             Whether all user groups have permission to manage this pipeline. Can be either 1 or 0. If 1, all user groups can manage this pipeline. If 0, only user groups in dealGroup.groups parameter can manage this pipeline.

 

dealGroup.allusers

int32                                            Whether new deals get auto-assigned to all users. Can be either 1 or 0. If 1, new deals are auto-assigned to all users unless auto-assign is disabled. If 0, new deals are auto-assigned to only the users in dealGroup.users parameter.

 

dealGroup.autoassign

int32                                            Deal auto-assign option. Can be one of 0, 1, and 2. If 0, auto-assign is disabled. If 1, Round Robin method is used to auto-assign new deals. If 2, deals are distributed based on deal values.

 

dealGroup.users

array of strings                             List of user ids to auto-assign new deals to unless auto-assign option is disabled.

 

dealGroup.groups

array of strings                             List of user group ids to allow managing this pipeline.

By providing user ids with dealGroup.users and enabling the auto-assign option with dealGroup.autoassign: 1, the pipeline can control how new deals are assigned to the owners. By providing user group ids with dealGroup.groups, the pipeline can control which user groups are allowed to manage the pipeline.