Saltar al contenido principal
PATCH
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
Realiza una actualización parcial del pipeline identificado por pipelineId.
curl --request PATCH \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "My updated pipeline",
  "displayOrder": 0
}
'
{
  "label": "My ticket pipeline",
  "displayOrder": 0,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "updatedAt": "2019-12-07T16:50:06.678Z",
  "archived": false,
  "id": "812723471",
  "stages": [
    {
      "label": "In Progress",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "OPEN"
      },
      "createdAt": "2019-10-30T03:30:17.883Z",
      "updatedAt": "2019-12-07T16:50:06.678Z",
      "archived": false,
      "id": "1234912"
    },
    {
      "label": "Done",
      "displayOrder": 0,
      "metadata": {
        "ticketState": "CLOSED"
      },
      "createdAt": "2019-10-30T03:30:17.883Z",
      "updatedAt": "2019-12-07T16:50:06.678Z",
      "archived": false,
      "id": "1234914"
    }
  ]
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

Parámetros de ruta

objectType
string
requerido

El tipo de objeto del pipeline que se está actualizando (por ejemplo, negocios o tickets)

pipelineId
string
requerido

El identificador único del pipeline que se actualizará.

Parámetros de consulta

validateDealStageUsagesBeforeDelete
boolean
predeterminado:false

Indica si se deben validar los usos de la etapa de negociación antes de eliminar el pipeline.

validateReferencesBeforeDelete
boolean
predeterminado:false

Indica si se deben validar las referencias antes de eliminar el pipeline.

Cuerpo

application/json

An input used to update some properties on a pipeline definition.

archived
boolean

Si se archiva o no el pipeline. Esta propiedad solo debe especificarse al restaurar un pipeline archivado. Si se especifica en cualquier otra llamada, la solicitud fallará y se devolverá un "400 Solicitud incorrecta".

displayOrder
integer<int32>

The order for displaying this pipeline. If two pipelines have a matching displayOrder, they will be sorted alphabetically by label.

label
string

A unique label used to organize pipelines in HubSpot's UI

Respuesta

successful operation

A pipeline definition.

archived
boolean
requerido

Si se archiva o no el pipeline.

createdAt
string<date-time>
requerido

The date the pipeline was created. The default pipelines will have createdAt = 0.

displayOrder
integer<int32>
requerido

The order for displaying this pipeline. If two pipelines have a matching displayOrder, they will be sorted alphabetically by label.

id
string
requerido

A unique identifier generated by HubSpot that can be used to retrieve and update the pipeline.

label
string
requerido

A unique label used to organize pipelines in HubSpot's UI

stages
object[]
requerido

Las etapas asociadas con el pipeline. Pueden recuperarse y actualizarse mediante los puntos de terminación de las etapas de pipeline.

updatedAt
string<date-time>
requerido

La fecha en que se actualizó por última vez el pipeline.

archivedAt
string<date-time>

La fecha en que se archivó el pipeline. "archivedAt" solo estará presente si se archiva el pipeline.

Last modified on December 8, 2025