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

# Revogar token

> Revoga um `access_token` ou `refresh_token` de uma instalação. Após a revogação, o token deixa de funcionar na API aberta (chamadas retornam **HTTP 401**) e não pode ser renovado.

Chame este endpoint quando o cliente encerra o contrato no seu sistema ou quando precisa invalidar credenciais comprometidas. Exemplo de requisição em [Revogar token](/autenticacao/oauth#7-revogar-token).

A **desinstalação** do app pelo Proprietário no portal também revoga os tokens ativos daquela loja e interrompe webhooks da instalação. Detalhes em [Revogação e gestão pós-instalação](/cw-app-store/instalacao-e-autorizacao#revogacao-e-gestao-pos-instalacao).

Trate **HTTP 401** na API aberta como sinal de token expirado, revogado ou instalação inativa. Veja [Erros comuns](/autenticacao/oauth#erros-comuns).



## OpenAPI

````yaml /reference/api-autenticacao.json post /api/partner/oauth/revoke
openapi: 3.1.0
info:
  title: API Autenticação
  version: '1.0'
  description: >-
    Endpoint OAuth para apps da CW App Store.


    Integradoras obtêm tokens via `POST /api/partner/oauth/token` após o
    consentimento no portal CW. O `access_token` retornado deve ser enviado como
    `Authorization: Bearer` nos endpoints da API aberta.


    Guia completo: /autenticacao/oauth. Modelos de autenticação:
    /autenticacao/modelos-de-autenticacao.
  contact:
    email: integracao@cardapioweb.com
    url: https://cardapioweb.com
    name: Cardápio Web
servers:
  - url: https://integracao.sandbox.cardapioweb.com
    description: Sandbox
  - url: https://integracao.cardapioweb.com
    description: Produção
security: []
tags:
  - name: OAuth
    description: Autorização OAuth 2.0 com PKCE para apps da CW App Store.
paths:
  /api/partner/oauth/revoke:
    parameters: []
    post:
      tags:
        - OAuth
      summary: Revogar token
      description: >-
        Revoga um `access_token` ou `refresh_token` de uma instalação. Após a
        revogação, o token deixa de funcionar na API aberta (chamadas retornam
        **HTTP 401**) e não pode ser renovado.


        Chame este endpoint quando o cliente encerra o contrato no seu sistema
        ou quando precisa invalidar credenciais comprometidas. Exemplo de
        requisição em [Revogar token](/autenticacao/oauth#7-revogar-token).


        A **desinstalação** do app pelo Proprietário no portal também revoga os
        tokens ativos daquela loja e interrompe webhooks da instalação. Detalhes
        em [Revogação e gestão
        pós-instalação](/cw-app-store/instalacao-e-autorizacao#revogacao-e-gestao-pos-instalacao).


        Trate **HTTP 401** na API aberta como sinal de token expirado, revogado
        ou instalação inativa. Veja [Erros
        comuns](/autenticacao/oauth#erros-comuns).
      operationId: oauth-revoke
      requestBody:
        required: true
        content:
          application/x-www-form-urlencoded:
            schema:
              $ref: '#/components/schemas/RevokeRequest'
            examples:
              Revogar access token:
                value:
                  token: SEU_ACCESS_TOKEN
                  client_id: SEU_CLIENT_ID
      responses:
        '200':
          description: Token revogado com sucesso.
        '400':
          description: Requisição inválida.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthError'
        '401':
          description: '`client_id` inválido.'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OAuthError'
components:
  schemas:
    RevokeRequest:
      type: object
      required:
        - token
        - client_id
      properties:
        token:
          type: string
          description: '`access_token` ou `refresh_token` a revogar.'
        client_id:
          type: string
    OAuthError:
      type: object
      properties:
        error:
          type: string
          example: invalid_request
          description: >-
            Código do erro OAuth (ex.: `invalid_request`, `invalid_client`,
            `access_denied`).
        error_description:
          type: string
          description: Descrição legível do erro.

````