> ## 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 ROUTER API Key API

> Create a new API key for the Aria Compute ROUTER. Returns the full secret key once; store it securely. Optional scopes restrict permissions.

Use the Create Key endpoint to generate a new API key for accessing the Aria Compute ROUTER. You may assign a human-readable name and an optional set of scopes. The response includes the full key value exactly once. You must store it securely; it cannot be retrieved later.

Any authenticated caller may create keys, but the resulting key permissions are bounded by the caller's own scopes.

## Endpoint

```http theme={null}
POST /v1/router/keys
```

## Authentication

Authenticate with a session cookie or pass `Authorization: Bearer <api-key>`.

## Request Body

<ParamField body="name" type="string" required>
  Human-readable label for the new key.
</ParamField>

<ParamField body="scopes" type="array">
  List of permission scopes to grant. Omit to inherit defaults.
</ParamField>

## Response

<ResponseField name="id" type="string">
  Unique key identifier.
</ResponseField>

<ResponseField name="name" type="string">
  Name assigned to the key.
</ResponseField>

<ResponseField name="key" type="string">
  The full secret key. Shown exactly once.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://router.example.com/v1/router/keys" \
    -H "Authorization: Bearer <api-key>" \
    -H "Content-Type: application/json" \
    -d '{"name":"Production pipeline","scopes":["read","write"]}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "key_01hv8",
    "name": "Production pipeline",
    "key": "aria_9f3a4e...full-secret"
  }
  ```
</ResponseExample>


## Related topics

- [Create and List API Keys](/api-reference/agent/api-keys/create-list.md)
- [Create, rotate, and revoke your API keys](/guides/manage-api-keys.md)
- [POST /v1/apikeys — Create PIN API Key](/api-reference/pin/apikeys/create.md)
- [Revoke ROUTER API Key API](/api-reference/router/keys/revoke.md)
- [List ROUTER API Keys API](/api-reference/router/keys/list.md)