Images

Image-specific endpoints for a teardown your org owns. Images are not covered by the audience field they’re visible to anyone who can see the teardown.

Upload

POST /public/v1/teardown/images/{teardown_id}

Attach an image. URL is appended to the teardown’s images[] array.

Headers

string

required

Bearer tdao_live_…

string

required

string

required

multipart/form-data

Form fields

file

required

The image file.

The audience form field is not accepted on image endpoints audience controls document visibility, not images. Sending it is silently ignored.

File rules

Max size: 50 MB.
Allowed types: JPEG, PNG, WEBP, GIF.
One file per call.

Storage path

{SUPABASE_URL}/storage/v1/object/public/teardowns-media/teardowns/<teardown_id>/images/<8-hex>_<filename>

Response

200 OK:

{
  "url": "https://.../teardowns-media/teardowns/<id>/images/abcd1234_photo.jpg",
  "filename": "photo.jpg",
  "size": 234567,
  "content_type": "image/jpeg"
}

The URL is also appended to teardown.images[] automatically.

curl -X POST "$base_url/public/v1/teardown/images/$teardown_id" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id" \
  -F "file=@/absolute/path/to/photo.jpg"

import requests
with open("photo.jpg", "rb") as f:
    resp = requests.post(
        f"{base_url}/public/v1/teardown/images/{teardown_id}",
        headers={"Authorization": f"Bearer {api_key}", "X-Organization-Id": org_id},
        files={"file": f},
    )
resp.raise_for_status()

Delete by URL

DELETE /public/v1/teardown/images/{teardown_id}/by-url?url=<encoded-url>

Removes a single image URL from images[]. Best-effort deletes the underlying storage file.

Query parameters

string

required

The full image URL (URL-encoded).

Response

200 OK:

{ "status": "ok" }

Idempotent.

encoded_url=$(python3 -c "import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1]))" "$IMG_URL")

curl -X DELETE "$base_url/public/v1/teardown/images/$teardown_id/by-url?url=$encoded_url" \
  -H "Authorization: Bearer $api_key" \
  -H "X-Organization-Id: $org_id"

Common errors

Status	error_code	Why
400	(no code)	File empty, or content type isn’t an image
400	`file_too_large`	Over 50 MB
404	(no code)	Teardown isn’t yours or doesn’t exist
502	`storage_unavailable`	Supabase Storage upstream issue retry

Concepts

Teardowns

Sales / Lease / Exchange

Upload

Headers

Form fields

File rules

Storage path

Response

Delete by URL

Query parameters

Response

Common errors

See also

​Upload

​Headers

​Form fields

​File rules

​Storage path

​Response

​Delete by URL

​Query parameters

​Response

​Common errors

​See also

Upload

Headers

Form fields

File rules

Storage path

Response

Delete by URL

Query parameters

Response

Common errors

See also