Create asset upload url - Dintero Documentation

aid_account_assets_post

curl --request POST \
  --url https://api.dintero.com/v1/accounts/{aid}/management/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "size_bytes": 1000000
}
'

import requests

url = "https://api.dintero.com/v1/accounts/{aid}/management/assets"

payload = { "size_bytes": 1000000 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({size_bytes: 1000000})
};

fetch('https://api.dintero.com/v1/accounts/{aid}/management/assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dintero.com/v1/accounts/{aid}/management/assets"

	payload := strings.NewReader("{\n  \"size_bytes\": 1000000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dintero.com/v1/accounts/{aid}/management/assets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"size_bytes\": 1000000\n}")
  .asString();

{
  "public_url": "<string>",
  "upload_url": "<string>",
  "upload_expires_in": 123
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

POST

https://api.dintero.com/v1

accounts

{aid}

management

assets

aid_account_assets_post

curl --request POST \
  --url https://api.dintero.com/v1/accounts/{aid}/management/assets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "size_bytes": 1000000
}
'

import requests

url = "https://api.dintero.com/v1/accounts/{aid}/management/assets"

payload = { "size_bytes": 1000000 }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({size_bytes: 1000000})
};

fetch('https://api.dintero.com/v1/accounts/{aid}/management/assets', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.dintero.com/v1/accounts/{aid}/management/assets"

	payload := strings.NewReader("{\n  \"size_bytes\": 1000000\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.dintero.com/v1/accounts/{aid}/management/assets")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"size_bytes\": 1000000\n}")
  .asString();

{
  "public_url": "<string>",
  "upload_url": "<string>",
  "upload_expires_in": 123
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

{
  "error": {
    "message": "<string>",
    "code": "<string>",
    "errors": [
      {}
    ]
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication (token authentication) should be used for accessing the API.

Use Get Token to get an access token for client credentials. Pass the token in the request header:

Authorization: Bearer {access_token}

where the access_token is JSON Web Tokens (JWT).

Path Parameters

aid

string<^[PT]{1}\d{8}$>

required

An id that uniquely identifies the account.

Required string length: 9

Body

application/json

size_bytes

integer

required

Size in bytes of the asset file to be uploaded.

Required range: 1 <= x <= 2000000

mime_type

enum<string>

required

MIME type of the asset to be uploaded

Available options:

image/png,

image/jpeg,

application/pdf,

application/vnd.ms-excel,

application/vnd.openxmlformats-officedocument.spreadsheetml.sheet,

text/csv

access

enum<string>

default:public

Who can access the file?

Available options:

private,

public

Response

Upload URL

public_url

string<string>

The public URL the asset will be made available from after the upload has completed.

upload_url

string<url>

An URL to upload the asset to.

The content type header value must be the same as the mime_type
The content length header value must be the same as the size of the file and the size_bytes.

Upload example

curl -X PUT
  -H 'Content-Type: {mime_type}' \
  -H 'Content-Length: {size_bytes}' \
  --upload-file <file> \
  {upload_url}

upload_expires_in

integer

The number of seconds until the upload url is no longer valid

Last modified on July 22, 2026

Change username

List stores

⌘I