Teams
Update Team Profile Images
Uploads, replaces, or deletes team profile images (logo and up to 3 additional images).
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
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.Full Base64-encoded string for the first team image. Omit or set to
null to leave unchanged.Full Base64-encoded string for the second team image. Omit or set to
null to leave unchanged.Full Base64-encoded string for the third team image. Omit or set to
null to leave unchanged.Delete Images
Set the corresponding delete flag totrue to remove an existing image.
Set to
true to delete the current team logo. Default is false.Set to
true to delete the current first team image. Default is false.Set to
true to delete the current second team image. Default is false.Set to
true to delete the current third team image. Default is false.Response
Returns HTTP200 OK with an empty body on success.
Examples
Upload a new team logo
Delete an existing team image
Replace logo and delete an old image in one request
TypeScript Integration
Usage in Portal
| Context | Source file |
|---|---|
Team Professional Profile Page (/team/profile/{teamId}) | src/views/user/team/profile/TeamProfessionalProfilePage.tsx |
| Team Professional Profile form component (image upload fields) | src/views/user/team/profile/components/TeamProfessionalProfile.tsx |
Error Responses
The customer is not authenticated or the session has expired.
The customer is not an administrator of the specified team.
Invalid request data — for example, malformed Base64 encoding.
Team with the specified ID does not exist.
Related Endpoints
| Method | Endpoint | Description |
|---|---|---|
PUT | /api/public/teams/{teamId}/profile | Update team profile fields |
GET | /api/public/teams/{teamId}/profile | Get current team profile |
GET | /api/public/teams/my | List the customer’s teams |
GET | /api/public/teams/{teamId}/kpi | Team KPI metrics |
Update Team Profile Images