PUT/v2/projects/{projectId}/avatar

Upload a project avatar

Uploads an avatar for a project using multipart form data. Include the image in the avatar field and use projectId to identify the project whose avatar to update.

1 parameter · 1 body field
projectIdintegerrequired
The integer identifier of the project whose avatar to upload.

Multipart form data containing the project avatar.

avatarstringrequired
The image file to upload as the project avatar.

5 status codes
200Returns the updated project, including its project details and computed permissions.
avatarobjectoptional
baseLanguageobjectoptional
computedPermissionobjectrequired
defaultNamespaceobjectoptional
descriptionstringoptional
directPermissionobjectoptional
icuPlaceholdersbooleanrequired
Whether to disable ICU placeholder visualization in the editor and it's support.
idintegerrequired
namestringrequired
organizationOwnerobjectoptional
organizationRolestringoptional
Allowed:MEMBEROWNERMAINTAINER
publicbooleanrequired
Whether the project is public — discoverable and open to community suggestions
slugstringoptional
suggestionsModestringrequired
Suggestions for translations
Allowed:DISABLEDENABLED
translationProtectionstringrequired
Level of protection of translations
Allowed:NONEPROTECT_REVIEWED
useBranchingbooleanrequired
useNamespacesbooleanrequired
useQaChecksbooleanrequired
400Returned when the request body or a parameter value is invalid.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
401Returned when the request is unauthenticated.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
403Returned when you do not have permission to upload the project's avatar.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional
404Returned when the project is not found.
codestringrequired
Allowed:unauthenticatedapi_access_forbiddenapi_key_not_foundinvalid_api_keyinvalid_project_api_keyproject_api_key_expiredbad_credentialsmfa_enabledinvalid_otp_codemfa_not_enabledcan_not_revoke_own_permissionsdata_corrupted
paramsarray<object>optional

Error handling

A 400 is returned when the request body or a parameter value is invalid; a 401 when authentication is missing or invalid; a 403 when you lack access; and a 404 when the project is not found. When sending a body, include the avatar multipart field. The projectId path parameter must identify the project whose avatar you want to upload.