Update file upload

Update the editable metadata for an existing upload.

Endpoints

PUT /api/v1/teams/{team_slug}/repos/{repo_slug}/uploads/{upload_uuid}
PUT /api/v1/users/{username}/repos/{repo_slug}/uploads/{upload_uuid}
Authenticated Repo scoped

Request

  • JSON body with `description`

Example

curl --request PUT \
  --header "Authorization: Bearer $GHIT_API_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"description":"updated desc"}' \
  "$GHIT_API_URL/v1/teams/platform/repos/website/uploads/a1b2c3d4-..."

Response

Returns the updated upload metadata as JSON.

Errors

  • 400 Bad Request for invalid JSON.
  • 403 Forbidden when the caller cannot edit the upload.
  • 404 Not Found when the repo or upload does not exist.