# Change repository description from command line

**URL:** <https://forum.gitea.com/t/change-repository-description-from-command-line/10042>\
**Category:** Install/Maintain/Configure\
**Created:** [November 15, 2024, 9:44am UTC](https://forum.gitea.com/t/change-repository-description-from-command-line/10042 "2024-11-15T09:44:17Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![rob.nicholson](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/rob.nicholson/32/6339_2.png) [@rob.nicholson](https://forum.gitea.com/u/rob.nicholson)\
**Post date:** [November 15, 2024, 9:44am UTC](https://forum.gitea.com/t/change-repository-description-from-command-line/10042/1 "2024-11-15T09:44:17Z")

</div>

Is it possible to change the description of a Gitea repository from a command line? Either gitea.exe or git.exe would be fine. I’ve got to import a client’s standalone git library with ~100 repositories to create. I can create them fine using:

```auto
git remote add origin https://gitea.mydomain.co.uk:3000/organisation/so1234.git
git push -u origin main

```

But the description is blank and I’d like to add a more verbose description.

Later… If there is a solution, I assume it’s along these lines:

`curl -k -X POST "https://<gitea-url>/api/v1/org/<organization>/repos" -H "content-type: application/json" -H "Authorization: token 45647956a7434b47c04b47c69579fb0123456789" --data '{"name":"<repo-name>"}'`

---

<div class="post-metadata">

**Author:** ![rob.nicholson](https://sea2.discourse-cdn.com/flex020/user_avatar/forum.gitea.com/rob.nicholson/32/6339_2.png) [@rob.nicholson](https://forum.gitea.com/u/rob.nicholson)\
**Post date:** [November 17, 2024, 9:22pm UTC](https://forum.gitea.com/t/change-repository-description-from-command-line/10042/2 "2024-11-17T21:22:51Z")

</div>

Answering own question but yes, the Gitea API (an OpenAPI) is the way to go. You can get a list of all the API commands directly from your Gitea Uri:

[https://gitea.yourdomain.co.uk:3000/api/swagger](https://gitea.yourdomain.co.uk:3000/api/swagger)

The API is /repos/{owner}/{repo} passing JSON **{“description”:“new description”}** as the body of the post.