Gitea API

REST discovered

Details

URL: /api/v1
Docs: https://docs.gitea.com/api/1.20/

Authentication

Gitea username and password basic discovered Get credentials ↗

Use your existing Gitea account credentials on your own Gitea instance. The API Usage docs state that HTTP Basic authentication is supported for the API, and that POST /users/{name}/tokens specifically requires BasicAuth with a password.

Gitea personal access token api_key discovered Get key ↗

?token=<credential> /?access_token=<credential> /Authorization: token <credential>

In Gitea, open API Usage and create a token from User Settings → Applications → Manage Access Tokens (or directly at https://<your-gitea-host>/user/settings/applications). Choose the needed permission scopes, then copy the token when it is shown; Gitea only displays it once.

Registered Gitea SSH key for HTTP signatures signature discovered Get key ↗

Signature: <credential>

Add an SSH public key or SSH certificate to your Gitea user account, then sign API requests with the corresponding private key using the draft-cavage HTTP Signatures format. The API Usage page says the signature is sent in the Signature header, and SSH certificates also send x-ssh-certificate.