Modify an Image
put
/storage/v1/Images
Request
Supported Media Types
- multipart/form-data
Root Schema : schema
Type:
Show Source
object
-
deleteAfter(optional):
integer
Amount of seconds for the image to be deleted.
-
file:
string
Binary image content.
-
fileName:
string
Name of the image to update. May include path.Example:
images/image1.png
Response
Supported Media Types
- application/json
201 Response
Image update status details.
Root Schema : ImagesResponse
Type:
object
Result of the file upload
Show Source
-
fileName:
string
Name of the created file.
-
fileUrl(optional):
string
Link to access the public file.
-
isPublic(optional):
boolean
Indicates whether the file is public or private. Files uploaded using the Images endpoint are public.
Examples
The following example shows how to modify a public image by submitting a PUT request on the REST resource using cURL. For more information about cURL, see Use cURL.
cURL Command
Note:
The command in this example uses the URL structurehttps://tenant-base-url/resource-path,
where
tenant-base-url
represents the Identity Service URL, and the resource path represents the Identity Service API. See
Send Requests for the appropriate URL structure to use.
curl
-X PUT
-H "Content-Type:multipart/form-data"
-H "Authorization: Bearer <Access Token Value>"
https://tenant-base-url/storage/v1/Images
Example of Request Body
The following shows an example of the request body in JSON format:
[
"------WebKitFormBoundary3fkX18wB95KvCil5\n",
"Content-Disposition: form-data; name=\"fileName\"\n",
"\n",
"chess.jpg\n",
"------WebKitFormBoundary3fkX18wB95KvCil5\n",
"Content-Disposition: form-data; name=\"file\"; \n",
"Content-Type: image/png\n",
"\n",
"???PNG image binary data\n",
"\n",
"------WebKitFormBoundary3fkX18wB95KvCil5--"
]
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200 OK Content-length: 10420\n Content-Type: multipart/form-data; boundary=----WebKitFormBoundary3fkX18wB95KvCil5\n Date: Fri, 25 Mar 2016 17:57:14 GMT
Example of Response Body
The following example shows the contents of the response body in JSON format:
{
"fileName": "images/201512312459/chess.jpg",
"isPublic": true,
"fileUrl": "https://tenant-base-url/v1/Storage-test/B027/images/201512312459/chess.jpg"
}