Skip to main content
PATCH
Update Team Profile Images

Update Team Profile Images

Uploads, replaces, or deletes team profile images, including the team logo and up to 3 additional images. Only team administrators can call this endpoint.

Authentication

Requires a valid customer bearer token. The customer must be a team administrator of the specified team.

Path Parameters

number
required
Numeric identifier of the team. Returned as Id in the Records array from GET /api/public/teams/my.

Request Body

The request body can include either Base64-encoded images to upload/replace or delete flags to remove existing images. You can combine both in a single request.

Upload or Replace Images

Provide the full Base64-encoded image data (including the data URI prefix, e.g. data:image/png;base64,...) for any image you want to upload or replace.
Full Base64-encoded string for the team logo, including the data URI prefix (e.g. data:image/png;base64,iVBORw0KGgo...). Omit or set to null to leave unchanged.
string
Full Base64-encoded string for the first team image. Omit or set to null to leave unchanged.
string
Full Base64-encoded string for the second team image. Omit or set to null to leave unchanged.
string
Full Base64-encoded string for the third team image. Omit or set to null to leave unchanged.

Delete Images

Set the corresponding delete flag to true to remove an existing image.
Set to true to delete the current team logo. Default is false.
boolean
Set to true to delete the current first team image. Default is false.
boolean
Set to true to delete the current second team image. Default is false.
boolean
Set to true to delete the current third team image. Default is false.

Response

Returns HTTP 200 OK with an empty body on success.

Examples

Delete an existing team image

Replace logo and delete an old image in one request

TypeScript Integration

Usage in Portal

Error Responses

error
The customer is not authenticated or the session has expired.
error
The customer is not an administrator of the specified team.
error
Invalid request data — for example, malformed Base64 encoding.
error
Team with the specified ID does not exist.