For AI agents: markdown of this page — /docs-content-en/entities/deal-categories/update.md documentation index — /llms.txt

Update a pipeline

PATCH /v1/deal-categories/:id

Updates the fields of a sales pipeline by ID.

Path parameters

Parameter Type Required Description
Parameterid (path) Typenumber Requiredyes DescriptionPipeline ID. List: GET /v1/deal-categories

Request body parameters

Parameter Type Required Description
Parametername Typestring Requiredno DescriptionPipeline name
Parametersort Typenumber Requiredno DescriptionSort order

Examples

curl — personal key

Terminal 
curl -X PATCH "https://vibecode.bitrix24.com/v1/deal-categories/3" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Corporate sales B2B"}'

curl — OAuth application

Terminal 
curl -X PATCH "https://vibecode.bitrix24.com/v1/deal-categories/3" \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name": "Corporate sales B2B"}'

JavaScript — personal key

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/deal-categories/3', {
  method: 'PATCH',
  headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'Corporate sales B2B' }),
})
const { success, data } = await res.json()

JavaScript — OAuth application

javascript 
const res = await fetch('https://vibecode.bitrix24.com/v1/deal-categories/3', {
  method: 'PATCH',
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ name: 'Corporate sales B2B' }),
})
const { success, data } = await res.json()

Response fields

Field Type Description
Fieldsuccess Typeboolean DescriptionAlways true on success
Fielddata Typeobject DescriptionThe pipeline with all fields after the update
Fielddata.id Typenumber DescriptionPipeline ID
Fielddata.name Typestring DescriptionName
Fielddata.sort Typenumber DescriptionSort order
Fielddata.isLocked Typeboolean DescriptionWhether the pipeline is locked — unavailable on the current plan
Fielddata.createdAt Typedatetime DescriptionCreation date

Response example

JSON 
{
  "success": true,
  "data": {
    "id": 3,
    "createdAt": "2026-06-01T10:00:00.000Z",
    "name": "Corporate sales B2B",
    "sort": 200,
    "isLocked": false
  }
}

Error response example

404 — no pipeline with this ID:

JSON 
{
  "success": false,
  "error": { "code": "ENTITY_NOT_FOUND", "message": "Not found." }
}

Errors

HTTP Code Description
HTTP404 CodeENTITY_NOT_FOUND DescriptionPipeline not found
HTTP403 CodeSCOPE_DENIED DescriptionThe API key lacks the crm scope
HTTP401 CodeMISSING_API_KEY DescriptionThe X-Api-Key header is missing

Full list of errors — Errors.

See also