> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ariacompute.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create / List API Key - POST,GET /v1/apikeys

> POST /v1/apikeys creates an API key (shown only once); GET /v1/apikeys reports whether a key exists. One key per user.

Each user holds exactly one API key. After creation the raw key is returned **only once** — store it safely. Afterwards you can only use `GET` to check existence; the plaintext is never shown again.

## Endpoint

```http theme={null}
POST /v1/apikeys
GET  /v1/apikeys
```

## Authentication

`Authorization: Bearer <jwt>` or `X-API-Key <sk_...>` (auth only).

## Response (POST)

**api\_key** `string`

The newly created API key (e.g. `sk_aria_...`), shown only once.

**note** `string`

A hint string.

## Response (GET)

**has\_key** `boolean`

Whether the current user already has an API key.

## Example

```bash cURL theme={null}
# Create
curl -X POST https://memo.ariacompute.com/v1/apikeys \
  -H "Authorization: Bearer <jwt>"

# Query
curl https://memo.ariacompute.com/v1/apikeys \
  -H "Authorization: Bearer <jwt>"
```

```json 200 theme={null}
{
  "api_key": "sk_aria_01a2b3c4d5e6f7890abcdef",
  "note": "shown only once"
}
```

```json 200 theme={null}
{
  "has_key": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.