> ## Documentation Index > Fetch the complete documentation index at: https://docs.basaltic.sh/llms.txt > Use this file to discover all available pages before exploring further. # Revocar un token al portador > Revocar un token de acceso, finalizando la sesión detrás de él. Cada credencial emitida por esa sesión deja de funcionar en la siguiente solicitud, en lugar de en el vencimiento del token. Respuestas `200` si algo fue revocado o no — un token desconocido, expirado o ya revocado no se distingue de uno vivo. Eso es requerido por RFC 7009 y es el punto: un punto final que reportara la diferencia le diría a cualquiera que tenga un token si todavía es bueno. Un token que pertenece a otra organización se ignora silenciosamente por la misma razón. Requiere **sin acción de IAM**. El acceso se decide por las propias reglas del punto final en lugar de por una política. Consulte la descripción anterior. ## OpenAPI ````yaml /es/api-reference/specs/iam.yaml post /v1/oauth/revoke openapi: 3.0.3 info: title: API de Basaltic IAM version: 1.0.0 description: > Administración de identidad y acceso de cuentas: cuentas de servicio, roles, directivas de cuenta y sesiones temporales con ámbito de cuenta. La autenticación y el inicio de sesión personal permanecen en IAM. Las organizaciones, cuentas, usuarios, grupos y directivas de organización se administran mediante la API de Workspace. Las funciones y las políticas personalizadas pertenecen a la cuenta seleccionada. Sus CRN globales usan una región vacía y el identificador de la cuenta propietaria.Las entradas de relación se clasifican una vez como CRN, UUID o nombre, sin fallback de sintaxis. AssumeRole resuelve la cuenta propietaria del rol de destino. El llamador necesita permiso de origen y el rol de destino debe confiar en el llamador; la sesión resultante usa solo los permisos del rol de destino, sujeto a límites y restricciones de sesión. contact: name: Basaltic Support email: ping@basaltic.sh license: name: Proprietary url: https://basaltic.sh/terms servers: - url: https://iam.basaltic.sh description: Endpoint de API global security: - BearerAuth: [] paths: /v1/oauth/revoke: post: tags: - IAM summary: Revocar un token al portador description: > Revocar un token de acceso, finalizando la sesión detrás de él. Cada credencial emitida por esa sesión deja de funcionar en la siguiente solicitud, en lugar de en el vencimiento del token. Respuestas `200` si algo fue revocado o no — un token desconocido, expirado o ya revocado no se distingue de uno vivo. Eso es requerido por RFC 7009 y es el punto: un punto final que reportara la diferencia le diría a cualquiera que tenga un token si todavía es bueno. Un token que pertenece a otra organización se ignora silenciosamente por la misma razón. operationId: revokeOAuthToken requestBody: required: true content: application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/OAuthRevokeRequest' application/json: schema: $ref: '#/components/schemas/OAuthRevokeRequest' responses: '200': description: | Procesado. No lleva cuerpo y no dice nada sobre si el token existía. '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '500': $ref: '#/components/responses/InternalServerError' components: schemas: OAuthRevokeRequest: type: object required: - token properties: token: type: string description: El token de acceso a revocar. token_type_hint: type: string description: > Aceptado e ignorado: el token se identifica a sí mismo. Presente porque los clientes RFC 7009 lo envían. example: access_token Error: type: object required: - error properties: error: type: object required: - code - message - request_id properties: code: type: string description: Código de error que identifica el tipo de error example: INVALID_INPUT message: type: string description: Mensaje de error legible por el ser humano example: Invalid request parameters params: type: object additionalProperties: true description: >- Valores no sensibles opcionales para la interpolación de errores localizados, codificados por código de error. Nunca presente por errores del servidor. example: instances: 2 pools: 0 request_id: type: string format: uuid description: Solicitar ID para depuración example: 550e8400-e29b-41d4-a716-446655440000 responses: BadRequest: description: Parámetros de solicitud no válidos content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INVALID_INPUT message: Invalid request parameters request_id: 550e8400-e29b-41d4-a716-446655440000 Unauthorized: description: Se requiere autenticación o el token no es válido content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: UNAUTHORIZED message: Authentication required request_id: 550e8400-e29b-41d4-a716-446655440000 InternalServerError: description: Error interno del servidor content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: INTERNAL_ERROR message: An internal error occurred request_id: 550e8400-e29b-41d4-a716-446655440000 securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >+ Un token bearer de OAuth 2.0, enviado como `Authorization: Bearer `. Esta es la forma recomendada de autenticación. Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en `POST /v1/oauth/token` con `grant_type=client_credentials`. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti. ``` curl -s -u "$KEY_ID:$SECRET" -d grant_type=client_credentials \ https://iam.basaltic.sh/v1/oauth/token ``` Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.