v2
latestOpenAPI 3.1.02026-07-26143251806.6 KBrequest
Log Request
post/log-request
Request body
providerstring required
modelstring required
request_start_timestring date-time required
request_end_timestring date-time required
parametersobject
Model parameters including temperature, max_tokens, etc. Can also include structured output configuration via response_format.json_schema. See documentation for structured output examples.
tagsstring[]
metadataobject
Custom key-value pairs for tracking additional request information. Keys are limited to 1024 characters.
prompt_namestring nullable
prompt_idinteger nullable
The ID of the prompt template used for this request. This is useful for tracking which prompt was used in the request.
prompt_version_numberinteger nullable
prompt_input_variablesobject
input_tokensinteger
output_tokensinteger
pricenumber
function_namestring
scoreinteger
api_typestring nullable
status'SUCCESS' | 'WARNING' | 'ERROR'
Request status.
| Value | Description |
|---|---|
| SUCCESS | Request completed successfully (default) |
| WARNING | Request succeeded but had issues (e.g., retries, degraded response) |
| ERROR | Request failed |
error_type'PROVIDER_TIMEOUT' | 'PROVIDER_QUOTA_LIMIT' | 'PROVIDER_RATE_LIMIT' | 'PROVIDER_PARTIAL_RESPONSE' | 'PROVIDER_AUTH_ERROR' | 'PROVIDER_ERROR' | 'TEMPLATE_RENDER_ERROR' | 'VARIABLE_MISSING_OR_EMPTY' | 'UNKNOWN_ERROR' nullable
Categorized error type.
| Value | Description | Allowed Statuses |
|---|---|---|
| PROVIDER_RATE_LIMIT | Rate limit hit on provider API | WARNING, ERROR |
| PROVIDER_QUOTA_LIMIT | Account quota or spending limit exceeded | WARNING, ERROR |
| PROVIDER_PARTIAL_RESPONSE | Provider returned a successful response, but the saved output may be incomplete, filtered, blocked, malformed, or otherwise partial | WARNING |
| VARIABLE_MISSING_OR_EMPTY | Required template variable was missing or empty | WARNING |
| PROVIDER_TIMEOUT | Request timed out | ERROR |
| PROVIDER_AUTH_ERROR | Authentication failed with provider | ERROR |
| PROVIDER_ERROR | General provider-side error | ERROR |
| TEMPLATE_RENDER_ERROR | Failed to render prompt template | ERROR |
| UNKNOWN_ERROR | Uncategorized error | WARNING, ERROR |
error_messagestring nullable
Detailed error message describing what went wrong. Maximum 1024 characters.
Response
Successful Response
idinteger required
status'SUCCESS' | 'WARNING' | 'ERROR'
Request status indicating success, warning, or error.
error_typestring nullable
Categorized error type if status is WARNING or ERROR.
error_messagestring nullable
Detailed error message if status is WARNING or ERROR.