Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Hevn Inc auth API

The auth API from Hevn Inc — 7 operation(s) for auth.

Hevn Inc auth API is one of 31 APIs that Hevn Inc publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include auth. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 7 operations across 7 paths, and defines 15 schemas. It is described by OpenAPI 3.1.0, at version 0.1.2.

Requests are made against a single base URL, https://api.hevn.finance.

7 operations 7 paths 15 schemas 7 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
0.1.2
Base URL
https://api.hevn.finance/api/v1
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Hevn Inc auth API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (HTTPBearer). An API key is passed in the header as x-api-key (ApiKeyAuth).

  • ApiKeyAuth — Alternative HEVN API key header. The CLI defaults to Authorization Bearer unless configured with HEVNAPIKEYHEADER=X-Api-Key.

Paths & Operations 7

Across 7 paths, the API surfaces 7 operations — 7 POST. Each is listed below with its method, path, parameters, and response codes.

auth 7
POST
/api/v1/auth/start
Auth Start
auth_start_api_v1_auth_start_post 2 params body → 200422
POST
/api/v1/auth/email_otp
Auth Email Otp
auth_email_otp_api_v1_auth_email_otp_post 1 param body → 200422
POST
/api/v1/auth/totp
Auth Totp
auth_totp_api_v1_auth_totp_post body → 200422
POST
/api/v1/auth/submit_signed_jwt
Submit Signed Jwt
submit_signed_jwt_api_v1_auth_submit_signed_jwt_post body → 200422
POST
/api/v1/auth
Auth Complete
auth_complete_api_v1_auth_post 3 params body → 200422
POST
/api/v1/auth/privy
Auth Privy
auth_privy_api_v1_auth_privy_post 3 params body → 200422
POST
/api/v1/auth/refresh
Refresh Session
refresh_session_api_v1_auth_refresh_post 1 param body → 200422

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are PrivyLoginResponse (6 properties), AuthSessionResponse (5 properties), PrivyLoginRequest (4 properties), AuthStartResponse (3 properties). Each schema is shown below with its type and property counts.

AuthMethod
string
PrivyLoginRequest
object
Request to link a Privy wallet.
4 properties 4 required
RefreshRequest
object
Request for refreshing a session token.
1 property 1 required
SubmitSignedJwtRequest
object
Request for submitting TEE-signed Google JWT attestation.
3 properties 3 required
AuthStartRequest
object
Request schema for starting authentication.
1 property 1 required
AuthStartResponse
object
Response schema for auth start.
3 properties 1 required
ValidationError
object
3 properties 3 required
AuthCompleteRequest
object
Request for completing authentication.
1 property 1 required
TotpLoginRequest
object
Request to complete login with TOTP code.
2 properties 2 required
SessionTokenResponse
object
Response with short-lived JWT session token.
3 properties 1 required
PrivyLoginResponse
object
Response after Privy wallet auth.
6 properties 4 required
StatusResponse
object
Simple status response.
1 property
AuthSessionResponse
object
Response for POST /auth/complete — refresh token.
5 properties 3 required
HTTPValidationError
object
1 property
AuthEmailOtpRequest
object
Request schema for email OTP verification.
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

hevn-inc-auth-api-openapi.yml Raw ↑

Other APIs Hevn Inc publishes across the network.

Hevn Inc 2FA API
Hevn Inc Activity API
Hevn Inc apps API
Hevn Inc apps-transfer API
Hevn Inc B2B API
Hevn Inc Balance API
Hevn Inc Banks API
Hevn Inc Cards API
Hevn Inc Chat API
Hevn Inc contracts API
Hevn Inc Devices API
Hevn Inc documents API