Skip to main content

Execute data mapping task

POST 

/mapping

Start a data mapping task with real-time streaming updates. Supports automatic human intervention when needed.

Streaming Behavior:

  • Accept: text/event-stream → Returns 200 with immediate SSE stream
  • Other Accept headers → Returns 202 with stream URL for later consumption

Request​

Responses​

Streaming execution with Server-Sent Events

Response Headers
    Content-Type
    Cache-Control
    Connection
    X-Accel-Buffering
    X-Request-Id

    Server-generated request identifier

    Example: req_01H8QK3Z9X7Y2W3V4R5T6E9C8
    Idempotency-Replayed

    True if this response was replayed from idempotency cache

    Example: false
    RateLimit-Limit

    Request limit per window (supports multiple windows)

    Example: 100;w=3600, 1000;w=86400
    RateLimit-Remaining

    Requests remaining in current window

    Example: 99
    RateLimit-Reset

    Seconds until limit resets (delta)

    Example: 3540
    X-RateLimit-Limit

    Legacy rate limit header

    Example: 100
    X-RateLimit-Remaining

    Legacy rate limit header

    Example: 99
    X-RateLimit-Reset

    Legacy rate limit header (Unix timestamp)

    Example: 1692454800