Delete an attachment for an external transaction

delete

/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/{ExternalTransactionId}/child/attachments/{attachmentsUniqID}

Request

Path Parameters
  • The unique identifier of the external transaction.
  • This is the hash key of the attributes which make up the composite key for the Attachments resource and used to uniquely identify an instance of Attachments. The client should not generate the hash key value. Instead, the client should query on the Attachments collection resource in order to navigate to a specific instance of Attachments to get the hash key.
Header Parameters
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.

There's no request body for this operation.

Back to Top

Response

Default Response

No Content. This task does not return elements in the response body.
Back to Top

Examples

The following example shows how to retrieve and delete an attachment for an external transaction.

Get all the attachments of an external transaction and use the self URI of the specific attachment. Then, submit a DELETE request on the REST resource using cURL.

Here's the cURL command to retrieve all the attachments:

curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X GET https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/300100173517340/child/attachments

Example Response Body

The following example shows the contents of the response body in JSON format:

{
 "items" : [ 
 {
 "AttachedDocumentId" : 300100173394136,
 "LastUpdateDate" : "2019-02-06T21:32:19.318+00:00",
 "LastUpdatedBy" : "CASH_MANAGER",
 "DatatypeCode" : "FILE",
 ...
 "links" : [ 
 {
 "rel" : "self",
 "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/300100173517340/child/attachments/00020000000EACED00057708000110F0843B70D80000000EACED00057708000110F0843B70D7",
 "name" : "attachments",
 "kind" : "item"
 }, 
 {
 "rel" : "canonical",
 "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/300100173517340/child/attachments/00020000000EACED00057708000110F0843B70D80000000EACED00057708000110F0843B70D7",
 "name" : "attachments",
 "kind" : "item"
 },
 ...
 ]
 },
 ... 
 ],
 "count" : 200,
 "hasMore" : false,
 "limit" : 500,
 "offset" : 0,
 "links" : [ 
 {
 "rel" : "self",
 "href" : "https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/300100173517340/child/attachments",
 "name" : "attachments",
 "kind" : "collection"
 } 
 ]
}

A hash key of ExternalTransactionId and AttachedDocumentId identifies an attachment.

Here's the cURL command that uses the hash key in the self URI to retrieve the attachment:

curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X GET https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/300100173517340/child/attachments/00020000000EACED00057708000110F0843B70D80000000EACED00057708000110F0843B70D7

Here's the cURL command that uses the hash key in the self URI to delete the attachment:

curl -i -u "<username>:<password>" -H "Content-Type: application/json" -X DELETE https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/cashExternalTransactions/300100173517340/child/attachments/00020000000EACED00057708000110F0843B70D80000000EACED00057708000110F0843B70D7

Example Response Body

The following example shows the contents of the response body in JSON format:

204 Response
 
No content. The server successfully processed the request, but is not returning any content.
Back to Top