Skip to main content

Account Management

API Keys​

POST /user-api-keys​

Create a new API key.

Authentication: JWT

Request Body:

{
  "name": "My Agent Key",
  "expiresAt": "2025-12-31T23:59:59Z"
}

Response:

{
  "apiKey": {
    "id": "api-key-id",
    "name": "My Agent Key",
    "type": "user",
    "scopes": [
      "transactions:create:own",
      "transactions:approve:own",
      "transactions:read:own"
    ],
    "active": true,
    "expiresAt": "2025-12-31T23:59:59Z",
    "createdAt": "2024-08-18T15:30:00Z"
  },
  "secret": "nava_live_abc123def456..."
}

The secret is returned once at creation time. Store it securely.

GET /user-api-keys​

List your API keys.

Authentication: JWT

DELETE /user-api-keys/:apiKeyId​

Revoke an API key.

Authentication: JWT

Status Codes: 200 Revoked, 404 Not found

User Settings​

GET /settings​

Get your current settings.

Authentication: JWT

Response:

{
  "id": "settings-id",
  "userId": "user-id",
  "executionType": 1,
  "walletProvider": "privy",
  "createdAt": "2024-01-01T00:00:00.000Z",
  "updatedAt": "2024-01-01T00:00:00.000Z"
}
FieldTypeDescription
executionTypenumber0 = DIRECT_USER, 1 = USER_EXECUTED, 2 = AGENT_EXECUTED
walletProviderstringWallet provider in use

PUT /settings​

Update your settings.

Authentication: JWT

Request Body:

{
  "executionType": 1
}