Gemlead
Docs
ログイン
APIキーを取得

APIリファレンス

パイプラインの列

パイプラインの列は、「興味あり」や「通話予約済み」のような会話ボードのステージです。各会話はいずれか1つの列に置かれます。「リクエスト」「受信トレイ」「連絡済み」「返信あり」とペルソナの列はボード固有の列で、それ以外はあなたが作成した列です。ボードの列は最大50個です。

エンドポイント

パイプラインの列オブジェクト

「興味あり」や「通話予約済み」のような、会話ボードの列。各会話はいずれか1つの列に置かれます。

属性

  • idstring
    列の一意の識別子。
  • objectstring
    常にpipeline_columnです。
  • namestring
    列の名前。
  • kindstring
    requests、inbox、contacted、repliedはボード固有の列、personaはペルソナに対応する列、customはあなたが作成した列です。
    requestsinboxcontactedrepliedpersonacustom
  • persona_idstringまたはnull
    personaの列に対応するペルソナ。
  • positioninteger
    ボード上の位置。左端が0です。
  • collapsedboolean
    ボード上で折りたたまれているかどうか。
  • deletableboolean
    削除できるかどうか。削除できるのはcustomの列のみです。
パイプラインの列オブジェクト
{
  "id": "q7m2xk4p",
  "object": "pipeline_column",
  "name": "Interested",
  "kind": "custom",
  "persona_id": null,
  "position": 2,
  "collapsed": false,
  "deletable": true
}

パイプラインの列を一覧表示

GET/v1/pipeline_columnsreadスコープMCPlist_pipeline_columns

ボードの列を左から順に返します。

戻り値

パイプラインの列オブジェクトのリスト。

GET/v1/pipeline_columns
curl https://gemlead.ai/api/v1/pipeline_columns \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "object": "list",
  "data": [
    {
      "id": "r1n8vd2c",
      "object": "pipeline_column",
      "name": "Requests",
      "kind": "requests",
      "persona_id": null,
      "position": 0,
      "collapsed": true,
      "deletable": false
    },
    {
      "id": "h5t0bw9e",
      "object": "pipeline_column",
      "name": "Inbox",
      "kind": "inbox",
      "persona_id": null,
      "position": 1,
      "collapsed": false,
      "deletable": false
    },
    {
      "id": "q7m2xk4p",
      "object": "pipeline_column",
      "name": "Interested",
      "kind": "custom",
      "persona_id": null,
      "position": 2,
      "collapsed": false,
      "deletable": true
    },
    {
      "id": "z3c6lf8a",
      "object": "pipeline_column",
      "name": "Call booked",
      "kind": "custom",
      "persona_id": null,
      "position": 3,
      "collapsed": false,
      "deletable": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}

パイプラインの列を作成

POST/v1/pipeline_columnswriteスコープMCPedit_pipeline_columns

ボードに列を追加します。

ボディパラメーター

  • namestring必須
    列の名前。60文字までです。
  • positioninteger
    追加する位置。0が先頭です。デフォルトは末尾です。

戻り値

ボードの列。パイプラインの列オブジェクトのリストです。

エラー

  • 400parameter_missing
    必須パラメーターがありません。paramにその名前が入ります。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 400limit_reached
    ボードにはすでに50個の列があります。
POST/v1/pipeline_columns
curl -X POST https://gemlead.ai/api/v1/pipeline_columns \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Call booked",
    "position": 3
  }'
レスポンス200
{
  "object": "list",
  "data": [
    {
      "id": "r1n8vd2c",
      "object": "pipeline_column",
      "name": "Requests",
      "kind": "requests",
      "persona_id": null,
      "position": 0,
      "collapsed": true,
      "deletable": false
    },
    {
      "id": "h5t0bw9e",
      "object": "pipeline_column",
      "name": "Inbox",
      "kind": "inbox",
      "persona_id": null,
      "position": 1,
      "collapsed": false,
      "deletable": false
    },
    {
      "id": "q7m2xk4p",
      "object": "pipeline_column",
      "name": "Interested",
      "kind": "custom",
      "persona_id": null,
      "position": 2,
      "collapsed": false,
      "deletable": true
    },
    {
      "id": "z3c6lf8a",
      "object": "pipeline_column",
      "name": "Call booked",
      "kind": "custom",
      "persona_id": null,
      "position": 3,
      "collapsed": false,
      "deletable": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}

パイプラインの列を更新

PATCH/v1/pipeline_columns/:column_idwriteスコープMCPedit_pipeline_columns

列の名前を変更するか、ボード上で折りたたみます。

パスパラメーター

  • column_idstring必須
    列のID。

ボディパラメーター

  • namestring
    列の名前。60文字までです。
  • collapsedboolean
    ボード上で列を折りたたみます。

戻り値

ボードの列。パイプラインの列オブジェクトのリストです。

エラー

  • 404resource_missing
    キーのアカウントに、このIDの列はありません。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 400parameter_unknown
    ボディに、このエンドポイントが受け付けないフィールドがあります。
PATCH/v1/pipeline_columns/:column_id
curl -X PATCH \
  https://gemlead.ai/api/v1/pipeline_columns/z3c6lf8a \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Demo booked"
  }'
レスポンス200
{
  "object": "list",
  "data": [
    {
      "id": "r1n8vd2c",
      "object": "pipeline_column",
      "name": "Requests",
      "kind": "requests",
      "persona_id": null,
      "position": 0,
      "collapsed": true,
      "deletable": false
    },
    {
      "id": "h5t0bw9e",
      "object": "pipeline_column",
      "name": "Inbox",
      "kind": "inbox",
      "persona_id": null,
      "position": 1,
      "collapsed": false,
      "deletable": false
    },
    {
      "id": "q7m2xk4p",
      "object": "pipeline_column",
      "name": "Interested",
      "kind": "custom",
      "persona_id": null,
      "position": 2,
      "collapsed": false,
      "deletable": true
    },
    {
      "id": "z3c6lf8a",
      "object": "pipeline_column",
      "name": "Demo booked",
      "kind": "custom",
      "persona_id": null,
      "position": 3,
      "collapsed": false,
      "deletable": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}

パイプラインの列を削除

DELETE/v1/pipeline_columns/:column_idwriteスコープMCPedit_pipeline_columns

あなたが作成した列を削除します。その列の会話は「受信トレイ」の列に戻ります。

パスパラメーター

  • column_idstring必須
    列のID。

戻り値

列のidと、trueに設定されたdeletedを含むオブジェクト。

エラー

  • 404resource_missing
    キーのアカウントに、このIDの列はありません。
  • 400column_protected
    この列は「受信トレイ」やペルソナの列のようなボード固有の列です。
DELETE/v1/pipeline_columns/:column_id
curl -X DELETE \
  https://gemlead.ai/api/v1/pipeline_columns/z3c6lf8a \
  -H "Authorization: Bearer $GEMLEAD_API_KEY"
レスポンス200
{
  "id": "z3c6lf8a",
  "object": "pipeline_column",
  "deleted": true
}

パイプラインの列を並べ替え

POST/v1/pipeline_columns/reorderwriteスコープMCPedit_pipeline_columns

ボードの列を新しい順番に並べます。すべての列を1回ずつ送ってください。

ボディパラメーター

  • column_idsstringsの配列必須
    ボードのすべての列IDを、左から順に並べたもの。

戻り値

新しい順番に並んだボードの列。パイプラインの列オブジェクトのリストです。

エラー

  • 400parameter_missing
    必須パラメーターがありません。paramにその名前が入ります。
  • 400parameter_invalid
    APIが受け付けない値のパラメーターがあります。paramにその名前が入ります。
  • 404resource_missing
    ボードの列ではないIDがあります。
POST/v1/pipeline_columns/reorder
curl -X POST \
  https://gemlead.ai/api/v1/pipeline_columns/reorder \
  -H "Authorization: Bearer $GEMLEAD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "column_ids": ["r1n8vd2c", "h5t0bw9e", "z3c6lf8a", "q7m2xk4p"]
  }'
レスポンス200
{
  "object": "list",
  "data": [
    {
      "id": "r1n8vd2c",
      "object": "pipeline_column",
      "name": "Requests",
      "kind": "requests",
      "persona_id": null,
      "position": 0,
      "collapsed": true,
      "deletable": false
    },
    {
      "id": "h5t0bw9e",
      "object": "pipeline_column",
      "name": "Inbox",
      "kind": "inbox",
      "persona_id": null,
      "position": 1,
      "collapsed": false,
      "deletable": false
    },
    {
      "id": "z3c6lf8a",
      "object": "pipeline_column",
      "name": "Call booked",
      "kind": "custom",
      "persona_id": null,
      "position": 2,
      "collapsed": false,
      "deletable": true
    },
    {
      "id": "q7m2xk4p",
      "object": "pipeline_column",
      "name": "Interested",
      "kind": "custom",
      "persona_id": null,
      "position": 3,
      "collapsed": false,
      "deletable": true
    }
  ],
  "has_more": false,
  "next_cursor": null
}
Gemleadの最新情報を
メールで直接お届けします。
登録
登録すると、プライバシーポリシーに同意し、当社からのお知らせの受信を承諾したものとみなされます。
Gemlead
製品
始める
ログイン
こんな方に
AIエージェント
機能
料金
アフィリエイト
FAQ
機能
24時間、買い手を発見ホットリード優先返信率60%超え心を読むDM全DMをひとつにAIクローザー限界なくスケールAPI・MCP・WebhookGemleadに質問
リソース
ホームAPIブログ
法的情報
利用規約
プライバシー
© 2026 Gemlead, Inc. 無断転載を禁じます。
日本語