Skip to content
GitLab
Next
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • GitLab GitLab
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
    • Locked Files
  • Issues 44,761
    • Issues 44,761
    • List
    • Boards
    • Service Desk
    • Milestones
    • Iterations
    • Requirements
  • Merge requests 1,332
    • Merge requests 1,332
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
    • Test Cases
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Package Registry
    • Container Registry
    • Infrastructure Registry
  • Monitor
    • Monitor
    • Metrics
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Code review
    • Insights
    • Issue
    • Repository
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • GitLab.orgGitLab.org
  • GitLabGitLab
  • Issues
  • #348148
Closed
Open
Issue created Dec 10, 2021 by Jonas Wälter@wwwjonContributor

API: how to delete an avatar?

Projects, groups, users and topics have an avatar (image). Via API, a file can be uploaded as avatar:

To upload an avatar file from your file system, use the --form argument. This argument causes cURL to post data using the header Content-Type: multipart/form-data. The file= parameter must point to a file on your file system and be preceded by @.

curl --request PUT \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/topics/1" \
     --form "avatar=@/tmp/example.png"

ℹ Docs: Projects API, Groups API, Topics API

This works well so far. But what if you don't want the avatar anymore?

How can I delete the avatar of a project/group/user/topic via API?

Different attempts are failing:

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --form "avatar="
{"error":"avatar is invalid"}

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --form "avatar=nil"
{"error":"avatar is invalid"}

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --form "avatar=''"
{"error":"avatar is invalid"}

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --form "avatar=@"
{"id":9,"name":"topic1","description":"","total_projects_count":0,"avatar_url":"http://localhost:3000/uploads/-/system/projects/topic/avatar/9/avatar.jpg"}

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --form "avatar=@''"
curl: (26) could not open file "''"

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --data "avatar="
{"error":"avatar is invalid"}

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --data "avatar=nil"
{"error":"avatar is invalid"}

>curl --request PUT --header "PRIVATE-TOKEN: ..." http://localhost:3000/api/v4/topics/9 --data "avatar=''"
{"error":"avatar is invalid"}
Assignee
Assign to
Time tracking