curl --request PUT \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"uploadId": "<string>",
"variantId": "<string>"
}
'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar"
payload = {
"uploadId": "<string>",
"variantId": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({uploadId: '<string>', variantId: '<string>'})
};
fetch('https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar', 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://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'uploadId' => '<string>',
'variantId' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar"
payload := strings.NewReader("{\n \"uploadId\": \"<string>\",\n \"variantId\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-api-key", "<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.put("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"uploadId\": \"<string>\",\n \"variantId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"uploadId\": \"<string>\",\n \"variantId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"supplierId": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"active": true,
"updatedAt": "<string>",
"avatarUrl": "<string>",
"services": [
{
"serviceId": "<string>",
"name": {}
}
],
"skills": [
{
"skillId": "<string>",
"name": {}
}
],
"locations": [
{
"locationId": "<string>",
"locationType": "PHYSICAL",
"name": "<string>",
"country": "<string>",
"state": "<string>",
"city": "<string>",
"addressOneLine": "<string>",
"street": "<string>",
"latitude": 123,
"longitude": 123,
"travelZoneType": "CIRCULAR"
}
],
"servedRegions": [
"ca/",
"ca/on/",
"ca/on/scarborough/",
"ca/on/toronto/"
],
"languages": [
"<string>"
],
"locales": [
"<string>"
],
"phone": "<string>",
"addressoneline": "<string>",
"longitude": 123,
"latitude": 123,
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postalcode": "<string>",
"bio": "<string>",
"maxTravelTime": 123,
"externalId": "<string>",
"externalData": {},
"timezone": "America/Toronto",
"defaultLocale": "<string>"
}
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}Confirm an uploaded avatar and attach it to the supplier
Step 2 of 2: attaches the uploaded image to the supplier and returns the enriched supplier with its new avatar. Pass the variantId from the presign response, not the uploadId.
Resizing happens asynchronously after your upload lands, so calling this straight away often returns 400 “Avatar variant not ready yet”. That is a retry signal, not a failure — back off a second or two and call again; the upload is fine. Only a successful call here attaches anything, so an upload that is never confirmed leaves the supplier unchanged. Confirming a different variantId replaces the current avatar and deletes the old image variants, which cannot be undone; re-confirming the same one is harmless.
curl --request PUT \
--url https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"uploadId": "<string>",
"variantId": "<string>"
}
'import requests
url = "https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar"
payload = {
"uploadId": "<string>",
"variantId": "<string>"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({uploadId: '<string>', variantId: '<string>'})
};
fetch('https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar', 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://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
'uploadId' => '<string>',
'variantId' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar"
payload := strings.NewReader("{\n \"uploadId\": \"<string>\",\n \"variantId\": \"<string>\"\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("x-api-key", "<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.put("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"uploadId\": \"<string>\",\n \"variantId\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://apiv2.gomarketbox.com/v1/projects/{projectId}/suppliers/{supplierId}/avatar")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"uploadId\": \"<string>\",\n \"variantId\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"supplierId": "<string>",
"firstName": "<string>",
"lastName": "<string>",
"email": "<string>",
"active": true,
"updatedAt": "<string>",
"avatarUrl": "<string>",
"services": [
{
"serviceId": "<string>",
"name": {}
}
],
"skills": [
{
"skillId": "<string>",
"name": {}
}
],
"locations": [
{
"locationId": "<string>",
"locationType": "PHYSICAL",
"name": "<string>",
"country": "<string>",
"state": "<string>",
"city": "<string>",
"addressOneLine": "<string>",
"street": "<string>",
"latitude": 123,
"longitude": 123,
"travelZoneType": "CIRCULAR"
}
],
"servedRegions": [
"ca/",
"ca/on/",
"ca/on/scarborough/",
"ca/on/toronto/"
],
"languages": [
"<string>"
],
"locales": [
"<string>"
],
"phone": "<string>",
"addressoneline": "<string>",
"longitude": 123,
"latitude": 123,
"city": "<string>",
"state": "<string>",
"country": "<string>",
"postalcode": "<string>",
"bio": "<string>",
"maxTravelTime": 123,
"externalId": "<string>",
"externalData": {},
"timezone": "America/Toronto",
"defaultLocale": "<string>"
}
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}{
"code": "NOT_FOUND",
"message": "Booking not found",
"statusCode": 404,
"requestId": "a3f1c2de-9b64-4a2f-8f0e-5c9d1b7a2e10"
}Authorizations
API key minted in the MarketBox dashboard. Scope is restricted to the projects you select at creation time. Every route needs the key's standard API access (*) except POST /v1/projects/{projectId}/events, which needs events:write; a key without * is refused with 403 CAPABILITY_NOT_GRANTED.