Confirm upload and create asset record
curl --request POST \
--url https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations"
payload = { "folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
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({folder_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'folder_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations"
payload := strings.NewReader("{\n \"folder_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"folder_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"folder_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"r2_key": "<string>",
"url": "<string>",
"thumbnail_url": "<string>",
"mime_type": "<string>",
"size_bytes": 123,
"asset_type": "<string>",
"source_type": "<string>",
"source_id": "<string>",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"deleted_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by_user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}Media
Confirm upload and create asset record
After the frontend uploads the file to storage, call this endpoint to verify the upload and create the asset record. The backend HEADs the storage object to read actual size and MIME type.
POST
/
v1
/
asset-uploads
/
{asset_upload_id}
/
confirmations
Confirm upload and create asset record
curl --request POST \
--url https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
'import requests
url = "https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations"
payload = { "folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" }
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({folder_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'})
};
fetch('https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'folder_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations"
payload := strings.NewReader("{\n \"folder_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\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.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"folder_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.runflow.io/v1/asset-uploads/{asset_upload_id}/confirmations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"folder_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n}"
response = http.request(request)
puts response.read_body{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"org_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"folder_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"r2_key": "<string>",
"url": "<string>",
"thumbnail_url": "<string>",
"mime_type": "<string>",
"size_bytes": 123,
"asset_type": "<string>",
"source_type": "<string>",
"source_id": "<string>",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"deleted_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_by_user": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"email": "<string>",
"first_name": "<string>",
"last_name": "<string>",
"avatar_url": "<string>"
}
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}{
"code": "<string>",
"message": "<string>",
"errors": [
{}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Path Parameters
Body
application/json
POST /v1/asset-uploads/{asset_upload_id}/confirmations body.
Response
Successful Response
Response shape.
Minimal user shape for embedded user fields.
Includes only display-relevant fields. Excludes sensitive/admin fields: email_verified_at, disabled_at, is_internal, locale_code, timezone.
Show child attributes
Show child attributes
⌘I