Skip to main content
POST
/
api
/
user
/
api-keys
Create a new Personal Access Token (browser session only)
curl --request POST \
  --url https://app.auditynow.com/api/user/api-keys \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "Claude Desktop, MacBook Pro",
  "scopes": [
    "read",
    "write"
  ]
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "label": "<string>",
  "tokenPrefix": "<string>",
  "scopes": [
    "read"
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "plaintext": "<string>",
  "expiresAt": "2023-11-07T05:31:56Z",
  "lastUsedAt": "2023-11-07T05:31:56Z"
}

Documentation Index

Fetch the complete documentation index at: https://docs.auditynow.com/llms.txt

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

Authorizations

​
Authorization
string
header
required

A Personal Access Token issued from https://app.auditynow.com/dashboard/settings/api-tokens. Format: aky_<32 random chars>.

Body

application/json
​
label
string
required

Human label for the token (e.g. Claude Desktop, MacBook Pro).

Required string length: 1 - 100
​
scopes
enum<string>[]

Token scopes. Defaults to ["read"] if omitted.

Available options:
read,
write
​
expiresAt
string<date-time> | null

Optional explicit expiry. Server does not enforce a default expiry.

Response

Token created. The plaintext field is returned ONCE, never again.

Safe-to-display metadata for a Personal Access Token. The plaintext token is NEVER returned here, only on creation.

​
id
string<uuid>
required
​
label
string
required

User-supplied label for the token.

​
tokenPrefix
string
required

First 6 chars of the token (e.g. aky_a1b), for visual identification.

​
scopes
enum<string>[]
required
Available options:
read,
write
​
createdAt
string<date-time>
required
​
plaintext
string
required

The full PAT (aky_<32 chars>). Returned ONCE at creation, never retrievable again. Store immediately.

​
expiresAt
string<date-time> | null
​
lastUsedAt
string<date-time> | null