Actualizar API Token

Entorno prueba

https://test.your-api-server.com

PUT

/api/auth/api-token/{id}

API Tokens

Última modificación:2026-03-30 00:53:56

Actualiza los campos permitidos de un API token existente.
Solo se modifican los campos enviados en el body.
No permite modificar la key, keyHash ni tokenHash.

Para revocar un token, enviar enabled: false.

Solicitud

Autorización

JWT Bearer

Agregar el parámetro

Authorization

a Encabezados

Ejemplo:

Authorization: ********************

Parámetros de ruta

Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200

application/json

Token actualizado

Body

🟠404

Ejemplo de Solicitud

Shell

JavaScript

Java

Swift

cURL

Actualizar nombre y descripcionRevocar token

curl --location --request PUT 'https://test.your-api-server.com/api/auth/api-token/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "Token ERP v2",
    "description": "Version actualizada del token"
}'

Ejemplo de Respuesta

{
    "msg": "API token actualizado",
    "data": {
        "_id": "665a1b2c3d4e5f6a7b8c9d0e",
        "name": "Integracion ERP SAP",
        "description": "Token para sincronizacion de materiales con SAP",
        "prefix": "miobox_ak_",
        "scopes": [
            "main.material",
            "main.recipe"
        ],
        "rateLimit": 100,
        "expiresAt": "2025-12-31T23:59:59.000Z",
        "enabled": true,
        "userId": {
            "_id": "string",
            "username": "string",
            "name": "string",
            "email": "string"
        },
        "lastUsedAt": "2019-08-24T14:15:22.123Z",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "updatedAt": "2019-08-24T14:15:22.123Z"
    }
}

Modificado en 2026-03-30 00:53:56

Obtener API Token por ID

Revocar API Token