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→ Returns200with immediate SSE stream- Other Accept headers → Returns
202with stream URL for later consumption
Request
Responses
- 200
- 202
- 400
- 401
- 403
- 422
- 429
- 500
Streaming execution with Server-Sent Events
Response Headers
Server-generated request identifier
req_01H8QK3Z9X7Y2W3V4R5T6E9C8True if this response was replayed from idempotency cache
falseRequest limit per window (supports multiple windows)
100;w=3600, 1000;w=86400Requests remaining in current window
99Seconds until limit resets (delta)
3540Legacy rate limit header
100Legacy rate limit header
99Legacy rate limit header (Unix timestamp)
1692454800Task accepted, stream available at provided URL
Response Headers
req_01H8QK3Z9X7Y2W3V4R5T6E9C8Absolute URL for accessing the event stream
https://api.company.com/v1/mapping/sess_123/eventsTrue if this response was replayed from idempotency cache
false100;w=3600, 1000;w=8640099Seconds until limit resets (delta)
354010099Unix timestamp when limit resets
Invalid request parameters
Response Headers
Authentication required
Response Headers
Authentication scheme required
API-Key realm="api"Insufficient permissions
Response Headers
Idempotency key conflict with different parameters
Response Headers
Rate limit exceeded
Response Headers
Request limit per window (supports multiple windows)
100;w=3600, 1000;w=864000Seconds until limit resets (delta)
60Seconds to wait before retry
601000Unix timestamp when limit resets
1692454800Internal server error