Create example set configuration
POST /example-sets/{exampleSetId}/configurations
Creates a new configuration version for the example set. The new configuration becomes the active configuration.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”ID of the example set to create configuration for
ID of the example set to create configuration for
Request Body
Section titled “Request Body ”object
Example set inputs schema for this version
object
File inputs/outputs
object
Unique identifier for this file slot
Human-readable label for the file (e.g., ‘Input Document’)
Optional description of what this file represents
Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)
Whether this file is required
Whether multiple files can be selected for this slot
How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks
Dataset inputs/outputs
object
Unique identifier for this dataset slot
Human-readable label for the dataset (e.g., ‘Training Data’)
Optional description of what this dataset represents
JSON Schema describing the expected dataset structure
Whether this dataset is required
Whether multiple datasets can be selected for this slot
Optional row-level filter applied to any dataset in this slot
object
Column name in the dataset table
object
Reference to an input value (e.g., ‘input.dataInputs.tenantId’)
Structured data inputs/outputs
object
Unique identifier for this data input slot
Human-readable label for the data input (e.g., ‘Parameters’)
Optional description of what this data input represents
JSON Schema describing the expected data structure
Whether this data input is required
Example set outputs schema for this version
object
File inputs/outputs
object
Unique identifier for this file slot
Human-readable label for the file (e.g., ‘Input Document’)
Optional description of what this file represents
Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)
Whether this file is required
Whether multiple files can be selected for this slot
How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks
Dataset inputs/outputs
object
Unique identifier for this dataset slot
Human-readable label for the dataset (e.g., ‘Training Data’)
Optional description of what this dataset represents
JSON Schema describing the expected dataset structure
Whether this dataset is required
Whether multiple datasets can be selected for this slot
Optional row-level filter applied to any dataset in this slot
object
Column name in the dataset table
object
Reference to an input value (e.g., ‘input.dataInputs.tenantId’)
Structured data inputs/outputs
object
Unique identifier for this data input slot
Human-readable label for the data input (e.g., ‘Parameters’)
Optional description of what this data input represents
JSON Schema describing the expected data structure
Whether this data input is required
Example set configuration for this version
object
File configurations
object
Unique identifier for this file slot
Human-readable label for the file (e.g., ‘Input Document’)
Optional description of what this file represents
Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)
Whether this file is required
Whether multiple files can be selected for this slot
How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks
Dataset configurations
object
Unique identifier for this dataset slot
Human-readable label for the dataset (e.g., ‘Training Data’)
Optional description of what this dataset represents
JSON Schema describing the expected dataset structure
Whether this dataset is required
Whether multiple datasets can be selected for this slot
Optional row-level filter applied to any dataset in this slot
object
Column name in the dataset table
object
Reference to an input value (e.g., ‘input.dataInputs.tenantId’)
Structured data configurations
object
Unique identifier for this data input slot
Human-readable label for the data input (e.g., ‘Parameters’)
Optional description of what this data input represents
JSON Schema describing the expected data structure
Whether this data input is required
object
Structured data value matching the schema
LLM handler configuration
object
LLM model in {provider}/{model} format (e.g., vertexai/gemini-3-flash-preview)
Generation temperature (0 = deterministic, 2 = creative)
Maximum output tokens
Web search configuration for automatic context retrieval
object
Enable automatic web search query generation and execution
Maximum number of queries to generate (1-5, default: 3)
Maximum results per query (1-20, default: 5)
Search depth: basic (1 credit) or advanced (2 credits, default: basic)
Include AI-generated answer summary from Tavily (default: false)
URL scraping configuration
object
Enable automatic URL detection and scraping (default: true)
Content type for scraped pages (default: ‘markdown’)
Enable JavaScript rendering (default: true)
Maximum planning/retrieval iterations. Each iteration plans what to retrieve, fetches context, and evaluates sufficiency before answering.
Optional reason for creating this version
Responses
Section titled “ Responses ”Configuration created successfully
object
Unique identifier for this configuration version
ID of the parent example set
Example set inputs schema at this version
object
File inputs/outputs
object
Unique identifier for this file slot
Human-readable label for the file (e.g., ‘Input Document’)
Optional description of what this file represents
Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)
Whether this file is required
Whether multiple files can be selected for this slot
How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks
Dataset inputs/outputs
object
Unique identifier for this dataset slot
Human-readable label for the dataset (e.g., ‘Training Data’)
Optional description of what this dataset represents
JSON Schema describing the expected dataset structure
Whether this dataset is required
Whether multiple datasets can be selected for this slot
Optional row-level filter applied to any dataset in this slot
object
Column name in the dataset table
object
Reference to an input value (e.g., ‘input.dataInputs.tenantId’)
Structured data inputs/outputs
object
Unique identifier for this data input slot
Human-readable label for the data input (e.g., ‘Parameters’)
Optional description of what this data input represents
JSON Schema describing the expected data structure
Whether this data input is required
Example set outputs schema at this version
object
File inputs/outputs
object
Unique identifier for this file slot
Human-readable label for the file (e.g., ‘Input Document’)
Optional description of what this file represents
Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)
Whether this file is required
Whether multiple files can be selected for this slot
How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks
Dataset inputs/outputs
object
Unique identifier for this dataset slot
Human-readable label for the dataset (e.g., ‘Training Data’)
Optional description of what this dataset represents
JSON Schema describing the expected dataset structure
Whether this dataset is required
Whether multiple datasets can be selected for this slot
Optional row-level filter applied to any dataset in this slot
object
Column name in the dataset table
object
Reference to an input value (e.g., ‘input.dataInputs.tenantId’)
Structured data inputs/outputs
object
Unique identifier for this data input slot
Human-readable label for the data input (e.g., ‘Parameters’)
Optional description of what this data input represents
JSON Schema describing the expected data structure
Whether this data input is required
Example set configuration at this version
object
File configurations
object
Unique identifier for this file slot
Human-readable label for the file (e.g., ‘Input Document’)
Optional description of what this file represents
Accepted file types (MIME types or extensions, e.g., ‘.pdf,.docx’)
Whether this file is required
Whether multiple files can be selected for this slot
How file content is retrieved: ‘semantic’ uses vector similarity search, ‘full’ returns all chunks
Dataset configurations
object
Unique identifier for this dataset slot
Human-readable label for the dataset (e.g., ‘Training Data’)
Optional description of what this dataset represents
JSON Schema describing the expected dataset structure
Whether this dataset is required
Whether multiple datasets can be selected for this slot
Optional row-level filter applied to any dataset in this slot
object
Column name in the dataset table
object
Reference to an input value (e.g., ‘input.dataInputs.tenantId’)
Structured data configurations
object
Unique identifier for this data input slot
Human-readable label for the data input (e.g., ‘Parameters’)
Optional description of what this data input represents
JSON Schema describing the expected data structure
Whether this data input is required
object
Structured data value matching the schema
LLM handler configuration
object
LLM model in {provider}/{model} format (e.g., vertexai/gemini-3-flash-preview)
Generation temperature (0 = deterministic, 2 = creative)
Maximum output tokens
Web search configuration for automatic context retrieval
object
Enable automatic web search query generation and execution
Maximum number of queries to generate (1-5, default: 3)
Maximum results per query (1-20, default: 5)
Search depth: basic (1 credit) or advanced (2 credits, default: basic)
Include AI-generated answer summary from Tavily (default: false)
URL scraping configuration
object
Enable automatic URL detection and scraping (default: true)
Content type for scraped pages (default: ‘markdown’)
Enable JavaScript rendering (default: true)
Maximum planning/retrieval iterations. Each iteration plans what to retrieve, fetches context, and evaluates sufficiency before answering.
When this configuration version was created
User who created this configuration version
Optional description of why this version was created
Bad Request - Validation error or invalid input
object
Unauthorized - Authentication required or invalid token
object
Forbidden - Insufficient permissions
object
Not Found - Resource does not exist