Python SDKAPI ReferenceComponents

CustomToolCallItem - Python SDK

CustomToolCallItem method reference

The Python SDK and docs are currently in beta. Report issues on GitHub.

A call to a custom (freeform-grammar) tool created by the model — distinct from function_call. Used for tools like Codex CLI’s apply_patch whose payload is opaque text rather than JSON arguments.

Fields

FieldTypeRequiredDescription
call_idstr✔️N/A
idOptional[str]➖N/A
inputstr✔️N/A
namestr✔️N/A
namespaceOptional[str]➖Namespace qualifier for tools registered as part of a namespace tool group (e.g. an MCP server)
typecomponents.CustomToolCallItemType✔️N/A