cURL
curl --request POST \
--url "https://api.rafflesia.ai/v1/runs" \
--header "Authorization: Bearer $RAFFLESIA_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"endpoint": "airi-institute/moderngena/base",
"input": {
"inputs": [
{
"id": "<id>",
"sequence": "<sequence>"
}
]
}
}'{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeRun.json",
"data": {
"attempt": 1,
"background": true,
"cancel_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"endpoint": "<string>",
"endpoint_release_id": "<string>",
"id": "<string>",
"max_retries": 1,
"object": "run",
"result_url": "<string>",
"status": "queued",
"status_stream_url": "<string>",
"status_url": "<string>",
"version": 2,
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"canceled_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z",
"logs": [
{
"created_at": "<string>",
"sequence": 123,
"type": "<string>",
"attempt": 123,
"details": {},
"message": "<string>",
"worker_id": "<string>"
}
],
"metadata": {},
"model": "<string>",
"model_release_id": "<string>",
"output": {
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"data": {
"data": [
{
"id": "<string>",
"index": 123,
"object": "<string>",
"shape": [
123
],
"values": [
123
],
"salience": [
123
]
}
],
"layer": "<string>",
"model_id": "<string>",
"model_release": "<string>",
"object": "<string>",
"pooling": "<string>",
"usage": {
"input_count": 123,
"token_count": 123
},
"provider_request_id": "<string>"
},
"endpoint_release_id": "<string>",
"request_sha256": "<string>",
"usage": {},
"model_release_id": "<string>",
"timings_ms": {}
},
"progress": {
"stage": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"current": 1,
"total": 1,
"unit": "<string>"
},
"queue": {
"is_position_estimated": true,
"position": 1,
"priority": "normal",
"queued_at": "2023-11-07T05:31:56Z",
"scope": "organization"
},
"runner_hint": "<string>",
"served_from": "<string>",
"start_deadline_at": "2023-11-07T05:31:56Z",
"started_at": "2023-11-07T05:31:56Z",
"webhook_endpoint_id": "<string>"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeRun.json",
"data": {
"attempt": 1,
"background": true,
"cancel_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"endpoint": "<string>",
"endpoint_release_id": "<string>",
"id": "<string>",
"max_retries": 1,
"object": "run",
"result_url": "<string>",
"status": "queued",
"status_stream_url": "<string>",
"status_url": "<string>",
"version": 2,
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"canceled_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z",
"logs": [
{
"created_at": "<string>",
"sequence": 123,
"type": "<string>",
"attempt": 123,
"details": {},
"message": "<string>",
"worker_id": "<string>"
}
],
"metadata": {},
"model": "<string>",
"model_release_id": "<string>",
"output": {
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"data": {
"data": [
{
"id": "<string>",
"index": 123,
"object": "<string>",
"shape": [
123
],
"values": [
123
],
"salience": [
123
]
}
],
"layer": "<string>",
"model_id": "<string>",
"model_release": "<string>",
"object": "<string>",
"pooling": "<string>",
"usage": {
"input_count": 123,
"token_count": 123
},
"provider_request_id": "<string>"
},
"endpoint_release_id": "<string>",
"request_sha256": "<string>",
"usage": {},
"model_release_id": "<string>",
"timings_ms": {}
},
"progress": {
"stage": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"current": 1,
"total": 1,
"unit": "<string>"
},
"queue": {
"is_position_estimated": true,
"position": 1,
"priority": "normal",
"queued_at": "2023-11-07T05:31:56Z",
"scope": "organization"
},
"runner_hint": "<string>",
"served_from": "<string>",
"start_deadline_at": "2023-11-07T05:31:56Z",
"started_at": "2023-11-07T05:31:56Z",
"webhook_endpoint_id": "<string>"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}Creates one retained run for any endpoint. By default the request executes the exact pinned endpoint release and waits for completion. Set background=true to enqueue the identical normalized request and return the same resource shape immediately. A background run may select one existing webhook_endpoint_id; raw callback URLs are not accepted. Endpoint-specific input and output JSON Schemas are published on the endpoint descriptor. File-like inputs and outputs use URLs. Idempotent retries replay the original create status, body, and Rafflesia response headers.
POST
/
v1
/
runs
cURL
curl --request POST \
--url "https://api.rafflesia.ai/v1/runs" \
--header "Authorization: Bearer $RAFFLESIA_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"endpoint": "airi-institute/moderngena/base",
"input": {
"inputs": [
{
"id": "<id>",
"sequence": "<sequence>"
}
]
}
}'{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeRun.json",
"data": {
"attempt": 1,
"background": true,
"cancel_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"endpoint": "<string>",
"endpoint_release_id": "<string>",
"id": "<string>",
"max_retries": 1,
"object": "run",
"result_url": "<string>",
"status": "queued",
"status_stream_url": "<string>",
"status_url": "<string>",
"version": 2,
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"canceled_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z",
"logs": [
{
"created_at": "<string>",
"sequence": 123,
"type": "<string>",
"attempt": 123,
"details": {},
"message": "<string>",
"worker_id": "<string>"
}
],
"metadata": {},
"model": "<string>",
"model_release_id": "<string>",
"output": {
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"data": {
"data": [
{
"id": "<string>",
"index": 123,
"object": "<string>",
"shape": [
123
],
"values": [
123
],
"salience": [
123
]
}
],
"layer": "<string>",
"model_id": "<string>",
"model_release": "<string>",
"object": "<string>",
"pooling": "<string>",
"usage": {
"input_count": 123,
"token_count": 123
},
"provider_request_id": "<string>"
},
"endpoint_release_id": "<string>",
"request_sha256": "<string>",
"usage": {},
"model_release_id": "<string>",
"timings_ms": {}
},
"progress": {
"stage": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"current": 1,
"total": 1,
"unit": "<string>"
},
"queue": {
"is_position_estimated": true,
"position": 1,
"priority": "normal",
"queued_at": "2023-11-07T05:31:56Z",
"scope": "organization"
},
"runner_hint": "<string>",
"served_from": "<string>",
"start_deadline_at": "2023-11-07T05:31:56Z",
"started_at": "2023-11-07T05:31:56Z",
"webhook_endpoint_id": "<string>"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeRun.json",
"data": {
"attempt": 1,
"background": true,
"cancel_url": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"endpoint": "<string>",
"endpoint_release_id": "<string>",
"id": "<string>",
"max_retries": 1,
"object": "run",
"result_url": "<string>",
"status": "queued",
"status_stream_url": "<string>",
"status_url": "<string>",
"version": 2,
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"canceled_at": "2023-11-07T05:31:56Z",
"completed_at": "2023-11-07T05:31:56Z",
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"expires_at": "2023-11-07T05:31:56Z",
"logs": [
{
"created_at": "<string>",
"sequence": 123,
"type": "<string>",
"attempt": 123,
"details": {},
"message": "<string>",
"worker_id": "<string>"
}
],
"metadata": {},
"model": "<string>",
"model_release_id": "<string>",
"output": {
"billing": {
"amount_microusd": 1,
"billable_units": 1,
"currency": "usd",
"discount_basis_points": 5000,
"discount_microusd": 1,
"is_estimate": true,
"measurements": {},
"subtotal_microusd": 1,
"unit": "<string>",
"unit_amount_microusd": 1
},
"data": {
"data": [
{
"id": "<string>",
"index": 123,
"object": "<string>",
"shape": [
123
],
"values": [
123
],
"salience": [
123
]
}
],
"layer": "<string>",
"model_id": "<string>",
"model_release": "<string>",
"object": "<string>",
"pooling": "<string>",
"usage": {
"input_count": 123,
"token_count": 123
},
"provider_request_id": "<string>"
},
"endpoint_release_id": "<string>",
"request_sha256": "<string>",
"usage": {},
"model_release_id": "<string>",
"timings_ms": {}
},
"progress": {
"stage": "<string>",
"updated_at": "2023-11-07T05:31:56Z",
"current": 1,
"total": 1,
"unit": "<string>"
},
"queue": {
"is_position_estimated": true,
"position": 1,
"priority": "normal",
"queued_at": "2023-11-07T05:31:56Z",
"scope": "organization"
},
"runner_hint": "<string>",
"served_from": "<string>",
"start_deadline_at": "2023-11-07T05:31:56Z",
"started_at": "2023-11-07T05:31:56Z",
"webhook_endpoint_id": "<string>"
},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}{
"ok": true,
"provenance": {
"created_at": "<string>",
"operation": "<string>",
"request_id": "<string>",
"server_version": "<string>",
"cache_hit": true,
"database_snapshots": [
{
"name": "<string>",
"version": "<string>",
"digest": "<string>",
"kind": "<string>"
}
],
"generated_object_ids": [
"<string>"
],
"input_hash": "<string>",
"parameters_hash": "<string>",
"tool_versions": [
{
"name": "<string>",
"version": "<string>",
"path": "<string>"
}
]
},
"warnings": [
{
"code": "<string>",
"message": "<string>",
"details": {}
}
],
"$schema": "https://example.com/schemas/ExecutionEnvelopeExecutionErrorData.json",
"data": {},
"error": {
"code": "<string>",
"doc_url": "<string>",
"is_retryable": true,
"message": "<string>",
"type": "invalid_request_error",
"details": {},
"errors": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>",
"url": "<string>",
"ctx": {},
"input": "<unknown>"
}
],
"param": "<string>",
"request_id": "<string>"
},
"evidence": {
"warnings_count": 123,
"duration_ms": 123,
"input_refs": [
"<string>"
],
"object_refs": [
"<string>"
],
"output_refs": [
"<string>"
],
"row_count": 123
}
}Authorizations
A Rafflesia API key, sent as Authorization: Bearer <key>.
Headers
Retry identity for foreground or background creation. The original status, body, and Rafflesia response headers are replayed exactly; a different complete create request returns a conflict.
Maximum string length:
255Caller start deadline in seconds. Queue wait and failed attempts count; execution may continue after a runner starts.
Best-effort affinity hint for a warm execution worker. It never blocks fallback to another worker.
Maximum string length:
256Background queue priority. Low-priority runs start after normal-priority work for the same endpoint.
Available options:
normal, low JSON object whose initial_acl and expiration_duration_seconds apply to every file produced by this run.
Maximum string length:
8192Set to 0 to prevent retention of JSON request and response payloads. Generated files remain governed by the object lifecycle preference.
Available options:
0, 1 Set to 1, true, or yes to disable automatic retries. This takes precedence over Rafflesia-Retry-Config.
Maximum string length:
5JSON retry budgets for server_error, timeout, and connection_error. Each retries value counts additional attempts; ten total attempts is the ceiling.
Maximum string length:
8192Accepted for portability. Rafflesia never substitutes an unpinned endpoint, so fallback is already disabled.
Maximum string length:
5Query Parameters
Reject with 429 when this endpoint already has more queued runs than the supplied non-negative integer across all callers.
Required range:
0 <= x <= 1000000Body
application/json
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
- Option 7
- Option 8
- Option 9
- Option 10
- Option 11
- Option 12
- Option 13
- Option 14
- Option 15
- Option 16
- Option 17
- Option 18
- Option 19
- Option 20
- Option 21
- Option 22
- Option 23
- Option 24
- Option 25
- Option 26
- Option 27
- Option 28
- Option 29
- Option 30
- Option 31
- Option 32
- Option 33
- Option 34
- Option 35
- Option 36
- Option 37
- Option 38
- Option 39
- Option 40
- Option 41
- Option 42
- Option 43
- Option 44
- Option 45
- Option 46
- Option 47
- Option 48
- Option 49
- Option 50
- Option 51
- Option 52
Canonical callable endpoint id returned by GET /v1/models, for example rafflesia/homology.
Available options:
airi-institute/moderngena/base Pattern:
^[a-z0-9][a-z0-9.-]{0,63}(/[a-z0-9][a-z0-9.-]{0,127})+$Endpoint-specific input. Known endpoint schemas are discriminated by RunCreateRequest.oneOf and published in x-rafflesia-run-endpoints.
Show child attributes
Show child attributes
Example:
{
"inputs": [
{
"id": "input-1",
"sequence": "ACGTNACGTNACGTN"
}
],
"output_format": "json",
"pooling": "mean"
}
Run as a durable background task. Omit or set false to wait for completion on this request.
Disable automatic retries for this background run. Otherwise explicitly transient failures may use up to ten total attempts.
Caller-defined labels stored on the run and included in idempotency identity, but not scientific execution identity.
Show child attributes
Show child attributes
Background queue priority. Omit for normal; low work starts only when no normal work for the same endpoint is pending.
Available options:
normal, low Background-only absolute RFC 3339 alternative to start_timeout_ms. The retained run fails if no execution slot opens first.
Maximum time to start. Queue wait and failed attempts count, but execution may continue after a runner starts. Omit for no caller start deadline.
Required range:
x >= 0Background-only registered webhook endpoint that receives this run's enabled lifecycle events. Raw callback URLs are never accepted here.
Pattern:
^whep_[0-9a-f]{24}$Response
OK
Whether the operation succeeded.
Execution provenance.
Show child attributes
Show child attributes
Non-fatal warnings.
Show child attributes
Show child attributes
A URL to the JSON Schema for this object.
Example:
"https://example.com/schemas/ExecutionEnvelopeRun.json"
Operation result data. Absent when the operation did not succeed.
Show child attributes
Show child attributes
Structured execution error information.
Show child attributes
Show child attributes
Mechanical evidence summary for agent inspection and chaining.
Show child attributes
Show child attributes
⌘I