POST /lists/materialize

POST /api/signal-foundry/lists/materialize は、保存前の estimate を saved List に変換します。credit-consuming write なので、execute: true、maxCredits、Idempotency-Key を付けます。

契約サマリー

リクエスト

Headers

リクエストボディ

{
  "estimateId": "est_123",
  "name": "売上100億以上の上場企業",
  "execute": true,
  "maxCredits": 42
}

例

curl -s "$SIGNAL_FOUNDRY_BASE_URL/api/signal-foundry/lists/materialize" \
  -H "Authorization: Bearer <SIGNAL_FOUNDRY_API_KEY>" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: list-materialize-20260501-001" \
  --data '{
    "estimateId": "est_123",
    "name": "売上100億以上の上場企業",
    "execute": true,
    "maxCredits": 42
  }'

CLI equivalent:

sf list materialize --from-estimate est_123 --name "売上100億以上の上場企業" --execute --max-credits 42 --json

レスポンス

中心フィールド

• list.list_id
• list.row_count
• billing.credits_used
• billing.max_credits
• input.estimate_id
• idempotency_key

例

{
  "list": {
    "list_id": "00000000-0000-4000-8000-000000000000",
    "name": "売上100億以上の上場企業",
    "row_count": 42
  },
  "billing": {
    "credits_used": 42,
    "max_credits": 42
  },
  "input": {
    "estimate_id": "est_123"
  },
  "idempotency_key": "list-materialize-20260501-001"
}

エラー

次に進む

追加情報を足す場合は Lists Enrichments に進みます。CSV が必要なら Lists Export を使います。