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

# squarecloud app network

> Manages DNS, custom domains and edge observability for your application on Square Cloud.

Covers DNS records, custom domains and edge observability (analytics, errors, logs, latency and cache) for an application. The application ID is optional in every subcommand: the CLI resolves it from the argument, then the `squarecloud.app` config file in the current directory, then an interactive picker.

```bash theme={null}
squarecloud app network dns
# Shows the DNS records required to point a custom domain at the application.
```

```bash theme={null}
squarecloud app network domain example.com --app <appID>
# Sets the custom domain of the application.
```

Analytics, errors, logs and performance all accept `--start`/`--end` (RFC 3339 timestamps), defaulting to the last 24 hours:

```bash theme={null}
squarecloud app network analytics
# Summarizes visits, requests and traffic for the last 24 hours.
```

```bash theme={null}
squarecloud app network analytics --start 2026-07-01T00:00:00Z --end 2026-07-02T00:00:00Z --country BR --status 200
# Filters analytics by a custom window and one or more of: --country, --ip, --path, --status, --os,
# --browser, --protocol, --referer, --provider, --content-type, --bot.
```

```bash theme={null}
squarecloud app network errors
# Summarizes 5xx edge errors for the last 24 hours, with the top failing paths.
```

```bash theme={null}
squarecloud app network errors --include-4xx
# Also includes 4xx responses in the error breakdown.
```

```bash theme={null}
squarecloud app network logs
# Shows recent edge request logs. Requires a Pro or Enterprise plan.
```

```bash theme={null}
squarecloud app network performance
# Shows edge and origin latency percentiles (p50/p95/p99) and the slowest paths. Requires a Pro or Enterprise plan.
```

```bash theme={null}
squarecloud app network purge-cache
# Purges the entire edge cache of the application.
```

The `purge-cache` subcommand is destructive: it asks for `y/N` confirmation before purging. Pass `-y`/`--yes` to skip the prompt.

`dns`, `analytics`, `errors`, `logs` and `performance` accept `--json` for raw machine-readable output.

Use `squarecloud app network --help` for more information about this command.
