Toolboxes
Create a new version of a toolbox
Creates a new toolbox version, provisioning the toolbox itself if it does not already exist.
Parâmetros de caminho
name
string
obrigatório
The name of the toolbox. If the toolbox does not exist, it will be created.
Parâmetros de consultas
api-version
string
obrigatório
The API version to use for this operation.
Corpo do Pedido
description
string
A human-readable description of the toolbox.
metadata
object
Arbitrary key-value metadata to associate with the toolbox.
tools
ToolboxTool[]
obrigatório
The list of tools to include in this version.
skills
ToolboxSkill[]
The list of skill sources to include in this version. A skill reference specifies a skill name and optionally a version. If version is omitted, the skill's default version is used.
policies
ToolboxPolicies
Policy configuration for a toolbox, including content safety and other governance settings.
rai_config
RaiConfig
Configuration for Responsible AI (RAI) content filtering and safety features.
rai_policy_name
string
obrigatório
The name of the RAI policy to apply.
invocations_moderation
RaiInvocationModeration
Declares where request/response text lives so content-safety guardrails can extract it.
input_content_type
string | enum
How an invocations request/response body is parsed to locate text for content-safety moderation.
enum
output_content_type
string | enum
How an invocations request/response body is parsed to locate text for content-safety moderation.
enum
response_mode
string | enum
obrigatório
Author-declared response shape for the invocations protocol.
enum
input_paths
string[]
Path(s) to user text in the REQUEST body. Required when input_content_type is json.
output_paths
string[]
Path(s) to agent text in a NON-STREAMING response body. Required when response_mode is non_streaming/both and output_content_type is json.
stream_selectors
RaiSseTextSelector[]
One SSE event->field selector per event type carrying text. Required when response_mode is streaming/both and output_content_type is json.
Respostas
The request has succeeded.
Corpo
metadata
object | null
obrigatório
Set of 16 key-value pairs that can be attached to an object. This can be useful for storing additional information about the object in a structured format, and querying for objects via API or the dashboard. Keys are strings with a maximum length of 64 characters. Values are strings with a maximum length of 512 characters.
id
string
obrigatório
The unique identifier of the toolbox version.
name
string
obrigatório
The name of the toolbox.
version
string
obrigatório
The version identifier of the toolbox. Toolbox versions are immutable and every update creates a new version.
description
string
A human-readable description of the toolbox.
created_at
integer
obrigatório
The Unix timestamp (seconds) when the toolbox version was created.
tools
ToolboxTool[]
obrigatório
The list of tools contained in this toolbox version.
skills
ToolboxSkill[]
The list of skill sources included in this toolbox version.
policies
ToolboxPolicies
Policy configuration for a toolbox, including content safety and other governance settings.
rai_config
RaiConfig
Configuration for Responsible AI (RAI) content filtering and safety features.
rai_policy_name
string
obrigatório
The name of the RAI policy to apply.
invocations_moderation
RaiInvocationModeration
Declares where request/response text lives so content-safety guardrails can extract it.
input_content_type
string | enum
How an invocations request/response body is parsed to locate text for content-safety moderation.
enum
output_content_type
string | enum
How an invocations request/response body is parsed to locate text for content-safety moderation.
enum
response_mode
string | enum
obrigatório
Author-declared response shape for the invocations protocol.
enum
input_paths
string[]
Path(s) to user text in the REQUEST body. Required when input_content_type is json.
output_paths
string[]
Path(s) to agent text in a NON-STREAMING response body. Required when response_mode is non_streaming/both and output_content_type is json.
stream_selectors
RaiSseTextSelector[]
One SSE event->field selector per event type carrying text. Required when response_mode is streaming/both and output_content_type is json.
Pedir
POST /toolboxes/{name}/versions HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json