Upload Founder Photo

PUT

api

companies

{companyId}

founder-photo

curl -X PUT "https://api.sequenzy.com/api/v1/companies/comp_123/founder-photo" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"imageBase64\": \"$(base64 < founder.jpg | tr -d '\n')\"}"

sequenzy companies update comp_123 --founder-photo-file ./founder.jpg

{
  "success": true,
  "company": {
    "id": "comp_123",
    "name": "Acme",
    "founderName": "Sarah",
    "founderPhotoUrl": "https://images.sequenzy.com/founder-photos/comp_123/3f1c2a9e-8b7d-4e6f-9a0b-1c2d3e4f5a6b.jpg"
  }
}

{
  "success": false,
  "error": "Upload a JPG, PNG, GIF or WebP photo at least 96px on each side."
}

Upload the founder photo that personal footers sign off with. Sequenzy crops it to a 192px square JPEG around its most interesting area (the face, on a portrait), hosts it, and saves it as the company’s founderPhotoUrl, replacing any photo already set. New personal footers copy it, and existing footers keep their own photo. Requires the company_profile:manage scope, the same scope as setting founderPhotoUrl with update company. To remove the photo, update the company with founderPhotoUrl: null.

Request

string

required

Company ID.

string

required

The photo as raw base64 bytes or a base64 data URL. PNG, JPEG, GIF or WebP, up to 10MB, at least 96px on each side. Any shape works: wide and tall photos are cropped to a square.

curl -X PUT "https://api.sequenzy.com/api/v1/companies/comp_123/founder-photo" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"imageBase64\": \"$(base64 < founder.jpg | tr -d '\n')\"}"

sequenzy companies update comp_123 --founder-photo-file ./founder.jpg

Response

Returns the updated company, in the same shape as get company. company.founderPhotoUrl is the hosted square photo.

{
  "success": true,
  "company": {
    "id": "comp_123",
    "name": "Acme",
    "founderName": "Sarah",
    "founderPhotoUrl": "https://images.sequenzy.com/founder-photos/comp_123/3f1c2a9e-8b7d-4e6f-9a0b-1c2d3e4f5a6b.jpg"
  }
}

{
  "success": false,
  "error": "Upload a JPG, PNG, GIF or WebP photo at least 96px on each side."
}

Errors

Status	When
`400`	`imageBase64` is missing or not valid base64, the file is over 10MB, or it is not a PNG, JPEG, GIF or WebP image at least 96px on each side. Nothing is saved.
`401`	The API key is missing or invalid.
`403`	The API key lacks `company_profile:manage`.
`404`	The company does not exist, or your workspace role cannot change its settings.
`503`	Image storage is temporarily unavailable. Nothing is saved; retry later.

curl -X PUT "https://api.sequenzy.com/api/v1/companies/comp_123/founder-photo" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"imageBase64\": \"$(base64 < founder.jpg | tr -d '\n')\"}"

sequenzy companies update comp_123 --founder-photo-file ./founder.jpg

{
  "success": true,
  "company": {
    "id": "comp_123",
    "name": "Acme",
    "founderName": "Sarah",
    "founderPhotoUrl": "https://images.sequenzy.com/founder-photos/comp_123/3f1c2a9e-8b7d-4e6f-9a0b-1c2d3e4f5a6b.jpg"
  }
}

{
  "success": false,
  "error": "Upload a JPG, PNG, GIF or WebP photo at least 96px on each side."
}