---
updatedAt: 2025-11-05T21:23:19.000Z
agentTools:
  projectIndex: https://developer.sivo.com/llms.txt
---

# Revoke Refresh Token

Revoke a refresh token per https://docs.aws.amazon.com/cognito/latest/developerguide/revocation-endpoint.html

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "authentication-api",
    "version": "1.2"
  },
  "servers": [
    {
      "url": "https://auth.sivo.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/oauth2/revoke": {
      "post": {
        "summary": "Revoke Refresh Token",
        "description": "Revoke a refresh token per https://docs.aws.amazon.com/cognito/latest/developerguide/revocation-endpoint.html",
        "operationId": "revoke-a-refresh-token",
        "requestBody": {
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": [
                  "token",
                  "client_id"
                ],
                "properties": {
                  "token": {
                    "type": "string",
                    "description": "A valid refresh_token"
                  },
                  "client_id": {
                    "type": "string",
                    "description": "The application Client ID"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": [],
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl --location --request POST 'https://auth.sivo.com/oauth2/revoke' \\\n--header 'Content-Type: application/x-www-form-urlencoded' \\\n--data-urlencode 'client_id={client_id}' \\\n--data-urlencode 'token={refresh_token}'"
            },
            {
              "language": "node",
              "code": "var axios = require('axios');\nvar qs = require('qs');\nvar data = qs.stringify({\n  'client_id': '{client_id}',\n  'token': '{refresh_token}' \n});\nvar config = {\n  method: 'post',\n  url: 'https://staging-auth.sivo.com/oauth2/revoke',\n  headers: { \n    'Content-Type': 'application/x-www-form-urlencoded', \n  },\n  data : data\n};\n\naxios(config)\n.then(function (response) {\n  console.log(JSON.stringify(response.data));\n})\n.catch(function (error) {\n  console.log(error);\n});"
            },
            {
              "language": "javascript",
              "code": "var myHeaders = new Headers();\nmyHeaders.append(\"Content-Type\", \"application/x-www-form-urlencoded\");\n\nvar urlencoded = new URLSearchParams();\nurlencoded.append(\"client_id\", {client_id});\nurlencoded.append(\"token\", {refresh_token});\n\nvar requestOptions = {\n  method: 'POST',\n  headers: myHeaders,\n  body: urlencoded,\n  redirect: 'follow'\n};\n\nfetch(\"https://staging-auth.sivo.com/oauth2/revoke\", requestOptions)\n  .then(response => response.text())\n  .then(result => console.log(result))\n  .catch(error => console.log('error', error));"
            }
          ],
          "samples-languages": [
            "curl",
            "node",
            "javascript"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```