> ## Documentation Index
> Fetch the complete documentation index at: https://nova.dweet.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Get Deletion Request Status
> Poll an application or tenant deletion request
Polls an application or tenant deletion request.
This endpoint requires only a valid API key. `X-Tenant-Id` isn't required.
```bash cURL theme={null}
curl -X GET 'https://embed.nova.dweet.com/v1/deletion-requests/delreq_abc123' \
-H 'Authorization: Bearer sk_live_abc123...'
```
## Status values
| Status | Meaning |
| ------------ | ------------------------------ |
| `pending` | Nova accepted the request |
| `processing` | Background deletion is running |
| `completed` | Nova processed the request |
| `failed` | The request failed |
## Completed requests
Completed responses confirm that Nova processed the request for the authenticated partner, environment, and scope.
The response does not include internal cleanup counts, storage details, raw tenant IDs, job IDs, or application IDs. Keep the `deletionRequest.id` if you need to discuss a request with Nova support.
```json theme={null}
{
"deletionRequest": {
"id": "delreq_abc123",
"scope": "application",
"status": "completed",
"createdAt": "2026-05-10T10:00:00.000Z",
"updatedAt": "2026-05-10T10:01:00.000Z",
"completedAt": "2026-05-10T10:01:00.000Z",
"failedAt": null
}
}
```
## OpenAPI
````yaml GET /v1/deletion-requests/{deletionRequestId}
openapi: 3.1.0
info:
title: Nova Embed API
description: >-
The Nova Embed API enables ATS platforms to generate job-scoped screening
criteria and score applications asynchronously against those criteria.
version: 1.0.0
contact:
name: Nova Support
email: nova@dweet.com
servers:
- url: https://embed.nova.dweet.com
description: >-
Environment is determined by API key prefix: sk_test_* for sandbox,
sk_live_* for production.
security:
- bearerAuth: []
tags:
- name: Analytics
description: View scoring performance, webhook health, and error breakdowns.
- name: Criteria
description: Generate and manage job-scoped screening criteria.
- name: Scoring
description: Submit applications for scoring and fetch scoring job results.
- name: Deletion
description: Request application or tenant deletion and poll for completion.
- name: Criteria Library
description: Manage tenant-scoped reusable criteria templates.
- name: Rate Limits
description: Check your current rate limit status.
- name: Webhooks
description: >-
Events sent to your registered webhook endpoints. Verify signatures with
HMAC-SHA256 using your webhook secret.
paths:
/v1/deletion-requests/{deletionRequestId}:
get:
tags:
- Deletion
summary: Get deletion request status
description: >-
Poll the status of an application or tenant deletion request. Responses
include only the request ID, scope, status, and timestamps.
operationId: getDeletionRequest
parameters:
- $ref: '#/components/parameters/DeletionRequestId'
responses:
'200':
description: Deletion request status
headers:
X-RateLimit-Bucket:
$ref: '#/components/headers/X-RateLimit-Bucket'
X-RateLimit-Limit:
$ref: '#/components/headers/X-RateLimit-Limit'
X-RateLimit-Remaining:
$ref: '#/components/headers/X-RateLimit-Remaining'
X-RateLimit-Reset:
$ref: '#/components/headers/X-RateLimit-Reset'
content:
application/json:
schema:
$ref: '#/components/schemas/DeletionRequestResponse'
'401':
$ref: '#/components/responses/ErrorResponse'
'404':
$ref: '#/components/responses/ErrorResponse'
'429':
$ref: '#/components/responses/RateLimitedResponse'
'500':
$ref: '#/components/responses/ErrorResponse'
x-codeSamples:
- lang: typescript
label: '@nova-sdk/api'
source: |-
import { Nova } from "@nova-sdk/api";
const nova = new Nova({
apiKey: "sk_test_...",
tenantId: "acme-corp",
});
const result = await nova.deletion.getRequest("delreq_abc123");
- lang: bash
label: cURL
source: >-
curl -X GET
"https://embed.nova.dweet.com/v1/deletion-requests/delreq_abc123" \
-H "Authorization: Bearer sk_test_..."
components:
parameters:
DeletionRequestId:
name: deletionRequestId
in: path
required: true
description: Deletion request ID.
schema:
type: string
headers:
X-RateLimit-Bucket:
description: Which rate limit bucket the request was classified into
schema:
type: string
enum:
- criteria_ai
- criteria_current_reads
- scoring_intake_batch
- scoring_intake_single
- read_and_ops
- rate_limit_status
- analytics
X-RateLimit-Limit:
description: Maximum requests per second for this bucket
schema:
type: integer
X-RateLimit-Remaining:
description: Requests remaining in the current 1-second window
schema:
type: integer
X-RateLimit-Reset:
description: Unix timestamp when the current window resets
schema:
type: integer
Retry-After:
description: >-
Seconds to wait before retrying after a 429 response or retryable 503
response
schema:
type: integer
X-RateLimit-Degraded:
description: >-
Present and set to "true" when rate limiting is operating in degraded
mode (Redis unavailable). Values in other rate limit headers are
best-effort estimates.
schema:
type: string
enum:
- 'true'
schemas:
DeletionRequestResponse:
type: object
required:
- deletionRequest
properties:
deletionRequest:
$ref: '#/components/schemas/DeletionRequest'
DeletionRequest:
type: object
required:
- id
- scope
- status
- createdAt
- updatedAt
- completedAt
- failedAt
properties:
id:
type: string
scope:
$ref: '#/components/schemas/DeletionScope'
status:
$ref: '#/components/schemas/DeletionStatus'
createdAt:
type: string
format: date-time
updatedAt:
type: string
format: date-time
completedAt:
type:
- string
- 'null'
format: date-time
failedAt:
type:
- string
- 'null'
format: date-time
HttpError:
type: object
required:
- type
- code
- status
- message
- retryable
- traceId
properties:
type:
type: string
description: URI reference that identifies the error type
code:
$ref: '#/components/schemas/ErrorCode'
status:
type: integer
description: HTTP status code
message:
type: string
description: Error message
retryable:
type: boolean
description: When true, retrying the request may succeed
traceId:
type: string
description: Trace ID for debugging
details:
type:
- array
- 'null'
description: Field-level validation details
items:
type: object
required:
- field
- code
- message
properties:
field:
type: string
code:
type: string
message:
type: string
DeletionScope:
type: string
enum:
- application
- tenant
DeletionStatus:
type: string
enum:
- pending
- processing
- completed
- failed
ErrorCode:
type: string
description: >-
Machine-readable error code. Generated from the canonical error
registry.
enum:
- UNAUTHORIZED
- FORBIDDEN
- VALIDATION_ERROR
- ANSWER_MISMATCH
- CRITERIA_INVALID
- CRITERIA_REVISION_CONFLICT
- NOT_FOUND
- TENANT_NOT_FOUND
- JOB_NOT_FOUND
- APPLICATION_NOT_FOUND
- QUESTION_SET_NOT_FOUND
- CRITERIA_NOT_FOUND
- CRITERION_NOT_FOUND
- CRITERIA_VERSION_NOT_FOUND
- SCORING_JOB_NOT_FOUND
- BATCH_NOT_FOUND
- LIBRARY_CRITERION_NOT_FOUND
- RATE_LIMITED
- IDEMPOTENCY_KEY_ALREADY_USED
- IDEMPOTENCY_REQUEST_IN_PROGRESS
- RESUME_FETCH_FAILED
- RESUME_CONVERSION_FAILED
- RESUME_ENCRYPTED
- RESUME_CORRUPTED
- RESUME_PARSE_FAILED
- RESUME_TOO_LARGE
- RESUME_EMPTY
- RESUME_URL_BLOCKED
- AI_PROCESSING_FAILED
- AI_GENERATION_FAILED
- AI_SCORING_FAILED
- MISSING_JOB_DESCRIPTION
- TIMEOUT
- MAX_RETRIES_EXCEEDED
- TASK_STUCK
- DELETION_REQUEST_NOT_FOUND
- DELETION_REQUEST_FAILED
- INTERNAL_ERROR
- SERVICE_UNAVAILABLE
- UNKNOWN
responses:
ErrorResponse:
description: Error response
content:
application/json:
schema:
$ref: '#/components/schemas/HttpError'
RateLimitedResponse:
description: Rate limit exceeded
headers:
Retry-After:
$ref: '#/components/headers/Retry-After'
X-RateLimit-Bucket:
$ref: '#/components/headers/X-RateLimit-Bucket'
X-RateLimit-Limit:
$ref: '#/components/headers/X-RateLimit-Limit'
X-RateLimit-Remaining:
$ref: '#/components/headers/X-RateLimit-Remaining'
X-RateLimit-Reset:
$ref: '#/components/headers/X-RateLimit-Reset'
X-RateLimit-Degraded:
$ref: '#/components/headers/X-RateLimit-Degraded'
content:
application/json:
schema:
$ref: '#/components/schemas/HttpError'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API key
description: 'Use Authorization: Bearer sk_test_* or Authorization: Bearer sk_live_*.'
````