Skip to main content
POST
Import Request Logs Into Table Sheet
Start an asynchronous request-history import into an existing sheet. Provide either request_log_ids or a request-log filter_group. You can also pass variables_to_parse, include_fields, and limit to control imported columns and rows. request_log_ids and limit support up to 50,000 rows. Pass operation_id when you want a stable client-side identifier for polling and webhook correlation. If omitted, PromptLayer generates one. The response returns an operation_id and status_url for polling with Get Sheet Import Operation.

Authorizations

X-API-KEY
string
header
required

Headers

X-API-KEY
string
required

Your PromptLayer API key. The key's workspace scopes table resources for this request.

Path Parameters

table_id
string<uuid>
required

Table ID.

sheet_id
string<uuid>
required

Table sheet ID.

Body

application/json

Import request history into an existing Table sheet. Provide either request_log_ids or filter_group.

filter_group
StructuredFilterGroup · object | null

Nested filter group with AND/OR logic. Use this for complex queries.

q
string | null

Free-text request-log search query applied with filter_group.

sort_by
enum<string> | null

Field to sort matching request logs before import.

Available options:
request_start_time,
input_tokens,
output_tokens,
cost,
latency_ms,
status
sort_order
enum<string> | null

Sort direction. Must be provided together with sort_by.

Available options:
asc,
desc
metadata_cost_breakdown_key
string | null

Request-log query metadata key used by shared request-log query payloads.

operation_id
string | null

Optional client-provided operation ID. A UUID is generated when omitted.

request_log_ids
integer[] | null

Specific request log IDs to import.

Required array length: 1 - 50000 elements
Required range: x >= 1
variables_to_parse
string[]

Input variable names to parse from matching request logs.

include_fields
string[] | null

Additional request log fields to include as columns.

limit
integer | null

Maximum number of matching request logs to import.

Required range: 1 <= x <= 50000

Response

Request-history import queued.

success
boolean
required
message
string
required
operation_id
string
required
operation
object
required

Status of an asynchronous sheet import operation.

status_url
string
required