# Gitea repository API

**Canonical:** https://apis.io/apis/gitea/gitea-repository-api/  
**Provider:** Gitea — https://apis.io/providers/gitea/  
**Base URL:** https://gitea.com/api/v1  
**Documentation:** https://docs.gitea.com/api/

Gitea repository API is one of 13 APIs that [Gitea](https://apis.io/providers/gitea/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 32 JSON Schema definitions. Tagged areas include Repository. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, code examples, and 32 JSON Schemas.

The repository API from Gitea — 133 operation(s) for repository.

## Operations (60 of 197)

| Method | Path | Summary |
|---|---|---|
| POST | `/repos/migrate` | Migrate a remote git repository |
| GET | `/repos/search` | Search for repositories |
| GET | `/repos/{owner}/{repo}` | Get a repository |
| DELETE | `/repos/{owner}/{repo}` | Delete a repository |
| PATCH | `/repos/{owner}/{repo}` | Edit a repository's properties. Only fields that are set will be changed. |
| GET | `/repos/{owner}/{repo}/actions/artifacts` | Lists all artifacts for a repository |
| GET | `/repos/{owner}/{repo}/actions/artifacts/{artifact_id}` | Gets a specific artifact for a workflow run |
| DELETE | `/repos/{owner}/{repo}/actions/artifacts/{artifact_id}` | Deletes a specific artifact for a workflow run |
| GET | `/repos/{owner}/{repo}/actions/artifacts/{artifact_id}/zip` | Downloads a specific artifact for a workflow run redirects to blob url |
| GET | `/repos/{owner}/{repo}/actions/jobs` | Lists all jobs for a repository |
| GET | `/repos/{owner}/{repo}/actions/jobs/{job_id}` | Gets a specific workflow job for a workflow run |
| GET | `/repos/{owner}/{repo}/actions/jobs/{job_id}/logs` | Downloads the job logs for a workflow run |
| GET | `/repos/{owner}/{repo}/actions/runners` | Get repo-level runners |
| POST | `/repos/{owner}/{repo}/actions/runners/registration-token` | Get a repository's actions runner registration token |
| GET | `/repos/{owner}/{repo}/actions/runners/{runner_id}` | Get a repo-level runner |
| DELETE | `/repos/{owner}/{repo}/actions/runners/{runner_id}` | Delete a repo-level runner |
| PATCH | `/repos/{owner}/{repo}/actions/runners/{runner_id}` | Update a repo-level runner |
| GET | `/repos/{owner}/{repo}/actions/runs` | Lists all runs for a repository run |
| GET | `/repos/{owner}/{repo}/actions/runs/{run}` | Gets a specific workflow run |
| DELETE | `/repos/{owner}/{repo}/actions/runs/{run}` | Delete a workflow run |
| GET | `/repos/{owner}/{repo}/actions/runs/{run}/artifacts` | Lists all artifacts for a repository run |
| GET | `/repos/{owner}/{repo}/actions/runs/{run}/jobs` | Lists all jobs for a workflow run |
| POST | `/repos/{owner}/{repo}/actions/runs/{run}/jobs/{job_id}/rerun` | Reruns a specific workflow job in a run |
| POST | `/repos/{owner}/{repo}/actions/runs/{run}/rerun` | Reruns an entire workflow run |
| POST | `/repos/{owner}/{repo}/actions/runs/{run}/rerun-failed-jobs` | Reruns all failed jobs in a workflow run |
| GET | `/repos/{owner}/{repo}/actions/secrets` | List an repo's actions secrets |
| PUT | `/repos/{owner}/{repo}/actions/secrets/{secretname}` | Create or Update a secret value in a repository |
| DELETE | `/repos/{owner}/{repo}/actions/secrets/{secretname}` | Delete a secret in a repository |
| GET | `/repos/{owner}/{repo}/actions/tasks` | List a repository's action tasks |
| GET | `/repos/{owner}/{repo}/actions/variables` | Get repo-level variables list |
| GET | `/repos/{owner}/{repo}/actions/variables/{variablename}` | Get a repo-level variable |
| PUT | `/repos/{owner}/{repo}/actions/variables/{variablename}` | Update a repo-level variable |
| POST | `/repos/{owner}/{repo}/actions/variables/{variablename}` | Create a repo-level variable |
| DELETE | `/repos/{owner}/{repo}/actions/variables/{variablename}` | Delete a repo-level variable |
| GET | `/repos/{owner}/{repo}/actions/workflows` | List repository workflows |
| GET | `/repos/{owner}/{repo}/actions/workflows/{workflow_id}` | Get a workflow |
| PUT | `/repos/{owner}/{repo}/actions/workflows/{workflow_id}/disable` | Disable a workflow |
| POST | `/repos/{owner}/{repo}/actions/workflows/{workflow_id}/dispatches` | Create a workflow dispatch event |
| PUT | `/repos/{owner}/{repo}/actions/workflows/{workflow_id}/enable` | Enable a workflow |
| GET | `/repos/{owner}/{repo}/activities/feeds` | List a repository's activity feeds |
| GET | `/repos/{owner}/{repo}/archive/{archive}` | Get an archive of a repository |
| GET | `/repos/{owner}/{repo}/assignees` | Return all users that have write access and can be assigned to issues |
| POST | `/repos/{owner}/{repo}/avatar` | Update avatar |
| DELETE | `/repos/{owner}/{repo}/avatar` | Delete avatar |
| GET | `/repos/{owner}/{repo}/branch_protections` | List branch protections for a repository |
| POST | `/repos/{owner}/{repo}/branch_protections` | Create a branch protections for a repository |
| POST | `/repos/{owner}/{repo}/branch_protections/priority` | Update the priorities of branch protections for a repository. |
| GET | `/repos/{owner}/{repo}/branch_protections/{name}` | Get a specific branch protection for the repository |
| DELETE | `/repos/{owner}/{repo}/branch_protections/{name}` | Delete a specific branch protection for the repository |
| PATCH | `/repos/{owner}/{repo}/branch_protections/{name}` | Edit a branch protections for a repository. Only fields that are set will be changed |
| GET | `/repos/{owner}/{repo}/branches` | List a repository's branches |
| POST | `/repos/{owner}/{repo}/branches` | Create a branch |
| GET | `/repos/{owner}/{repo}/branches/{branch}` | Retrieve a specific branch from a repository, including its effective branch protection |
| PUT | `/repos/{owner}/{repo}/branches/{branch}` | Update a branch reference to a new commit |
| DELETE | `/repos/{owner}/{repo}/branches/{branch}` | Delete a specific branch from a repository |
| PATCH | `/repos/{owner}/{repo}/branches/{branch}` | Rename a branch |
| GET | `/repos/{owner}/{repo}/collaborators` | List a repository's collaborators |
| GET | `/repos/{owner}/{repo}/collaborators/{collaborator}` | Check if a user is a collaborator of a repository |
| PUT | `/repos/{owner}/{repo}/collaborators/{collaborator}` | Add or Update a collaborator to a repository |
| DELETE | `/repos/{owner}/{repo}/collaborators/{collaborator}` | Delete a collaborator from a repository |

…and 137 more operations. They are listed in full on the page.

## Machine-readable artifacts (61)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/openapi/gitea-repository-api-openapi.yml
- **Documentation** — https://docs.gitea.com/api/
- **APIReference** — https://docs.gitea.com/api/1.26/
- **Swagger** — https://demo.gitea.com/api/swagger
- **GettingStarted** — https://docs.gitea.com/development/api-usage
- **Authentication** — https://docs.gitea.com/development/oauth2-provider
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-repository-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-issue-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-pullrequest-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-branch-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-commit-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-release-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-hook-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-organization-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-team-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-user-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-notificationthread-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-package-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-label-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-milestone-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-tag-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-schema/gitea-rest-api-comment-schema.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-repository-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-issue-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-pullrequest-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-branch-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-commit-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-release-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-hook-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-organization-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-team-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-user-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-notificationthread-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-package-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-label-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-milestone-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-tag-structure.json
- **JSONStructure** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/json-structure/gitea-rest-api-comment-structure.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repo-get-example.json
- **CodeExamples** — https://raw.githubusercontent.com/api-evangelist/gitea/refs/heads/main/examples/gitea-rest-api-repo-update-example.json
- …and 21 more, listed in full on the page.

## Other Gitea APIs (12)

- [Gitea Actions API](https://apis.io/apis/gitea/gitea-actions-api/)
- [Gitea Package Registry](https://apis.io/apis/gitea/gitea-package-registry/)
- [Gitea Webhooks](https://apis.io/apis/gitea/gitea-webhooks/)
- [Gitea Cloud Management API](https://apis.io/apis/gitea/gitea-cloud-management-api/)
- [Gitea admin API](https://apis.io/apis/gitea/gitea-admin-api/)
- [Gitea issue API](https://apis.io/apis/gitea/gitea-issue-api/)
- [Gitea miscellaneous API](https://apis.io/apis/gitea/gitea-miscellaneous-api/)
- [Gitea notification API](https://apis.io/apis/gitea/gitea-notification-api/)
- [Gitea organization API](https://apis.io/apis/gitea/gitea-organization-api/)
- [Gitea package API](https://apis.io/apis/gitea/gitea-package-api/)
- [Gitea settings API](https://apis.io/apis/gitea/gitea-settings-api/)
- [Gitea user API](https://apis.io/apis/gitea/gitea-user-api/)

## Tags

Repository

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gitea/gitea-repository-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gitea/.