# list_inference_tools

List the Layer tools the user can run in the workspace, such as \`image.upscale\` or \`video.reframe\`.

A tool is one job (upscale an image, make a seamless texture, reframe a video) that runs on any  
model in its pool; it shows only the fields that job needs and fixes the rest. Each tool names the  
base models the user can run it on and the one a run takes when it names none. Prefer a tool to  
\`execute\_forge\` when the user's request is one of these jobs.

IMPORTANT: Call tool \`get\_instructions\` first for general platform guidance.

## Parameters

| Parameter             | Type            | Default | Description                                                                                                                                                                                                           |
| --------------------- | --------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| project\_id           | string (uuid)   | —       | Optional project the work would be filed in: the models and defaults answered are those a run in it gets. Use \`list\_projects\` to find project ids. Without it or \`session\_id\`, the answer is for the workspace. |
| session\_id           | string (uuid)   | —       | Optional session the work would land in: the answer is for its project. With \`project\_id\`, the session must be in that project.                                                                                    |
| workspace\_idrequired | string (uuid)   | —       | The user's workspace id.                                                                                                                                                                                              |
| modality              | enum            | —       | Only the tools that make this modality.One of: text, image, audio, video, three\_d, playable, world                                                                                                                   |
| group                 | enum            | —       | Only the tools that make something new (\`generate\`) or change an asset (\`edit\`).One of: generate, edit                                                                                                            |
| pagination            | PaginationInput | —       | Page through the tools; without it, the first 20.                                                                                                                                                                     |
| limit                 | integer1–100    | 20      | Maximum number of results to return                                                                                                                                                                                   |
| cursor                | string          | —       | Cursor from which to return results                                                                                                                                                                                   |