---
updatedAt: 2026-04-22T09:48:12.000Z
agentTools:
  projectIndex: https://developers.modusign.co.kr/llms.txt
---

# 토큰 발급 취소

client_id와 client_secret으로 클라이언트를 인증한 뒤 발급 된 토큰을 취소 합니다. client_secret 없이 발급받은 앱은 client_secret을 생략합니다.

일치하는 토큰이 삭제되며, 삭제하려는 토큰이 refresh_token인 경우 access_token도 함께 삭제 됩니다.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "paths": {
    "/oauth/token/revoke": {
      "post": {
        "description": "client_id와 client_secret으로 클라이언트를 인증한 뒤 발급 된 토큰을 취소 합니다. client_secret 없이 발급받은 앱은 client_secret을 생략합니다.\n\n일치하는 토큰이 삭제되며, 삭제하려는 토큰이 refresh_token인 경우 access_token도 함께 삭제 됩니다.",
        "operationId": "OAuthController_revokeOAuthToken",
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/RevokeOAuthTokenRequestDto"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "취소 완료. 응답 본문이 없습니다."
          },
          "400": {
            "description": "요청 형식 오류 또는 유효하지 않은 토큰",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthErrorResponseDto"
                }
              }
            }
          },
          "401": {
            "description": "클라이언트 인증 실패",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthErrorResponseDto"
                }
              }
            }
          },
          "500": {
            "description": "취소를 처리하지 못함",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthErrorResponseDto"
                }
              }
            }
          },
          "503": {
            "description": "취소를 일시적으로 처리하지 못함",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/OAuthErrorResponseDto"
                }
              }
            }
          }
        },
        "summary": "토큰 발급 취소",
        "tags": [
          "OAUTH APPLICATION API"
        ]
      }
    }
  },
  "info": {
    "title": "MODUSIGN API",
    "description": "",
    "version": "1.0.0",
    "contact": {}
  },
  "servers": [
    {
      "url": "https://api.modusign.co.kr",
      "description": "production"
    }
  ],
  "components": {
    "schemas": {
      "OAuthErrorResponseDto": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "오류를 낸 예외의 이름"
          },
          "title": {
            "type": "string",
            "description": "오류를 요약한 문구"
          },
          "instance": {
            "type": "string",
            "description": "오류가 발생한 요청 경로"
          },
          "error": {
            "type": "string",
            "description": "규격이 정한 오류 코드. 클라이언트는 이 값으로 실패 사유를 구분합니다."
          },
          "error_description": {
            "type": "string",
            "description": "개발자가 읽을 수 있는 실패 사유"
          },
          "detail": {
            "type": "string",
            "description": "실패에 대한 부가 설명"
          },
          "data": {
            "type": "object",
            "description": "규격 필드로 옮기지 못한 판정 근거. 요청 검증에 실패한 400 에만 담깁니다."
          }
        },
        "required": [
          "type",
          "title",
          "instance",
          "error",
          "error_description"
        ]
      },
      "RevokeOAuthTokenRequestDto": {
        "type": "object",
        "properties": {
          "client_id": {
            "type": "string",
            "description": "등록 된 앱의 client_id"
          },
          "client_secret": {
            "type": "string",
            "description": "앱 등록 시 발급받은 client_secret. client_secret을 발급받은 앱은 반드시 전달하고, client_secret 없이 발급받은 앱은 생략합니다."
          },
          "token": {
            "type": "string",
            "description": "삭제하려고 하는 토큰 정보"
          }
        },
        "required": [
          "client_id",
          "token"
        ]
      }
    }
  }
}
```