# Cleared Protocol API V1 API

**Canonical:** https://apis.io/apis/clearedpay-xyz/cleared-protocol-api-v1-api/  
**Provider:** Cleared — https://apis.io/providers/clearedpay-xyz/  
**Base URL:** /v1  
**Documentation:** https://clearedpay.xyz/docs/api/overview

Cleared Protocol API V1 API is one of 2 APIs that [Cleared](https://apis.io/providers/clearedpay-xyz/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. The published artifact set on APIs.io includes an OpenAPI specification and 1 JSON Schema.

Versioned API for web users, SDK integrators, and AI agents. See ADR-012.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| POST | `/oauth/authorize` | Approve or deny CLI authorization |
| POST | `/oauth/token` | Exchange a PKCE code or rotate a refresh token |
| POST | `/oauth/revoke` | Revoke a CLI OAuth grant using refresh-token proof |
| GET | `/oauth/session` | Read redacted CLI OAuth session metadata |
| POST | `/oauth/revoke/current` | Revoke the current CLI OAuth grant |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/clearedpay-xyz/openapi/_original/clearedpay-xyz-v1-openapi.json
- **JSONSchema** — https://artifacts.apis.io/clearedpay-xyz/json-schema/clearedpay-xyz-cli-oauth-token-schema.json

## Other Cleared APIs (1)

- [Cleared API](https://apis.io/apis/clearedpay-xyz/cleared-api/)

---

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