Skip to main content

tetrate agentrouter manage ping

Test connectivity and authentication to the API server using a service account.

If no file is specified, defaults to 'identity.json' in the current directory.

The service account file must be in the API response wrapper format:
{
"serviceAccount": { /* service account config */ },
"checksum": "...",
"checksumAlgorithm": "sha256"
}

The command generates a JWT token from the service account and makes a Connect RPC request
to the tars.test.v1.TestService/Ping endpoint.

Examples:
# Ping using service-account.json in current directory
tetrate agentrouter manage ping

# Ping using a specific service account file
tetrate agentrouter manage ping path/to/service-account.json

# Pretty print the response
tetrate agentrouter manage ping --pretty

# Ping without authentication
tetrate agentrouter manage ping --skip-auth

# Use custom API URL
TETRATE_API_URL=https://api-staging.example.com tetrate agentrouter manage ping

Usage:
tetrate agentrouter manage ping [identity.json] [flags]

Flags:
--pretty Pretty print JSON output
--skip-auth Skip authentication (send request without Authorization header)

Global Flags:
-q, --quiet Suppress progress output; only errors and the final summary go to stderr
-v, --verbose Verbose output: plain-mode progress lines plus full per-blob chunk logs to stderr