Remove an organization logo

Request#

DELETE /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. See idempotency and retries.

organization must match your token's organization ID. No body or query parameters are accepted.

Query parameters#

This endpoint does not use query parameters.

Example#

curl --request DELETE "https://my.assetcenter.app/api/v1/organizations/42/image" \
  --header "Authorization: Bearer $ASSETCENTER_API_TOKEN" \
  --header "Accept: application/json" \
  --header "Idempotency-Key: 6dfe5079-7043-48cd-9d12-7e1e2bfc9693"

Response#

200 OK:

{
  "data": {
    "id": 42,
    "image_url": null,
    "has_photo": false
  }
}

Behavior and constraints#

The stored logo is removed. Removing an already absent logo also succeeds. Repeating the same successful request with its original key replays the response for 24 hours; use a new key when removing a newly uploaded logo.

Errors#

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