Test Gitea api with curl

[SimonLab]

For example to create a new repository in an organisation:

curl -X POST -H "Content-Type: application/json" \
    -H "Authorization: token <your-token>" \
    -d '{"name": "repo", "readme": "thereadme"}' \
    https://gitea-server.fly.dev/api/v1/orgs/your_org/repos

I'm testing this endpoint as I would like the repository to be created automatically with a Readme file included.
However I haven't managed to do this. There is "readme" key that can be passed in the post body (define in Gitea doc), however this doesn't seem to work.

[SimonLab]

Adding the "auto_init": true, in the body request will create a README.md file automatically. I thought adding the "readme": "filename" would create the filename instead of README.md but the request fails

curl -X POST -H "Content-Type: application/json" \
    -H "Authorization: token <your-token>" \
    -d '{"auto_init": true, "name": "repo"}' \
    https://gitea-server.fly.dev/api/v1/orgs/your_org/repos

[nelsonic]

@SimonLab do you want to add this to this README.md or to https://github.com/dwyl/gitea-server ❓ 💭

[SimonLab]

Good idea, I'll add it.
I noticed also the API documentation (see #5) contains example of the curl command when you try the endpoint: