Information
- OpenAPI version:
3.1.0
Overview
HarperHarbor Open API 1
Section titled “HarperHarbor Open API 1”The provider contract HarperHarbor implements: identity (OAuth 2.1 with PKCE, dynamic client registration, resource indicators), agent configuration, Lorebooks, hosted assets, model rates and durable conversations. Conversation endpoints require chat.play; supported capabilities are documented per operation. Base path /open/v1; error codes are listed per endpoint.
Authentication
Section titled “Authentication”userToken
Section titled “userToken”OAuth 2.1 user access token obtained from /oauth/token.
Security scheme type: http
serviceKey
Section titled “serviceKey”Long-lived personal API key, created and revoked by its owner in the provider’s own console. It authenticates as that user. HarperHarbor uses the hh_live_ prefix.
Security scheme type: http
AuthorBearer
Section titled “AuthorBearer”Security scheme type: http
HostingIssuerKey
Section titled “HostingIssuerKey”Security scheme type: apiKey
Header parameter name: X-Hosting-Key
appToken
Section titled “appToken”Application access token issued by /oauth/token with grant_type=client_credentials and the rewards.report scope; user access tokens and personal API keys are refused.
Security scheme type: oauth2
Flow type: clientCredentials
Token URL: /oauth/token
Scopes:
- rewards.report - Report application reward events