Add skills/gitea/references/repos.md

2026-05-24 23:58:12 -05:00
parent f32673e4f5
commit d1d4c0844f
1 changed files with 103 additions and 0 deletions
@@ -0,0 +1,103 @@
+# Repository API reference
+
+Base: `https://git.mpm.to/api/v1`
+
+## List repositories for the authenticated user
+
+```
+GET /repos/search?token=...&limit=50&page=1
+```
+
+Or list all repos the authenticated user has access to:
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/search?limit=50&page=1"
+```
+
+Key response fields per repo: `id`, `full_name`, `description`, `private`, `fork`, `stars_count`, `forks_count`, `open_issues_count`, `default_branch`, `updated_at`, `html_url`.
+
+## List repos for a specific organization
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/orgs/{org}/repos?limit=50"
+```
+
+## List repos for a specific user
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/users/{username}/repos?limit=50"
+```
+
+## Get a single repository
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/{owner}/{repo}"
+```
+
+## Search repositories
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/search?q=SEARCH_TERM&limit=20"
+```
+
+## Create a repository (for the authenticated user)
+
+```bash
+curl -s -X POST \
+  -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "name": "repo-name",
+    "description": "Description here",
+    "private": false,
+    "auto_init": true,
+    "default_branch": "main"
+  }' \
+  "https://git.mpm.to/api/v1/user/repos"
+```
+
+## Create a repository under an organization
+
+```bash
+curl -s -X POST \
+  -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  -H "Content-Type: application/json" \
+  -d '{"name": "repo-name", "description": "...", "private": false}' \
+  "https://git.mpm.to/api/v1/orgs/{org}/repos"
+```
+
+## Delete a repository
+
+```bash
+curl -s -X DELETE \
+  -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/{owner}/{repo}"
+```
+
+Returns 204 on success. Always confirm with the user before deleting.
+
+## List branches
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/{owner}/{repo}/branches"
+```
+
+## List topics/tags on a repo
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/{owner}/{repo}/topics"
+```
+
+## Get repo collaborators
+
+```bash
+curl -s -H "Authorization: token e82a7235b948fbbeea60329422fcac89fa5a5ce8" \
+  "https://git.mpm.to/api/v1/repos/{owner}/{repo}/collaborators"
+```