Show examples in:
Javascript HTTP
Endpoint info
Available examples

Content Management API > Upload permission

Request a new upload

Body parameters

type string Required

Must be exactly "upload_request".

attributes.filename string Optional

The original file name

Example: "image.png"

Returns

Returns a resource object of type upload_request.

Examples

1
POST https://site-api.datocms.com/upload-requests HTTP/1.1
2
Authorization: Bearer YOUR-API-TOKEN
3
Accept: application/json
4
X-Api-Version: 3
5
Content-Type: application/vnd.api+json
6
7
{
8
"data": {
9
"type": "upload_request",
10
"attributes": {}
11
}
12
}
Terminal window
1
curl -g 'https://site-api.datocms.com/upload-requests' \
2
-X POST \
3
-H "Authorization: Bearer YOUR-API-TOKEN" \
4
-H "Accept: application/json" \
5
-H "X-Api-Version: 3" \
6
-H "Content-Type: application/vnd.api+json" \
7
--data-binary '{"data":{"type":"upload_request","attributes":{}}}'
1
await fetch("https://site-api.datocms.com/upload-requests", {
2
method: "POST",
3
headers: {
4
Authorization: "Bearer YOUR-API-TOKEN",
5
Accept: "application/json",
6
"X-Api-Version": "3",
7
"Content-Type": "application/vnd.api+json",
8
},
9
body: JSON.stringify({ data: { type: "upload_request", attributes: {} } }),
10
});
1
HTTP/1.1 200 OK
2
Content-Type: application/json
3
Cache-Control: cache-control: max-age=0, private, must-revalidate
4
X-RateLimit-Limit: 30
5
X-RateLimit-Remaining: 28
6
7
{
8
"data": {
9
"type": "upload_request",
10
"id": "/7/1455102967-image.png",
11
"attributes": {
12
"url": "https://dato-images.s3-eu-west-1.amazonaws.com/7/1455102967-image.png?X-Amz-Credential=AKIAJDTXTZHHDUCKAUMA%2F20160210",
13
"request_headers": {}
14
}
15
}
16
}