# Delete Notarization Request Use this method to delete a notarization request. Once notarization request is deleted it cannot be restored. > 🚧 Notarization Request status > > You can only delete a notarization request in status 'SENT', 'WAITING_FOR_NOTARY' or 'INCOMPLETE'. > If the notarization request is in any other status, the request will return a 400 Bad Request error. By default all invitees will receive email notification about deletion of the notarization request. If you want to disable this notification, you can use the `disable_invitees_notifications` parameter when creating request (see [Create Notarization Request](https://developers.pandadoc.com/reference/create-notarization-request)). # OpenAPI definition ```json { "openapi": "3.0.3", "info": { "title": "PandaDoc Public API", "description": "PandaDoc API spans a broad range of functionality to help you build incredible documents automation experiences inside your product.\n\nPandaDoc API is organized around REST. Our API has predictable resource-oriented URLs and uses standard HTTP response codes, authentication, and verbs.\n\n## Getting started\n\nYou can start testing PandaDoc API with a sandbox key on our [Enterprise](https://www.pandadoc.com/pricing/) plan, either active or in trial.\n\nGenerate your [sandbox key](https://developers.pandadoc.com/reference/sandbox-key) on the Developer Dashboard with predefined [rate limits](https://developers.pandadoc.com/reference/limits). Or contact our solutions expert if you work with high-transaction volumes.\n\n## Guides\n\nIf you’re just getting started with PandaDoc, you may want to jump straight into one of our [getting started guides](https://developers.pandadoc.com/docs/getting-started) for the feature you’re most interested in, whether that’s:\n\n- [Create from template](https://developers.pandadoc.com/docs/create-send-document),\n- [Upload and send a local PDF](https://developers.pandadoc.com/docs/upload-and-send-a-local-pdf),\n- or [Listening for changes in document status](https://developers.pandadoc.com/docs/listen-document-status-changes).\n\nWe also recommend you to discover our dynamic content generation on a fly: [Create from a template with content placeholder](https://developers.pandadoc.com/docs/create-with-content-placeholders-from-template).\n", "termsOfService": "https://www.pandadoc.com/master-services-agreement/", "contact": { "name": "PandaDoc API Support", "url": "https://developers.pandadoc.com/", "email": "api-track@pandadoc.com" }, "license": { "name": "MIT", "url": "https://github.com/PandaDoc/pandadoc-openapi-specification/blob/main/LICENSE" }, "version": "7.18.2" }, "servers": [ { "url": "https://api.pandadoc.com", "description": "Public API" } ], "security": [ { "apiKey": [] }, { "oauth2": [] } ], "tags": [ { "name": "Notary", "description": "Operations for creating and managing notarization requests." } ], "paths": { "/public/v2/notary/notarization-requests/{session_request_id}": { "delete": { "tags": [ "Notary" ], "summary": "Delete Notarization Request", "operationId": "deleteNotarizationRequest", "description": "Use this method to delete a notarization request.\nOnce notarization request is deleted it cannot be restored.\n\n> 🚧 Notarization Request status\n> \n> You can only delete a notarization request in status 'SENT', 'WAITING_FOR_NOTARY' or 'INCOMPLETE'. \n> If the notarization request is in any other status, the request will return a 400 Bad Request error.\n\nBy default all invitees will receive email notification about deletion of the notarization request. \nIf you want to disable this notification, you can use the `disable_invitees_notifications` parameter when creating request (see [Create Notarization Request](https://developers.pandadoc.com/reference/create-notarization-request)).\n", "parameters": [ { "name": "session_request_id", "in": "path", "required": true, "schema": { "type": "string", "format": "uuid" }, "description": "Notarization Request ID.", "example": "0b2256a2-5803-4ae9-b1b8-595f48e37173" } ], "responses": { "204": { "description": "No content" }, "400": { "$ref": "#/components/responses/400BadRequestV2" }, "403": { "$ref": "#/components/responses/403PermissionDeniedV2" }, "404": { "$ref": "#/components/responses/404NotFoundV2" }, "429": { "$ref": "#/components/responses/429TooManyRequestsV2" } } } } }, "components": { "securitySchemes": { "apiKey": { "type": "apiKey", "name": "Authorization", "in": "header", "description": "The `Authorization` header must contain the API key. The value should be prefixed with `API-Key` followed by a space and the actual API key.\n", "x-default": "API-Key 3039ba033eb1410caa0a2227158d63c9d6502cd8" }, "oauth2": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "https://app.pandadoc.com/oauth2/authorize", "tokenUrl": "https://api.pandadoc.com/oauth2/access_token", "refreshUrl": "https://api.pandadoc.com/oauth2/access_token", "scopes": { "read+write": "Use `read+write` to create, send, delete, and download documents, and `read` to view templates and document details." } } }, "description": "Send the authenticating user to the PandaDoc OAuth2 request URL. We recommend a button or a link titled\n\"Connect to PandaDoc\" if you are connecting users from a custom application. Users will see the \"Authorize Application\" screen.\nWhen the user clicks \"Authorize\", PandaDoc redirects the user back to your site with an authorization code inside the URL.\n\nhttps://app.pandadoc.com/oauth2/authorize?client_id={client_id}&redirect_uri={redirect_uri}&scope=read+write&response_type=code\n\n`client_id` and `redirect_uri` values should match your application settings.\n" } }, "responses": { "400BadRequestV2": { "description": "Bad Request error", "content": { "application/json": { "schema": { "properties": { "code": { "type": "string", "example": "bad_request" }, "details": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "pointer": { "type": "string", "description": "JSON Pointer.", "nullable": true }, "data": { "description": "Details data.", "type": "object", "nullable": true, "minProperties": 0, "additionalProperties": true } }, "required": [ "code" ] }, "example": [] } } } } } }, "429TooManyRequestsV2": { "description": "Too many requests error", "content": { "application/json": { "schema": { "properties": { "code": { "type": "string", "example": "too_many_requests" }, "details": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "pointer": { "type": "string", "description": "JSON Pointer.", "nullable": true }, "data": { "description": "Details data.", "type": "object", "nullable": true, "minProperties": 0, "additionalProperties": true } }, "required": [ "code" ] }, "example": [] } } } } } }, "404NotFoundV2": { "description": "Not found error", "content": { "application/json": { "schema": { "properties": { "code": { "type": "string", "example": "not_found" }, "details": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "pointer": { "type": "string", "description": "JSON Pointer.", "nullable": true }, "data": { "description": "Details data.", "type": "object", "nullable": true, "minProperties": 0, "additionalProperties": true } }, "required": [ "code" ] }, "example": [] } } } } } }, "403PermissionDeniedV2": { "description": "Permission error", "content": { "application/json": { "schema": { "properties": { "code": { "type": "string", "example": "forbidden" }, "details": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "pointer": { "type": "string", "description": "JSON Pointer.", "nullable": true }, "data": { "description": "Details data.", "type": "object", "nullable": true, "minProperties": 0, "additionalProperties": true } }, "required": [ "code" ] }, "example": [] } } } } } } } } } ```