Zum Hauptinhalt springen
PATCH
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
Führen Sie eine teilweise Aktualisierung der durch pipelineId identifizierten Pipeline durch.
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"
    }
  ]
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

​
Authorization
string
header
erforderlich

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

Pfadparameter

​
objectType
string
erforderlich

Der Objekttyp der Pipeline, die aktualisiert wird (z. B. Deals oder Tickets)

​
pipelineId
string
erforderlich

Die eindeutige ID für die zu aktualisierende Pipeline.

Abfrageparameter

​
validateDealStageUsagesBeforeDelete
boolean
Standard:false

Gibt an, ob Dealphasennutzungen vor dem Löschen der Pipeline validiert werden soll.

​
validateReferencesBeforeDelete
boolean
Standard:false

Gibt an, ob Referenzen vor dem Löschen der Pipeline validiert werden sollen.

Body

application/json

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

​
archived
boolean

Ob die Pipeline archiviert ist. Diese Eigenschaft sollte nur bei der Wiederherstellung einer archivierten Pipeline angegeben werden. Wenn sie bei einem anderen Aufruf angegeben wird, schlägt die Anfrage fehl, und es wird „400 Bad Request“ zurückgegeben.

​
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

Antwort

successful operation

A pipeline definition.

​
archived
boolean
erforderlich

Ob die Pipeline archiviert ist.

​
createdAt
string<date-time>
erforderlich

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

​
displayOrder
integer<int32>
erforderlich

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

​
id
string
erforderlich

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

​
label
string
erforderlich

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

​
stages
object[]
erforderlich

Die der Pipeline zugeordneten Phasen. Diese können über die Pipeline-Phasen-Endpunkte abgerufen und aktualisiert werden.

​
updatedAt
string<date-time>
erforderlich

Das Datum, an dem die Pipeline zuletzt aktualisiert wurde

​
archivedAt
string<date-time>

Das Datum, an dem die Pipeline archiviert ist. „archivedAt“ ist nur vorhanden, wenn die Pipeline archiviert ist.

Last modified on January 26, 2026