POST /v1/pipelines/{pipeline_id}/push

Family: Pipelines · Operation ID: v1_push_pipeline

Access

Workspace API key: Authorization: Bearer <key>. The key is scoped to its workspace; the backend checks operation permissions and quota.

Open pipelines

Required scope: pipelines.trigger

Create a key in Developer settings. Set API_BASE_URL to the current app origin.

Request example

curl --fail-with-body -X POST "$API_BASE_URL/v1/pipelines/{pipeline_id}/push" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @request.json

Replace each {parameter} segment in the path with its URL-encoded value.

Parameters

[
  {
    "description": "Push pipeline identifier",
    "in": "path",
    "name": "pipeline_id",
    "required": true,
    "schema": {
      "format": "int64",
      "type": "integer"
    }
  },
  {
    "description": "Required idempotency key",
    "in": "header",
    "name": "Idempotency-Key",
    "required": true,
    "schema": {
      "type": "string"
    }
  }
]

Request body · application/json

{
  "$ref": "#/components/schemas/PushPipelineInput",
  "definition": {
    "properties": {
      "email_column": {
        "type": "string"
      },
      "rows": {
        "items": {
          "additionalProperties": {},
          "type": "object"
        },
        "type": "array"
      },
      "source_key": {
        "nullable": true,
        "type": "string"
      }
    },
    "required": [
      "rows"
    ],
    "type": "object"
  }
}

Responses

202

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PushPipelineResponse"
      }
    }
  },
  "description": "Push batch accepted"
}

400

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PipelineErrorResponse"
      }
    }
  },
  "description": "Bad request"
}

403

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PipelineErrorResponse"
      }
    }
  },
  "description": "Forbidden"
}

404

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PipelineErrorResponse"
      }
    }
  },
  "description": "Not found"
}

409

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PipelineErrorResponse"
      }
    }
  },
  "description": "Conflict"
}

503

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/PipelineErrorResponse"
      }
    }
  },
  "description": "Service unavailable"
}

default

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/ErrorEnvelope"
      }
    }
  },
  "description": "Request error"
}

Download the full OpenAPI contract