AssetCenter
Sign in Get started - it's free!

↑ ↓ to navigate · ↵ to open See all results
POST /api/v1/organizations/{organization}/image

Upload an organization logo

Upload or replace the logo for the organization bound to your API token.

Last updated

Request

POST /api/v1/organizations/{organization}/image

Requires organizations:update. See token permissions.

Send Authorization: Bearer YOUR_API_TOKEN, Accept: application/json, and a required Idempotency-Key. Send the file as multipart form data. See idempotency and retries.

organization must match your token's organization ID.

Query parameters

This endpoint does not use query parameters.

Request body

Field Type Usage
image file Required. JPG/JPEG, PNG, BMP, GIF, WebP, AVIF, HEIC, or HEIF; maximum 20,480 KB (20 MiB).

No other fields are accepted. HEIC and HEIF uploads are converted to JPEG. An unreadable or unconvertible file returns 422 on image.

Example

cURL / Bash 
curl --request POST "https://my.assetcenter.app/api/v1/organizations/42/image" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: f09c4b51-5e21-4dc8-a463-0d73e0d4ec9f" \
  --form "image=@/path/to/logo.png"

Let cURL set the multipart Content-Type and boundary.

Response

200 OK, with a data object containing id, image_url, and has_photo. The uploaded logo replaces the previous file, has_photo is true, and image_url contains a temporary image URL valid for 24 hours.

Behavior and constraints

Retry with the same token, key, file contents, original filename, and MIME type. The idempotency fingerprint includes those file details. Changing the file or its metadata while reusing the key returns 409. A successful replay returns the original response, including its original image URL; read organization settings for a fresh URL when needed.

Errors

401 means invalid authentication; 403 means missing permission or administrator access. Another organization's ID returns 404. Invalid files, unsupported input, and missing keys return 422; conflicting key reuse returns 409; throttling returns 429. See error handling and rate limits.