Pular para o conteúdo principal
PATCH
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
/
stages
/
{stageId}
cURL
curl --request PATCH \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayOrder": 1,
  "label": "Done",
  "metadata": {
    "ticketState": "CLOSED"
  }
}
'
{
  "archived": false,
  "createdAt": "2019-10-30T03:30:17.883Z",
  "displayOrder": 0,
  "id": "1234912",
  "label": "In Progress",
  "metadata": {
    "ticketState": "OPEN"
  },
  "updatedAt": "2019-12-07T16:50:06.678Z"
}

Supported products

Autorizações

Authorization
string
header
obrigatório

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

Parâmetros de caminho

objectType
string
obrigatório
pipelineId
string
obrigatório
stageId
string
obrigatório

Corpo

application/json

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

metadata
object
obrigatório

Um objeto JSON contendo propriedades que não estão presentes em todos os pipelines de objeto.

Para pipelines de "deals", o campo "probability" é obrigatório ("{ "probability": 0.5 }"), e representa a probabilidade de um negócio ser fechado. Os valores possíveis estão entre 0,0 e 1,0 em incrementos de 0,1.

Para pipelines de "tickets", o campo "ticketState" é opcional ("{ "ticketState": "OPEN" }"), e representa se o ticket permanece aberto ou foi fechado por um membro da sua equipe de suporte. Os valores possíveis são "OPEN" ou "CLOSED".

archived
boolean

Se o pipeline está arquivado ou não.

displayOrder
integer<int32>

A ordem para exibir esta fase do pipeline. Se duas fases do pipeline tiverem um "displayOrder" correspondente, elas serão classificadas em ordem alfabética pelo rótulo de associação.

label
string

Um rótulo usado para organizar fases de pipeline na UI do HubSpot. Cada rótulo de fase deve ser exclusivo dentro do pipeline.

Resposta

successful operation

A pipeline stage definition.

archived
boolean
obrigatório

Se o pipeline está arquivado ou não.

createdAt
string<date-time>
obrigatório

A data em que a fase do pipeline foi criada. As fases nos pipelines padrão terão createdAt = 0.

displayOrder
integer<int32>
obrigatório

A ordem para exibir esta fase do pipeline. Se duas fases do pipeline tiverem um "displayOrder" correspondente, elas serão classificadas em ordem alfabética pelo rótulo de associação.

id
string
obrigatório

Um identificador exclusivo gerado pelo HubSpot que pode ser usado para recuperar e atualizar a fase do pipeline.

label
string
obrigatório

Um rótulo usado para organizar fases de pipeline na UI do HubSpot. Cada rótulo de fase deve ser exclusivo dentro do pipeline.

metadata
object
obrigatório

Um objeto JSON contendo propriedades que não estão presentes em todos os pipelines de objeto.

Para pipelines de "deals", o campo "probability" é obrigatório ("{ "probability": 0.5 }"), e representa a probabilidade de um negócio ser fechado. Os valores possíveis estão entre 0,0 e 1,0 em incrementos de 0,1.

Para pipelines de "tickets", o campo "ticketState" é opcional ("{ "ticketState": "OPEN" }"), e representa se o ticket permanece aberto ou foi fechado por um membro da sua equipe de suporte. Os valores possíveis são "OPEN" ou "CLOSED".

updatedAt
string<date-time>
obrigatório

A data em que a fase do pipeline foi atualizada pela última vez.

archivedAt
string<date-time>

A data em que o pipeline foi arquivado. "archivedAt" somente estará presente se o pipeline estiver arquivado.

writePermissions
enum<string>

Define o nível de acesso de gravação para a fase do pipeline, com os valores possíveis sendo CRM_PERMISSIONS_ENFORCEMENT, READ_ONLY ou INTERNAL_ONLY.

Opções disponíveis:
CRM_PERMISSIONS_ENFORCEMENT,
INTERNAL_ONLY,
READ_ONLY
Last modified on April 13, 2026