> ## Documentation Index
> Fetch the complete documentation index at: https://inference.docs.tensormesh.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# tm infer health

> Call GET /health on serverless inference.

## When To Use This

Use `tm infer health` when you want a quick reachability check against the serverless host.

The default Tensormesh serverless host currently serves this route without an inference API key.

## Usage

```sh theme={null}
tm infer health [OPTIONS]
```

## Examples

### Check the verified serverless health endpoint.

```sh theme={null}
tm infer health
```

## Options

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `--surface` | `choice[serverless]` | no | `"serverless"` | Inference surface to target. |
| `--api-key` | `text` | no | | Inference API key (Authorization: Bearer ...). |
| `--base-url` | `text` | no | | Override the base URL for the selected surface. |
| `--timeout` | `float` | no | | HTTP connect timeout in seconds for the inference request. |

## Inherited Global Options

| Name | Type | Required | Default | Details | | | | |
| - | - | - | - | - | - | - | - | - |
| `--version`, `-V` | `boolean` | no | `false` | Show the version and exit. Boolean flag. | | | | |
| `--config` | `path` | no | `"~/.config/tensormesh/config.toml"` | Path to config TOML file | | | | |
| `--output` | \`choice\[text | json | yaml | raw | table]\` | no | `"text"` | Output format (text is human-readable; json is machine-friendly). |
| `--quiet` | `boolean` | no | `false` | Suppress non-essential output. Boolean flag. | | | | |
| `--debug` | `boolean` | no | `false` | Print debug logs to stderr (secrets redacted). Boolean flag. | | | | |
| `--ca-bundle` | `path` | no | | Path to a PEM CA bundle for TLS verification (overrides TENSORMESH\_CA\_BUNDLE). | | | | |
| `--max-retries` | `integer` | no | | Max retries for idempotent HTTP requests on transient errors (overrides TENSORMESH\_MAX\_RETRIES; subcommands may override). | | | | |
| `--controlplane-base` | `text` | no | | Override the Control Plane base URL. | | | | |

## Related Commands

* [`tm infer version`](/cli/reference/infer/version)
* [`tm infer models`](/cli/reference/infer/models)

## Parent Command

* [`tm infer`](/cli/reference/infer)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.