POST /resources/wrappers//execute
Execute a generated wrapper to fetch data from its configured source and send it to the destination. This endpoint triggers the wrapper’s data collection and transmission process.Authentication
This endpoint requires authentication. Include your API key in the request headers.Path Parameters
The unique identifier of the wrapper to execute
Response
The wrapper ID that was executed
Whether the execution completed successfully
Human-readable message describing the execution result
Number of data points successfully transmitted (null if execution failed)
ISO 8601 timestamp when the execution completed
Example Request
cURL
Example Response (Success)
Example Response (Failure)
Error Responses
400 Bad Request
Wrapper execution error. Common causes:
- Wrapper not found
- Invalid wrapper configuration
- File not found for CSV/XLSX wrappers
- Data source connection failed
Service unavailable during execution:
- Connection error to data source
- Timeout fetching data
- Network communication failure
Behavior Notes
- The endpoint updates the wrapper’s status in the database based on execution results
- For successful executions, the status is updated to
completed - For failed executions, the status is updated to
errorwith an error message - Execution logs are appended to the wrapper’s execution_log array
- The wrapper’s last_data_sent timestamp and data_points_count are updated on success