OAuth clients

Create a client-icon upload URL

Create a client-icon upload URL. Returns JSON unless otherwise noted.

Authentication

Authorizationbearer token

Requires oauth.clients.write — Create and update OAuth clients, secrets, and icons.

Path parameters

client_idstringrequired

The client identifier.

Responses

200Successful response

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/developer/clients/{client_id}/icon/presign', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
  },
});

const data = await response.json();

Response200

{
  "upload": {
    "method": "PUT",
    "url": "https://uploads.ufw.dev/avatars/acc_7Kd2Rm9QpX.png?X-Amz-Signature=...",
    "headers": {
      "Content-Type": "image/png"
    },
    "objectKey": "avatars/acc_7Kd2Rm9QpX.png",
    "uploadToken": "upl_2Nf8Xc4Vb1",
    "expiresAt": "2026-08-11T09:24:05Z"
  }
}