Copy an existing file

post/files/{fileId}/copy
Internal-Use Only

Copies the file if the user has Read access to the specified file.

Request Samples

1

Response Samples

1{
2 "creationTimeStamp": "2022-03-31T20:00:03.609Z",
3 "modifiedTimeStamp": "2022-03-31T20:00:03.826Z",
4 "createdBy": "sas.audit",
5 "modifiedBy": "sas.audit",
6 "id": "cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
7 "parentUri": "/jobExecution/jobs/b9fe292d-2a4e-434c-8154-5f490b4b9257",
8 "properties": {
9 "LastState": "running",
10 "JobRequest": "",
11 "Job": "b9fe292d-2a4e-434c-8154-5f490b4b9257",
12 "Provider": "casl"
13 },
14 "contentDisposition": "text/plain",
15 "contentType": "text/plain",
16 "description": "Log File for Job b9fe292d-2a4e-434c-8154-5f490b4b9257",
17 "documentType": "log",
18 "encoding": "UTF-8",
19 "links": [
20 {
21 "method": "GET",
22 "rel": "self",
23 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
24 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
25 "type": "application/vnd.sas.file"
26 },
27 {
28 "method": "GET",
29 "rel": "alternate",
30 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
31 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
32 "type": "application/vnd.sas.summary"
33 },
34 {
35 "method": "PATCH",
36 "rel": "patch",
37 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
38 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
39 "type": "application/vnd.sas.file",
40 "responseType": "application/vnd.sas.file"
41 },
42 {
43 "method": "PUT",
44 "rel": "update",
45 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
46 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
47 "type": "application/vnd.sas.file",
48 "responseType": "application/vnd.sas.file"
49 },
50 {
51 "method": "DELETE",
52 "rel": "delete",
53 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7",
54 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7"
55 },
56 {
57 "method": "GET",
58 "rel": "content",
59 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7/content",
60 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7/content",
61 "type": "text/plain"
62 },
63 {
64 "method": "PUT",
65 "rel": "updateContent",
66 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7/content",
67 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7/content",
68 "type": "*/*",
69 "responseType": "application/vnd.sas.file"
70 },
71 {
72 "method": "POST",
73 "rel": "copyFile",
74 "href": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7/copy",
75 "uri": "/files/files/cddc7f5d-9b30-4bf1-bb2f-6d5e40728cb7/copy",
76 "responseType": "application/vnd.sas.file"
77 },
78 {
79 "method": "POST",
80 "rel": "create",
81 "href": "/files/files",
82 "uri": "/files/files",
83 "type": "*/*",
84 "responseType": "application/vnd.sas.file"
85 }
86 ],
87 "name": "2022-03-31T20:00:03Z-results.log",
88 "size": 742,
89 "searchable": false,
90 "fileStatus": "unlocked",
91 "fileVersion": 0,
92 "expirationTimeStamp": "2022-04-07T20:00:03.651Z",
93 "virusDetected": false,
94 "urlDetected": false,
95 "quarantine": false,
96 "version": 4
97}

Path Parameters

NameTypeRequiredDescription
fileId
string
true

The identifier of the file resource for which to fetch content.

Query Parameters

NameTypeRequiredDescription
expirationTimeStamp
string
false

The date and time at which a file expires. If not specified, the file never expires.

parentFolderUri
string
false

The URI of the folder in which to add the file.

Header Parameters

NameTypeRequiredDescription
Content-Disposition
string
false

The content disposition. The previously assigned value can be changed. This indicates whether the content is expected to be displayed inline in a browser (as a web page or part of a web page) or as an attachment that is downloaded and saved locally. If a filename is specified in the header, it is used as the default name of the file.

Responses

StatusMeaningDescription
201CreatedThe file was created and returned in the response body.HeadersSchema
404Not FoundA file resource does not exist for the specified source file.Schema
409ConflictThe request could not be completed due to a conflict with the current state of the resource. A file with the specified name cannot be created in the folder because the file already exists in that folder.Schema