Passer au contenu principal
PATCH
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
Effectuer une mise à jour partielle du pipeline identifié par 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"
    }
  ]
}

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Gratuit
Sales HubSales Hub -Gratuit
Service HubService Hub -Gratuit
Content HubContent Hub -Gratuit

Autorisations

Authorization
string
header
requis

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

Paramètres de chemin

objectType
string
requis

Le type d'objet du pipeline en cours de mise à jour (par exemple, transactions ou tickets)

pipelineId
string
requis

Identifiant unique du pipeline à mettre à jour.

Paramètres de requête

validateDealStageUsagesBeforeDelete
boolean
défaut:false

Indique s'il faut valider les utilisations des étapes de transaction avant de supprimer le pipeline.

validateReferencesBeforeDelete
boolean
défaut:false

Indique s'il faut valider les références avant de supprimer le pipeline.

Corps

application/json

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

archived
boolean

Que le pipeline soit archivé. Cette propriété ne doit être fournie que lors de la restauration d'un pipeline archivé. Si elle est fournie dans tout autre appel, la requête échouera et un « 400 Bad Request » sera renvoyé.

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

Réponse

successful operation

A pipeline definition.

archived
boolean
requis

Si le pipeline est archivé.

createdAt
string<date-time>
requis

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

displayOrder
integer<int32>
requis

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

id
string
requis

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

label
string
requis

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

stages
object[]
requis

Les étapes associées au pipeline. Elles peuvent être récupérées et mises à jour via les points de terminaison des étapes du pipeline.

updatedAt
string<date-time>
requis

La date de la dernière mise à jour du pipeline.

archivedAt
string<date-time>

La date à laquelle le pipeline a été archivé. archivedAt ne sera présent que si le pipeline est archivé.

Last modified on December 8, 2025