Skip to main content
POST
/
api
/
keys
Create API key
curl --request POST \
  --url https://nexus-dev.gerowallet.io/api/keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "network": "MAINNET",
  "writeAccess": false,
  "name": "Production dashboard"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "My dApp key",
  "apiKey": "nxs_aB3kP9xZmQ7rT2wYvNcLsXhGdEuFjK8",
  "keyPrefix": "nxs_aB3kP9xZ",
  "network": "MAINNET",
  "createdAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://nexus.gerowallet.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

JWT Token Authentication

Body

application/json

Request to create a new API key

​
network
enum<string>
required

Blockchain network this key is scoped to

Available options:
MAINNET,
PREPROD
Example:

"MAINNET"

​
writeAccess
boolean
default:true

Whether this key may submit write operations (e.g. transaction submission). Omit or set true for full access; set false for a read-only key.

Example:

false

​
name
string

Optional human-readable label. If omitted, the backend auto-generates one (cardano-mainnet, cardano-mainnet-2, ...). Must be unique per user.

Required string length: 1 - 100
Example:

"Production dashboard"

Response

Key created

Response returned once at key creation time — includes the full API key

​
id
string<uuid>

API key ID

​
name
string

Human-readable label

Example:

"My dApp key"

​
apiKey
string

Full API key — shown only once at creation, store it securely

Example:

"nxs_aB3kP9xZmQ7rT2wYvNcLsXhGdEuFjK8"

​
keyPrefix
string

First 12 characters of the key for future identification

Example:

"nxs_aB3kP9xZ"

​
network
enum<string>

Blockchain network

Available options:
MAINNET,
PREPROD
Example:

"MAINNET"

​
createdAt
string<date-time>

When the key was created