# ClawSpan System API

**Canonical:** https://apis.io/apis/clawspan-cloud/clawspan-cloud-system-api/  
**Provider:** ClawSpan — https://apis.io/providers/clawspan-cloud/  
**Base URL:** https://app.clawspan.cloud  
**Documentation:** https://clawspan.cloud/technical/

ClawSpan System API is one of 25 APIs that [ClawSpan](https://apis.io/providers/clawspan-cloud/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include System. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, authentication docs, and rate-limit docs.

Health and operational endpoints

## Operations (33)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/v1/health` | Gateway health and runtime mode |
| GET | `/api/v1/readiness` | Readiness probes (backend/auth/redis/payment checks) |
| GET | `/api/v1/auth/bootstrap` | Authentication bootstrap and JWKS/OIDC readiness metadata |
| GET | `/api/v1/metrics` | In-process gateway metrics snapshot |
| GET | `/api/v1/metrics/prometheus` | Prometheus metrics scrape endpoint |
| GET | `/api/v1/control/plane` | Control-plane autoscaling/backpressure/fail-safe recommendation snapshot |
| GET | `/api/v1/control/plane/history` | Control-plane snapshot history for reliability-policy agents |
| GET | `/api/v1/control/plane/actions` | List privileged control-plane action audit log and current execution state |
| POST | `/api/v1/control/plane/actions` | Execute one privileged control-plane action with deterministic idempotency |
| POST | `/api/v1/control/plane/reconcile` | Execute control-plane remediation queue in one privileged operation |
| GET | `/api/v1/capabilities` | Machine-readable runtime capabilities |
| GET | `/api/v1/capabilities/graph` | Canonical versioned capability graph for agent discoverability |
| GET | `/api/v1/capabilities/graph/{version}` | Fetch one capability graph version |
| GET | `/api/v1/contracts/dual-plane` | Dual-plane authority and bridge contract for machine discoverability |
| GET | `/api/v1/contracts/dual-plane/errors` | Deterministic error catalog aggregated from capability execution contracts |
| GET | `/api/v1/openapi` | OpenAPI description of this gateway |
| POST | `/api/v1/maintenance/payload-ttl/prune` | Prune/redact expired payloads based on TTL policy (admin/system) |
| GET | `/api/health` | Deprecated alias of /api/v1/health |
| GET | `/api/readiness` | Deprecated alias of /api/v1/readiness |
| GET | `/api/auth/bootstrap` | Deprecated alias of /api/v1/auth/bootstrap |
| GET | `/api/metrics` | Deprecated alias of /api/v1/metrics |
| GET | `/api/control/plane` | Deprecated alias of /api/v1/control/plane |
| GET | `/api/control/plane/history` | Deprecated alias of /api/v1/control/plane/history |
| GET | `/api/control/plane/actions` | Deprecated alias of /api/v1/control/plane/actions |
| POST | `/api/control/plane/actions` | Deprecated alias of /api/v1/control/plane/actions |
| POST | `/api/control/plane/reconcile` | Deprecated alias of /api/v1/control/plane/reconcile |
| GET | `/api/capabilities` | Deprecated alias of /api/v1/capabilities |
| GET | `/api/capabilities/graph` | Deprecated alias of /api/v1/capabilities/graph |
| GET | `/api/capabilities/graph/{version}` | Deprecated alias of /api/v1/capabilities/graph/{version} |
| GET | `/api/contracts/dual-plane` | Deprecated alias of /api/v1/contracts/dual-plane |
| GET | `/api/contracts/dual-plane/errors` | Deprecated alias of /api/v1/contracts/dual-plane/errors |
| GET | `/api/openapi` | Deprecated alias of /api/v1/openapi |
| POST | `/api/maintenance/payload-ttl/prune` | Deprecated alias of /api/v1/maintenance/payload-ttl/prune |

## Machine-readable artifacts (13)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/openapi/clawspan-cloud-system-api-openapi.yml
- **Documentation** — https://clawspan.cloud/technical/
- **LLMsTxt** — https://app.clawspan.cloud/llms.txt
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/authentication/clawspan-cloud-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/errors/clawspan-cloud-problem-types.yml
- **ErrorCatalog** — https://app.clawspan.cloud/v1/contracts/dual-plane/errors
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/rate-limits/clawspan-cloud-rate-limits.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/conventions/clawspan-cloud-conventions.yml
- **DataModel** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/data-model/clawspan-cloud-data-model.yml
- **AgenticAccess** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/agentic-access/clawspan-cloud-agentic-access.yml
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/sandbox/clawspan-cloud-sandbox.yml
- **AgentCard** — https://raw.githubusercontent.com/api-evangelist/clawspan-cloud/refs/heads/main/a2a/clawspan-cloud-signalhub-a2a.yml
- **Documentation** — https://clawspan.cloud/signalhub/

## Other ClawSpan APIs (12)

- [ShardLink MCP Server](https://apis.io/apis/clawspan-cloud/shardlink-mcp-server/)
- [ShardLink Control Plane A2A Agent](https://apis.io/apis/clawspan-cloud/shardlink-a2a-agent/)
- [ClawSpan A2A API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-a2a-api/)
- [ClawSpan Affiliate API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-affiliate-api/)
- [ClawSpan Agent API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-agent-api/)
- [ClawSpan Agents API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-agents-api/)
- [ClawSpan Auth API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-auth-api/)
- [ClawSpan Billing API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-billing-api/)
- [ClawSpan Bridge API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-bridge-api/)
- [ClawSpan Delegation API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-delegation-api/)
- [ClawSpan Discovery API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-discovery-api/)
- [ClawSpan Disputes API](https://apis.io/apis/clawspan-cloud/clawspan-cloud-disputes-api/)

## Tags

System

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/clawspan-cloud/clawspan-cloud-system-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/clawspan-cloud/.