> ## Documentation Index > Fetch the complete documentation index at: https://docs.zerogen.com/llms.txt > Use this file to discover all available pages before exploring further. # Delete an attachment > Soft-delete an attachment while retaining all saved text and history. expectedVersion is the current version you read. An already deleted attachment returns unchanged when expectedVersion is at most the current version; a future version is refused. Restore reverses the deletion. Takes no body. Requires attachments enabled; test keys are refused. Needs the `library:organize` and `library:read` scopes. ## OpenAPI ````yaml /openapi.json delete /projects/{projectId}/attachments/{attachmentId} openapi: 3.1.0 info: title: ZeroGen API version: v1 description: >- Generate images and video with every model in ZeroGen from your own servers. Generated from the API's contracts by `npm run openapi` in apps/web; do not edit by hand. servers: - url: https://api.zerogen.com/v1 security: - bearerAuth: [] tags: - name: Account description: The calling key and the organization's balance. - name: Models description: The models an organization can run and their schemas. - name: Runs description: Quote, create, read, list and cancel runs. - name: Uploads description: Upload files into the Library to use as inputs. - name: Projects description: The organization's projects. - name: Assets description: >- Search and read Library assets, their lineage and their folders; download their files; rename and favorite them; make Derived copies. - name: LUTs description: The organization's LUTs, for a transform recipe. - name: Folders description: >- A project's folders: create, rename and move them, and add, move and remove their assets. - name: Labels description: 'Organization labels: manage them, and add them to assets or remove them.' - name: Naming presets description: A project's shared naming presets, for naming a run's outputs. - name: Skills description: The skills available to the key's owner. - name: Attachments description: >- Versioned text on projects, folders and Story clips, in organizations with attachments enabled. paths: /projects/{projectId}/attachments/{attachmentId}: delete: tags: - Attachments summary: Delete an attachment description: >- Soft-delete an attachment while retaining all saved text and history. expectedVersion is the current version you read. An already deleted attachment returns unchanged when expectedVersion is at most the current version; a future version is refused. Restore reverses the deletion. Takes no body. Requires attachments enabled; test keys are refused. Needs the `library:organize` and `library:read` scopes. operationId: deleteAttachment parameters: - name: projectId in: path required: true description: The project's ID schema: type: string - name: attachmentId in: path required: true description: The attachment's ID schema: type: string - name: expectedVersion in: query required: true schema: type: integer exclusiveMinimum: 0 maximum: 2147483647 - $ref: '#/components/parameters/IdempotencyKey' responses: '200': description: The deletion's version, or the unchanged current version. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Idempotent-Replayed: $ref: '#/components/headers/Idempotent-Replayed' content: application/json: schema: $ref: '#/components/schemas/AttachmentDelete' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '409': $ref: '#/components/responses/Conflict' '413': $ref: '#/components/responses/PayloadTooLarge' '415': $ref: '#/components/responses/UnsupportedMediaType' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalError' '503': $ref: '#/components/responses/ServiceUnavailable' components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- Makes retries safe: a retry with the same key and body returns the first response for 24 hours instead of repeating the work. Reusing a key with a different body returns 409. schema: type: string minLength: 1 maxLength: 255 pattern: ^[\x21-\x7e]+$ headers: Request-Id: description: Identifies the request; quote it when contacting support. schema: type: string RateLimit-Limit: description: Requests the key may make in the current window. schema: type: integer RateLimit-Remaining: description: Requests left in the current window. schema: type: integer RateLimit-Reset: description: Seconds until the current window resets. schema: type: integer Idempotent-Replayed: description: >- true when this response replays an earlier request with the same Idempotency-Key. schema: type: string enum: - 'true' WWW-Authenticate: description: Bearer realm="ZeroGen API". schema: type: string Retry-After: description: Seconds to wait before retrying. schema: type: integer schemas: AttachmentDelete: type: object properties: projectId: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ version: type: integer exclusiveMinimum: 0 maximum: 2147483647 outcome: anyOf: - type: string enum: - deleted - unchanged - type: string required: - projectId - version - outcome ErrorResponse: type: object properties: error: $ref: '#/components/schemas/Error' required: - error Error: type: object properties: code: type: string pattern: ^[a-z][a-z0-9_]{0,79}$ message: type: string param: type: string retryable: type: boolean details: type: object properties: reason: type: string description: >- The cause. Stable for rate_limited (request_limit, running_cap, platform_capacity, url_import_limit) and permission_denied (scope_required, role_required, not_creator, feature_not_enabled, early_access, test_key_sandbox, browser_request); for a run or output error, for diagnosis only additionalProperties: {} description: More facts about the error; each code says which it carries required: - code - message - retryable responses: BadRequest: description: >- The request is malformed or invalid: invalid_request, validation_failed, model_unavailable or input_import_failed. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Unauthorized: description: 'invalid_api_key: the key is missing, revoked or expired.' headers: Request-Id: $ref: '#/components/headers/Request-Id' WWW-Authenticate: $ref: '#/components/headers/WWW-Authenticate' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Forbidden: description: >- permission_denied: the key can't do this. details.reason says why: scope_required, role_required, not_creator, feature_not_enabled, early_access, test_key_sandbox, browser_request. For scope_required, details.scope names the scope. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: >- not_found: no such resource for this caller, including a projectId the caller can't use. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' Conflict: description: >- idempotency_conflict: the Idempotency-Key was used for a different request. idempotency_in_progress: the first request with this key hasn't finished. invalid_state: the request can't go ahead as things stand, such as a run that needs a person's approval in ZeroGen, an upload that can't take a declaration, or a naming preset that changed since it was read. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' PayloadTooLarge: description: >- The request body is larger than this endpoint's limit: 128 KiB by default, or 512 KiB for `POST /uploads` and `POST /assets/{assetId}/declaration`. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' UnsupportedMediaType: description: Send the body as application/json. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' TooManyRequests: description: >- rate_limited: details.reason says which limit: request_limit, running_cap, platform_capacity, url_import_limit. Retry after Retry-After seconds. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' InternalError: description: 'internal: something went wrong. Retry.' headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' ServiceUnavailable: description: >- unavailable or pricing_unavailable: API keys, billing or pricing can't be reached right now. retryable says whether a retry can help. headers: Request-Id: $ref: '#/components/headers/Request-Id' RateLimit-Limit: $ref: '#/components/headers/RateLimit-Limit' RateLimit-Remaining: $ref: '#/components/headers/RateLimit-Remaining' RateLimit-Reset: $ref: '#/components/headers/RateLimit-Reset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: 'A ZeroGen API key: zg_ for a live key, zg_test_ for a test key.' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.