Skip to Content
API ReferenceToolPOST /create

POST /tool/create

Create Tool

Create tools using composable infra architecture.

Request Body (CreateToolApiRequest)

FieldTypeRequiredDescription
toolsCreateToolItem[]YesList of tools to create
idempotency_keystringNoOperation key for ack — promotes or rejects a dormant create
softbooleanNoStage the create dormant (active=False) — propose; the ack ({idempotency_key, accept}) promotes/rejects it
acceptbooleanNoAccept (promote) or reject dormant state. Only meaningful with idempotency_key

Response (CreateToolApiResponse)

FieldTypeRequiredDescription
resultsToolResultItem[]YesList of operation results
idempotency_keystringNoIdempotency key echoed back for client correlation
toolsListToolApiTool[]NoHydrated rows for the created tools (same shape as /tool/search returns)
Last updated on