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
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Hevn Inc

Hevn Inc apps API

The apps API from Hevn Inc — 10 operation(s) for apps.

Documentation Provider Profile APIs.io OpenAPI GitHub

Hevn Inc apps 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 apps. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 12 operations across 10 paths, and defines 19 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.

12 operations 10 paths 19 schemas 2 DELETE5 GET4 POST1 PUT

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 apps 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 12

Across 10 paths, the API surfaces 12 operations — 2 DELETE, 5 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

apps 12
POST
/api/v1/apps
Create a new API app
create_app_api_v1_apps_post 1 param body → 200422
GET
/api/v1/apps
List user's API apps
list_apps_api_v1_apps_get 1 param → 200422
GET
/api/v1/apps/{app_id}
App details: keys + matching spend permissions
get_app_api_v1_apps__app_id__get 2 params → 200422
DELETE
/api/v1/apps/{app_id}
Delete an API app (soft-delete; cascades to all keys)
delete_app_api_v1_apps__app_id__delete 2 params → 200422
PUT
/api/v1/apps/{app_id}/access
Replace an app's access (cards/banks/scope) — owner only
update_app_access_api_v1_apps__app_id__access_put 2 params body → 200422
POST
/api/v1/apps/{app_id}/keys
Issue a new API key under the app (raw key returned ONCE)
create_app_key_api_v1_apps__app_id__keys_post 2 params body → 200422
DELETE
/api/v1/apps/{app_id}/keys/{key_id}
Revoke an API key from the app (soft-delete)
delete_app_key_api_v1_apps__app_id__keys__key_id__delete 3 params → 200422
GET
/api/v1/apps/{app_id}/activity
Recent notifications produced by this app's API keys
get_app_activity_api_v1_apps__app_id__activity_get 4 params → 200422
POST
/api/v1/apps/{app_id}/transferdeprecated
Legacy app-id transfer route
transfer_api_v1_apps__app_id__transfer_post 3 params body → 200422
GET
/api/v1/apps/me
Introspect the current API key
me_api_v1_apps_me_get 1 param → 200422
POST
/api/v1/apps/transfer
Send USDC from the app resolved by the API key
transfer_api_v1_apps_transfer_post 2 params body → 200422
GET
/api/v1/apps/transfers
List transfers for the app resolved by the API key
list_transfers_api_v1_apps_transfers_get 4 params → 200422

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are SmartWalletPermissionResponse (14 properties), ApiAppDetailResponse (9 properties), NotificationResponse (8 properties), ApiAppResponse (7 properties). Each schema is shown below with its type and property counts.

ApiAppDetailResponse
object
9 properties 7 required
ValidationError
object
3 properties 3 required
ApiAppResponse
object
7 properties 7 required
HTTPValidationError
object
1 property
AppTransferContext
object
Body of POST /apps/transfer. Exactly one of contactId / quoteId / invoiceId MUST be set (mirrors the /mcp/transfer body). amount is required when contactId is…
5 properties
NotificationListResponse
object
List of notifications response.
2 properties 2 required
ApiAppAccess
object
3 properties
ApiKeyListItem
object
Used in GET contexts — does NOT include raw key.
6 properties 6 required
app__schemas__routers__apps__ApiKeyResponse
object
Returned ONCE on key creation — includes raw key.
7 properties 7 required
McpTransactionResponse
object
6 properties 2 required
SmartWalletPermissionResponse
object
14 properties 14 required
app__schemas__routers__apps__ApiKeyCreateRequest
object
1 property 1 required
NotificationChannel
string
Notification delivery channel.
AppsMeResponse
object
Introspection response for the API key used by HEVN CLI whoami. Includes user identity, owning app, scopes, balance, and remaining spend limit.
7 properties 1 required
PermissionStatus
string
Spend permission status.
ApiAppCreateRequest
object
2 properties 1 required
AppTransferResponse
object
1 property 1 required
NotificationResponse
object
Single notification response.
8 properties 5 required
NotificationType
string
Notification type — matches the kind of event being notified.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

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

Other APIs Hevn Inc publishes across the network.

Hevn Inc 2FA API
AE Profile APIs.io
Hevn Inc Activity API
AE Profile APIs.io
Hevn Inc apps-transfer API
AE Profile APIs.io
Hevn Inc auth API
AE Profile APIs.io
Hevn Inc B2B API
AE Profile APIs.io
Hevn Inc Balance API
AE Profile APIs.io
Hevn Inc Banks API
AE Profile APIs.io
Hevn Inc Cards API
AE Profile APIs.io
Hevn Inc Chat API
AE Profile APIs.io
Hevn Inc contracts API
AE Profile APIs.io
Hevn Inc Devices API
AE Profile APIs.io
Hevn Inc documents API
AE Profile APIs.io
#apps
← Back to H APIs
API Details
ID
hevn-inc:hevn-inc-apps-api
Base URL
https://api.hevn.finance/api/v1
Docs
https://hevninc.mintlify.app/
Provider
Hevn Inc
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network