Bulk edit asset(s)
curl --request POST \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"assets": [
{
"asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"tags": [
"<string>"
]
}
]
}
'import requests
url = "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit"
payload = { "assets": [
{
"asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"tags": ["<string>"]
}
] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
assets: [
{
asset_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
tags: ['<string>']
}
]
})
};
fetch('https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit', 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.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit",
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([
'assets' => [
[
'asset_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'tags' => [
'<string>'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"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.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit"
payload := strings.NewReader("{\n \"assets\": [\n {\n \"asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
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.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"assets\": [\n {\n \"asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"assets\": [\n {\n \"asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"content_url": "<string>",
"content": "<string>",
"created_by_email": "<string>",
"thumbnail_url": "<string>",
"is_archived": true,
"is_deleted": true,
"tags": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]Assets
Bulk edit asset(s)
Rename and/or re-tag several assets in one request.
Each entry needs an asset_id plus at least one of name or tags; an entry with neither is a 400. Tags
replace the asset’s existing tags rather than merging with them, and are lowercased and trimmed. Assets outside
the workspace are ignored, and if nothing matched the response is 404.
Required permission: write:asset_evaluation.
POST
/
v1
/
organizations
/
{organization_id}
/
workspaces
/
{workspace_id}
/
assets
/
bulk_edit
Bulk edit asset(s)
curl --request POST \
--url https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit \
--header 'Authorization: <api-key>' \
--header 'Content-Type: application/json' \
--data '
{
"assets": [
{
"asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"tags": [
"<string>"
]
}
]
}
'import requests
url = "https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit"
payload = { "assets": [
{
"asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"tags": ["<string>"]
}
] }
headers = {
"Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
assets: [
{
asset_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
name: '<string>',
tags: ['<string>']
}
]
})
};
fetch('https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit', 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.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit",
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([
'assets' => [
[
'asset_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'name' => '<string>',
'tags' => [
'<string>'
]
]
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: <api-key>",
"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.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit"
payload := strings.NewReader("{\n \"assets\": [\n {\n \"asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ]\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "<api-key>")
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.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit")
.header("Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"assets\": [\n {\n \"asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ]\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.shareofmodel.ai/v1/organizations/{organization_id}/workspaces/{workspace_id}/assets/bulk_edit")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"assets\": [\n {\n \"asset_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"name\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ]\n }\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"content_url": "<string>",
"content": "<string>",
"created_by_email": "<string>",
"thumbnail_url": "<string>",
"is_archived": true,
"is_deleted": true,
"tags": [
"<string>"
],
"created_at": "2023-11-07T05:31:56Z",
"created_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
]Authorizations
Path Parameters
A UUID string identifying the organization.
A UUID string identifying the workspace.
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data*/*
Base for all the serializers in the assets app
List of assets to edit with their new names and/or tags
Minimum array length:
1Show child attributes
Show child attributes
Response
Maximum string length:
255Maximum string length:
255image- imagetext- textvideo- video
Available options:
image, text, video Maximum string length:
255Maximum string length:
255Was this page helpful?
⌘I