> For the complete documentation index, see [llms.txt](https://docs.delos.financial/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.delos.financial/operations/remove-document.md). # Remove Document Removes a previously attached document from a specific operation. This allows for document management and correction of document associations without affecting the operation itself. **Endpoint** `DELETE/v2/billing/operation/{id}/document/{documentId}` **Link** {% embed url="" %} ### **Request** #### **Path Parameters** | Parameter | Type | Description | Required | Example | | ---------------- | -------- | ----------------------------------------- | -------- | -------------- | | **`id`** | `string` | **Operation ID** to remove document from. | Yes | `"op_12345"` | | **`documentId`** | `string` | **Document ID** to remove from operation. | Yes | `"doc_abc123"` | #### **Headers** | Key | Value | Required | | --------------- | ------------------ | -------- | | `Authorization` | `Bearer ` | Yes | | `Accept` | `application/json` | Yes | *** ### **Response (200 OK)** Returns the updated operation object with the specified document removed from the documents array. #### **Response Fields** Returns the complete operation object (same structure as Get Operation), with the documents array updated to exclude the removed document. **Example Response (After Removing One Document):** ```json { "item": { "opid": "op_12345", "isVisible": true, "status": "PENDING", "type": "WITHDRAW", "paymentType": "SWIFT", "createdAt": "2024-05-20T10:30:00Z", "updatedAt": "2024-05-21T15:30:00Z", "source": { "account": { "id": "acc_12345", "name": "Business USD Account", "number": "ACC001", "customer": { "cuid": "cust_12345", "name": "Acme Inc." } } }, "destination": { "counterpartyAccount": { "id": "cpa_78901", "name": "Supplier Account", "number": "IBAN123456789", "counterparty": { "suid": "suid_abc123", "name": "Global Suppliers Ltd", "bankName": "International Bank" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "5000", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "EUR", "units": "4600", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "25", "nanos": 0 } }, "currentBalanceAmount": { "sum": { "currencyCode": "USD", "units": "45000", "nanos": 0 } }, "comment": "Q2 supplier payment", "isParent": true, "reference": "REF202405201234", "customer": { "cuid": "cust_12345", "name": "Acme Inc." }, "documents": [ { "guid": "doc_def456", "fileName": "contract_agreement.pdf", "size": 2048000, "mime": "application/pdf", "docType": "OPERATION_DOCUMENT", "info": "Service Contract", "isLock": false, "createAt": "2024-05-21T14:25:00Z" } ] } } ``` **Example Response (After Removing All Documents):** ```json { "item": { "opid": "op_12345", "isVisible": true, "status": "PENDING", "type": "WITHDRAW", "paymentType": "SWIFT", "createdAt": "2024-05-20T10:30:00Z", "updatedAt": "2024-05-21T15:30:00Z", "source": { "account": { "id": "acc_12345", "name": "Business USD Account", "number": "ACC001", "customer": { "cuid": "cust_12345", "name": "Acme Inc." } } }, "destination": { "counterpartyAccount": { "id": "cpa_78901", "name": "Supplier Account", "number": "IBAN123456789", "counterparty": { "suid": "suid_abc123", "name": "Global Suppliers Ltd", "bankName": "International Bank" } } }, "sourceAmount": { "sum": { "currencyCode": "USD", "units": "5000", "nanos": 0 } }, "destinationAmount": { "sum": { "currencyCode": "EUR", "units": "4600", "nanos": 0 } }, "commissionAmount": { "sum": { "currencyCode": "USD", "units": "25", "nanos": 0 } }, "currentBalanceAmount": { "sum": { "currencyCode": "USD", "units": "45000", "nanos": 0 } }, "comment": "Q2 supplier payment", "isParent": true, "reference": "REF202405201234", "customer": { "cuid": "cust_12345", "name": "Acme Inc." }, "documents": [] } } ``` *** ### **Examples** #### **Request** ```bash curl -X DELETE 'https://stagep.tst-apidmndelss.com/v2/billing/operation/op_12345/document/doc_abc123' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' ``` #### **Scenario: Removing Multiple Documents** *Remove documents one by one using separate requests* ```bash # Remove first document curl -X DELETE 'https://stagep.tst-apidmndelss.com/v2/billing/operation/op_12345/document/doc_abc123' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' # Remove second document curl -X DELETE 'https://stagep.tst-apidmndelss.com/v2/billing/operation/op_12345/document/doc_def456' \ -H 'Authorization: Bearer eyJhbGci...wNLGA' \ -H 'Accept: application/json' ``` *** ### **Error Responses** 1. **Operation Not Found**: ```json { "error": "Operation not found: op_99999" } ``` 2. **Document Not Found**: ```json { "error": "Document not found: doc_99999" } ``` 3. **Document Not Attached**: ```json { "error": "Document doc_abc123 is not attached to operation op_12345" } ``` 4. **Operation Not Editable**: ```json { "error": "Cannot modify documents for completed operations" } ``` 5. **Locked Document**: ```json { "error": "Document is locked and cannot be removed" } ``` *** ### **Notes** * **Document Preservation**: The document itself is not deleted from the system, only the association with the operation is removed * **Multiple Removal**: Can remove multiple documents by calling the endpoint multiple times * **Status Restrictions**: Typically cannot remove documents from completed/failed/canceled operations * **Audit Trail**: Document removal is logged for compliance purposes * **Locked Documents**: Some documents may be locked (e.g., by compliance team) and cannot be removed **Typical Use Cases**: * Correcting mistakenly attached documents * Replacing outdated documents with updated versions * Removing unnecessary supporting documents * Compliance cleanup and document management **Workflow for Document Replacement**: 1. Remove old document using this endpoint 2. Upload new document via document upload endpoint 3. Attach new document to operation using Add Document endpoint *** ### **Security Considerations** * Requires proper authorization to modify operation documents * Operations in certain statuses may be restricted from document modifications * Some documents may have additional protection/locking mechanisms --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.delos.financial/operations/remove-document.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.