> ## Documentation Index
> Fetch the complete documentation index at: https://openrouter-d02e98a0-mintlify-5b6e02fd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# CustomToolCallItem - Python SDK

> CustomToolCallItem method reference

<Warning>
  The Python SDK and docs are currently in beta.
  Report issues on [GitHub](https://github.com/OpenRouterTeam/python-sdk/issues).
</Warning>

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

| Field       | Type                                                                                                     | Required             | Description                                                                                     |
| ----------- | -------------------------------------------------------------------------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------- |
| `call_id`   | *str*                                                                                                    | :heavy\_check\_mark: | N/A                                                                                             |
| `id`        | *Optional\[str]*                                                                                         | :heavy\_minus\_sign: | N/A                                                                                             |
| `input`     | *str*                                                                                                    | :heavy\_check\_mark: | N/A                                                                                             |
| `name`      | *str*                                                                                                    | :heavy\_check\_mark: | N/A                                                                                             |
| `namespace` | *Optional\[str]*                                                                                         | :heavy\_minus\_sign: | Namespace qualifier for tools registered as part of a namespace tool group (e.g. an MCP server) |
| `type`      | [components.CustomToolCallItemType](/client-sdks/python/api-reference/components/customtoolcallitemtype) | :heavy\_check\_mark: | N/A                                                                                             |