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

# Създаване на API ключ

> Генериране на нов API ключ за удостоверения потребител

Този endpoint генерира нов API ключ за удостоверения потребител. За разлика от login endpoint-а, който създава session token, този създава постоянен API ключ, който може да се използва за дългосрочен достъп до API.

<Note>
  Този endpoint изисква удостоверяване. Използвайте съществуващия си API ключ или session token, за да създадете допълнителни API ключове.
</Note>

### Тяло на заявката

<ParamField body="name" type="string" required>
  Име/етикет за API ключа (напр. "Production", "Development", "My App")
</ParamField>

### Отговор

<ResponseField name="message" type="string">
  Съобщение за успех
</ResponseField>

<ResponseField name="api_key" type="object">
  Подробности за създадения API ключ

  <Expandable title="api_key properties">
    <ResponseField name="name" type="string">
      Името/етикета на API ключа
    </ResponseField>

    <ResponseField name="token" type="string">
      Token-а на API ключа. **Съхранете го сигурно** - ще бъде показан само веднъж.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp на момента, в който е създаден API ключа
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "message": "API key created successfully.",
    "api_key": {
      "name": "Production API Key",
      "token": "1|abc123xyz789abcdef...",
      "created_at": "2025-01-08T10:30:00.000000Z"
    }
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The name field is required.",
    "errors": {
      "name": ["The name field is required."]
    }
  }
  ```
</ResponseExample>

### Примерна заявка

```bash theme={null}
curl -X POST https://call.aiployees.com/api/user/api-keys \
  -H "Authorization: Bearer YOUR_EXISTING_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Production API Key"
  }'
```

<Warning>
  Token-ът на API ключа се връща само веднъж. Уверете се, че го съхранявате сигурно. Ако го загубите, ще трябва да създадете нов.
</Warning>

### Управление на API ключове

* **GET /user/api-keys** - Показване на всички API ключове за удостоверения потребител
* **DELETE /user/api-keys/{id}** - Изтриване на конкретен API ключ

***