メインコンテンツへスキップ
PUT
/
crm
/
v3
/
pipelines
/
{objectType}
/
{pipelineId}
/
stages
/
{stageId}
パイプラインステージを置換
curl --request PUT \
  --url https://api.hubapi.com/crm/v3/pipelines/{objectType}/{pipelineId}/stages/{stageId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "displayOrder": 123,
  "label": "<string>",
  "metadata": {}
}
'
{
  "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"
}

サポートされる製品

次のいずれかの製品またはそれ以上が必要です。
Marketing HubMarketing Hub -無料ツール
Sales HubSales Hub -無料ツール
Service HubService Hub -無料ツール
Content HubContent Hub -無料ツール

承認

​
Authorization
string
header
必須

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

パスパラメータ

​
objectType
string
必須

更新するパイプラインのオブジェクトタイプ（例：取引やチケット）

​
pipelineId
string
必須

ステージが属しているパイプラインの固有ID。

​
stageId
string
必須

パイプラインで置換するステージの固有ID。

ボディ

application/json
​
displayOrder
integer<int32>
必須

このパイプラインステージを表示する順序。2つのパイプラインステージの「displayOrder」が同じ場合、ラベルのアルファベット順に並べ替えられます。

​
label
string
必須

HubSpotのUIでパイプラインステージを整理するために使用されるラベル。各パイプラインステージのラベルはそのパイプライン内で固有である必要があります。

​
metadata
object
必須

どのオブジェクトパイプラインにも存在しないプロパティーが含まれるJSONオブジェクト。

「deals」パイプラインの場合、「probability」フィールドは必須で（「{ "probability": 0.5 }」）、取引がクローズされる可能性を表します。使用可能な値は0.0～1.0（0.1単位）です。

「tickets」パイプラインの場合、「ticketState」フィールドは任意で（「{ "ticketState": "OPEN" }」）、チケットがオープン中のままになっているのか、サポートチームのメンバーによってクローズされたのかを表します。選択可能な値は「OPEN」または「CLOSED」です。

レスポンス

successful operation

A pipeline stage definition.

​
archived
boolean
必須

パイプラインがアーカイブされているかどうか。

​
createdAt
string<date-time>
必須

パイプラインステージが作成された日付。デフォルトのパイプラインのステージではcreatedAt = 0になります。

​
displayOrder
integer<int32>
必須

このパイプラインステージを表示する順序。2つのパイプラインステージの「displayOrder」が同じ場合、ラベルのアルファベット順に並べ替えられます。

​
id
string
必須

HubSpotによって生成される固有ID。パイプラインステージの取得や更新に使用されます。

​
label
string
必須

HubSpotのUIでパイプラインステージを整理するために使用されるラベル。各パイプラインステージのラベルはそのパイプライン内で固有である必要があります。

​
metadata
object
必須

どのオブジェクトパイプラインにも存在しないプロパティーが含まれるJSONオブジェクト。

「deals」パイプラインの場合、「probability」フィールドは必須で（「{ "probability": 0.5 }」）、取引がクローズされる可能性を表します。使用可能な値は0.0～1.0（0.1単位）です。

「tickets」パイプラインの場合、「ticketState」フィールドは任意で（「{ "ticketState": "OPEN" }」）、チケットがオープン中のままになっているのか、サポートチームのメンバーによってクローズされたのかを表します。選択可能な値は「OPEN」または「CLOSED」です。

​
updatedAt
string<date-time>
必須

パイプラインステージが最後に更新された日付。

​
archivedAt
string<date-time>

パイプラインがアーカイブされた日付。「archivedAt」はパイプラインがアーカイブされている場合にのみ存在します。

​
writePermissions
enum<string>

パイプラインステージの書き込みアクセスのレベルを定義します。可能な値は、CRM_PERMISSIONS_ENFORCEMENT、READ_ONLY、またはINTERNAL_ONLYです。

利用可能なオプション:
CRM_PERMISSIONS_ENFORCEMENT,
INTERNAL_ONLY,
READ_ONLY
Last modified on March 30, 2026