> ## Documentation Index
> Fetch the complete documentation index at: https://help.impactu.colav.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Generar API Key

> Genera o regenera el API Key del usuario autenticado. Si ya existía uno, se reemplaza.

> [!NOTE]
>
> El usuario autenticado solo puede gestionar su propio API Key. El `{email}`
> en la ruta debe coincidir con la identidad del JWT en la cookie
> `access_token_cookie`.

## Parámetros de ruta

**email** `string` *required*

Correo electrónico del usuario. Debe coincidir con el usuario autenticado.

## Cuerpo de la solicitud

**expires** `integer`

Fecha de expiración en segundos Unix. Opcional. Si se proporciona, debe ser
una fecha futura con al menos 1 día de margen.

## Respuesta

**success** `boolean`

`true` si el API Key fue generado correctamente.

**apikey** `object`

Datos del API Key generado.

**propiedades**

**id** `string`

El API Key: 10 letras y dígitos. Guárdalo en un lugar seguro; no se
muestra de nuevo.

**expires** `integer`

Fecha de expiración en segundos Unix. `null` si no se configuró
expiración.

```json 200 theme={null}
{
  "success": true,
  "apikey": {
    "id": "aB3dE5fG7h",
    "expires": 1830000000
  }
}
```

```json 400 theme={null}
{ "success": false, "msg": "La expiración mínima del API key es de 1 día" }
```

```json 401 theme={null}
{"msg": "Token no proporcionado o inválido. Por favor, inicia sesión nuevamente.", "success": false}
```

```json 403 theme={null}
{ "success": false, "msg": "No tienes permiso para gestionar el API Key de otro usuario." }
```


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