Sign in
Structured Outputs

Run Structured Output

post/structured-output/run

Request body

previewEnabledboolean

This is the preview flag for the re-run. If true, the re-run will be executed and the response will be returned immediately and the call artifact will NOT be updated. If false (default), the re-run will be executed and the response will be updated in the call artifact.

structuredOutputIdstring

This is the ID of the structured output that will be run. This must be provided unless a transient structured output is provided. When the re-run is executed, only the value of this structured output will be replaced with the new value, or added if not present.

callIdsstring[] required

This is the array of callIds that will be updated with the new structured output value. If preview is true, this array must be provided and contain exactly 1 callId. If preview is false, up to 100 callIds may be provided.

Response

idstring required

This is the unique identifier for the structured output.

orgIdstring required

This is the unique identifier for the org that this structured output belongs to.

createdAtstring date-time required

This is the ISO 8601 date-time string of when the structured output was created.

updatedAtstring date-time required

This is the ISO 8601 date-time string of when the structured output was last updated.

namestring required

This is the name of the structured output.

descriptionstring

This is the description of what the structured output extracts.

Use this to provide context about what data will be extracted and how it will be used.

assistantIdsstring[]

These are the assistant IDs that this structured output is linked to.

When linked to assistants, this structured output will be available for extraction during those assistant's calls.

workflowIdsstring[]

These are the workflow IDs that this structured output is linked to.

When linked to workflows, this structured output will be available for extraction during those workflow's execution.

Changes