> ## Documentation Index > Fetch the complete documentation index at: https://docs.stardex.com/llms.txt > Use this file to discover all available pages before exploring further. # Delete a retainer pack > Deletes the pack, its open retainers and its adjustments. A pack with claimed retainers cannot be deleted: the `409` response lists the claiming placements in `error.details.claimed_placements`; unlink them in the app first. **Access**: Session and OAuth callers must be organization admins (`org:admin`). API keys need the `fees:delete` scope. ## OpenAPI ````yaml /api-reference/openapi-v1.json delete /v1/retainer-packs/{id} openapi: 3.1.0 info: title: Stardex API (v1) version: 1.0.0 description: >- Stardex ATS API — manage candidates, jobs, companies, and recruiting workflows. servers: - url: https://api.stardex.ai description: Production API server security: - bearerAuth: [] tags: - name: Persons description: Manage person records — contacts, work history, and custom fields. - name: Jobs description: Manage job postings — pipeline stages, team members, and custom fields. - name: Candidates description: Manage candidate records and pipeline stage transitions. - name: Companies description: Browse and retrieve company records. - name: Lists description: Create, search, and retrieve saved person and company lists. - name: Person Activities description: Create and manage activity records (notes, emails, meetings) for persons. - name: Team Members description: List team members for use in search filters and assignments. - name: Custom Fields description: Retrieve custom field definitions and tag options for search filters. - name: Campaigns description: >- Create and edit email campaigns, enroll people through enrollment batches, and manage who is enrolled. paths: /v1/retainer-packs/{id}: delete: tags: - Retainer Packs summary: Delete a retainer pack description: >- Deletes the pack, its open retainers and its adjustments. A pack with claimed retainers cannot be deleted: the `409` response lists the claiming placements in `error.details.claimed_placements`; unlink them in the app first. **Access**: Session and OAuth callers must be organization admins (`org:admin`). API keys need the `fees:delete` scope. operationId: deleteRetainerPack parameters: - in: path name: id required: true schema: type: string format: uuid description: Retainer pack ID responses: '200': description: Retainer pack deleted content: application/json: schema: type: object properties: success: type: boolean enum: - true description: Always true on successful deletion. message: type: string description: Deletion confirmation message. required: - success - message example: success: true message: Retainer pack deleted '400': description: Validation error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. details: type: object additionalProperties: {} description: >- Extra facts about the error when they help you fix it, such as a limit and when it resets. required: - code - message required: - success - error '403': description: You do not have permission to make this change content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. details: type: object additionalProperties: {} description: >- Extra facts about the error when they help you fix it, such as a limit and when it resets. required: - code - message required: - success - error '404': description: Resource not found content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. details: type: object additionalProperties: {} description: >- Extra facts about the error when they help you fix it, such as a limit and when it resets. required: - code - message required: - success - error '409': description: Retainers in the pack are claimed by placements content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. details: type: object additionalProperties: {} description: >- Extra facts about the error when they help you fix it, such as a limit and when it resets. required: - code - message required: - success - error example: success: false error: code: RETAINER_PACK_HAS_CLAIMED_RETAINERS message: >- 2 retainers in this pack are claimed. Unlink these placements, then delete the pack. details: claimed_placements: - placement_fee_event_id: 9c0d1e2f-3a4b-4c5d-8e6f-7a8b9c0d1e2f retainer_id: 1b2c3d4e-5f6a-4b7c-9d8e-0f1a2b3c4d5e - placement_fee_event_id: 0d1e2f3a-4b5c-4d6e-9f7a-8b9c0d1e2f3a retainer_id: 2c3d4e5f-6a7b-4c8d-8e9f-1a2b3c4d5e6f '500': description: Internal server error content: application/json: schema: type: object properties: success: type: boolean enum: - false description: Always false for error responses. error: type: object properties: code: type: string description: >- Machine-readable error code (e.g. "VALIDATION_ERROR", "NOT_FOUND"). message: type: string description: Human-readable error description. details: type: object additionalProperties: {} description: >- Extra facts about the error when they help you fix it, such as a limit and when it resets. required: - code - message required: - success - error components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Authenticate with a Bearer token: API key, OAuth token, or session token. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.