SynqDocs
Account APIProfile

Start uploading a picture

Answers where to PUT the picture's bytes: a URL signed for 5 minutes, for exactly this type and length, straight to Synq's storage, which takes PUTs from Synq's own origins alone, so send them from your server. Then call `PUT /v1/profile/picture` with the `file_id`. PNG, JPEG, WebP or GIF, at most 5 MiB and 8192 × 8192; kept as a WebP square of at most 256 × 256. A person has at most 2 uploads waiting and 20 kept, and starts at most 10 an hour. Needs `me:write`.

POST/v1/profile/picture/uploads

Answers where to PUT the picture's bytes: a URL signed for 5 minutes, for exactly this type and length, straight to Synq's storage, which takes PUTs from Synq's own origins alone, so send them from your server. Then call PUT /v1/profile/picture with the file_id. PNG, JPEG, WebP or GIF, at most 5 MiB and 8192 × 8192; kept as a WebP square of at most 256 × 256. A person has at most 2 uploads waiting and 20 kept, and starts at most 10 an hour. Needs me:write.

Authorization

bearer
AuthorizationBearer <token>

An access token from this issuer for its account API (resource=<issuer>/me).

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.auth.synq.build/me/v1/profile/picture/uploads" \  -H "Authorization: Bearer $ACCESS_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "content_type": "image/jpeg",    "content_length": 482113  }'
{  "file_id": "fil_01h455vb4pex5vsknk084sn02q",  "url": "https://app.acme.example",  "headers": {    "content-type": "image/jpeg"  },  "expires_at": "2026-10-21T12:00:00.000Z"}