Generate a new API key with Vault storage

POST

/api/v1/api-keys

API Keys

Creates a new API key for the authenticated user with secure storage in Vault

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://transactions.srblabs.io/api/v1/api/v1/api-keys' \
--header 'Content-Type: application/json' \
--data-raw '{
    "expires_at": "string",
    "name": "string",
    "organization_id": "string",
    "permissions": [
        "string"
    ]
}'

Response Example

201 - Example 1

{
  "data": {
    "created_at": "string",
    "expires_at": "string",
    "id": "string",
    "key": "string",
    "last_used_at": "string",
    "name": "string",
    "organization_id": "string",
    "permissions": [
      "string"
    ],
    "status": "string"
  },
  "message": "Operation completed successfully",
  "success": true
}

Request

Body Params application/json

expires_at

string

optional

ISO format: YYYY-MM-DDTHH:MM:SSZ

name

string

required

>= 3 characters<= 100 characters

organization_id

string

optional

Optional organization ID

permissions

array[string]

optional

Examples

Responses

🟢201Created

application/json

Created

Body

data

object

model.APIKeyResponse

optional

created_at

string

optional

expires_at

string

optional

string

optional

key

string

optional

Only included when first created

last_used_at

string

optional

name

string

optional

organization_id

string

optional

permissions

array[string]

optional

status

string

optional

message

string

optional

Example:

Operation completed successfully

success

boolean

optional

Example:

true

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Modified at 2025-04-30 01:06:49

List user's API keys

Get API key details