# OpenBao HTTP API

**Canonical:** https://apis.io/apis/openbao/openbao-http-api/  
**Provider:** OpenBao — https://apis.io/providers/openbao/  
**Base URL:** https://{bao_address}/v1  
**Documentation:** https://openbao.org/docs/api/

OpenBao HTTP API is published by [OpenBao](https://apis.io/providers/openbao/) on the [APIs.io](https://apis.io/) network. Tagged areas include Secrets Management, Security, Encryption, and PKI. The published artifact set on APIs.io includes an API reference, API documentation, authentication docs, and rate-limit docs.

The OpenBao HTTP API gives full access to every OpenBao capability over REST-like HTTP verbs. All routes are prefixed with /v1/ and the API is versioned only at that prefix. Authentication is by client token, supplied either in the X-Vault-Token header or as an Authorization Bearer token; each auth method additionally exposes unauthenticated login endpoints. Namespaces are selected with the X-Vault-Namespace header or by full path. Requests and responses are JSON, LIST is used as an HTTP verb alongside GET/POST/PUT/PATCH/DELETE, and errors are returned in a common {"errors": [...]} envelope for any status >= 400.

## Machine-readable artifacts (9)

- **APIReference** — https://openbao.org/docs/api/
- **Documentation** — https://openbao.org/docs/
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/authentication/openbao-authentication.yml
- **ErrorCatalog** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/errors/openbao-problem-types.yml
- **Conventions** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/conventions/openbao-conventions.yml
- **Idempotency** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/conventions/openbao-conventions.yml
- **RateLimits** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/rate-limits/openbao-rate-limits.yml
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/asyncapi/openbao-audit-events.yml
- **APIsJSON** — https://raw.githubusercontent.com/api-evangelist/openbao/refs/heads/main/apis.yml

## Tags

Secrets Management, Security, Encryption, PKI

---

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