> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sequenzy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Upload Founder Photo

> Upload the founder photo personal footers sign off with

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](https://docs.sequenzy.com/api-reference/companies/update.md). To remove the photo, update the company with `founderPhotoUrl: null`.

## Request

**companyId** `string` *required*

Company ID.

**imageBase64** `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.

```bash cURL theme={null}
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')\"}"
```

```bash CLI theme={null}
sequenzy companies update comp_123 --founder-photo-file ./founder.jpg
```

## Response

Returns the updated company, in the same shape as [get company](https://docs.sequenzy.com/api-reference/companies/get.md). `company.founderPhotoUrl` is the hosted square photo.

```json 200 theme={null}
{
  "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"
  }
}
```

```json 400 theme={null}
{
  "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.