{"components":{"schemas":{},"securitySchemes":{"bearerAuth":{"bearerFormat":"JWT","scheme":"bearer","type":"http"}}},"info":{"description":"The Code Storage HTTP API exposes repository management, Git reads, and write workflows over plain HTTPS.\n\n## Authentication\n\nSend a signed JWT in the `Authorization: Bearer \u003ctoken\u003e` header on every request.\n\n- Organisation-scoped endpoints such as `GET /api/repos` require organisation scopes like `org:read`\n- Repository-scoped endpoints require a JWT whose `repo` claim names the target repository\n- Write operations require the relevant scope such as `git:write` or `repo:write`\n\n## Pagination\n\nList endpoints use cursor-based pagination.\n\n- `cursor` is an opaque token returned by the previous response\n- `limit` defaults to `20` and is capped per endpoint\n- `has_more` tells you whether another request is available\n- `next_cursor` becomes the next `cursor` value\n\n## Paths\n\nPreferred routes use the shorter `/api/...` form. Legacy `/api/v1/...` aliases remain documented where they are still supported and are marked as deprecated when a preferred route exists.\n\n## Repository names in paths\n\n- Names containing `/` (or any other character that is not safe in a URL path segment) **must** be URL encoded so the value occupies a single path segment. For example, `pierre/example` becomes `pierre%2Fexample` and the request URL is `/api/repos/pierre%2Fexample/...`.\n- Plain names that contain only URL-safe characters can be sent as-is: `/api/repos/dotfiles/...`.\n- The server URL-decodes the value before resolving the repository, so double-encoding is not required.\n\n## Errors\n\nMost endpoints return RFC 9457-compatible problem details under `application/problem+json`, with a legacy `error` field mirrored from `detail`.\n\nStreaming commit and note workflows may return operation-specific failure bodies so callers can inspect partial results, branch state, or workflow status without parsing generic error strings.","title":"code.storage","version":"1.0.0"},"openapi":"3.1.0","paths":{"/api/repo-urls/{repo_id}":{"get":{"description":"Resolve the repository URL path for an internal repository ID in the current organisation. The returned `url` is the value clients use in the JWT `repo` claim.\n#### JWT claims\nRequired scopes: `org:read`  \nRequires per repo scope: No","operationId":"get_repo_url_by_id","parameters":[{"description":"Internal repository ID to resolve.","example":"repo_7f2b3d9","in":"path","name":"repo_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"repo_id":"repo_7f2b3d9","repo_name":"team/project-alpha","url":"team/project-alpha"},"schema":{"additionalProperties":false,"description":"Repository URL path resolved from an internal repository ID.","properties":{"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["team/project-alpha"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["team/project-alpha"],"type":"string"}},"required":["repo_id","repo_name","url"],"type":"object"}}},"description":"Repository URL path resolved from the supplied internal repository ID."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"example":{"detail":"repository not found","error":"repository not found","instance":"/api/repo-urls/repo_7f2b3d9","status":404,"title":"Not Found","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"repository not found","error":"repository not found","instance":"/api/repo-urls/repo_7f2b3d9","status":404,"title":"Not Found","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"No active repository with that ID exists for the current organisation."},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Repo Url By Id","tags":["Repositories"],"x-permission-scopes":["org:read"],"x-requires-repo-scope":false,"x-stability":"stable"}},"/api/repos":{"get":{"description":"List repositories for the current organisation with cursor-based pagination. Supply `q` to filter results by a case-insensitive substring match against the repository `url` (for example `pierre/sdk-documentation`).\n#### JWT claims\nRequired scopes: `org:read`  \nRequires per repo scope: No","operationId":"list_repos","parameters":[{"description":"Case-insensitive substring to match against the repository `url`. Trimmed before matching. When omitted or empty after trimming, the full repository list is returned.","example":"sdk","in":"query","name":"q","schema":{"type":"string"}},{"description":"Pagination cursor from previous response (base64 encoded)","example":"MTcwNzU3MzQ1MTAwMDAwMDAwMHxyZXBvXzlhNGMyMWY","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of repositories to return. Defaults to 20 and is capped at 100.","example":20,"in":"query","name":"limit","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"next_cursor":"MTcwNzU3MzQ1MTAwMDAwMDAwMHxyZXBvXzlhNGMyMWY","repos":[{"base_repo":{"name":"Hello-World","owner":"octocat","provider":"github"},"created_at":"2026-02-11T18:22:41Z","default_branch":"main","repo_id":"repo_7f2b3d9","repo_name":"pierre/sdk-documentation","url":"pierre/sdk-documentation"}]},"schema":{"additionalProperties":false,"description":"Paginated list of repositories for the current organisation.","properties":{"has_more":{"description":"Whether another page is available.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page, if any.","examples":["MTcwNzU3MzQ1MTAwMDAwMDAwMHxyZXBvXzlhNGMyMWY"],"type":"string"},"repos":{"description":"Repositories in the current page.","items":{"additionalProperties":false,"description":"Repository summary entry.","properties":{"base_repo":{"additionalProperties":false,"description":"Git Sync configuration (if configured)","properties":{"name":{"description":"Upstream repository name.","examples":["Hello-World"],"type":"string"},"owner":{"description":"Upstream repository owner or namespace.","examples":["octocat"],"type":"string"},"provider":{"description":"Upstream provider name.","examples":["github"],"type":"string"}},"required":["provider"],"type":"object"},"created_at":{"description":"ISO 8601 creation timestamp","examples":["2026-02-11T18:22:41Z"],"type":"string"},"default_branch":{"description":"Default branch name","examples":["main"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["pierre/sdk-documentation"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["pierre/sdk-documentation"],"type":"string"}},"required":["repo_id","repo_name","url","default_branch","created_at"],"type":"object"},"type":"array"}},"required":["repos","has_more"],"type":"object"}}},"description":"A paginated view of repositories in the organisation."},"400":{"content":{"application/json":{"example":{"detail":"invalid cursor","error":"invalid cursor","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"invalid cursor","error":"invalid cursor","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The supplied pagination cursor could not be decoded."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Repos","tags":["Repositories"],"x-permission-scopes":["org:read"],"x-requires-repo-scope":false,"x-stability":"stable"},"post":{"description":"Create a repository using the repo name embedded in the JWT. You can start empty, mirror an upstream repository, or fork another Code Storage repository into a new independent repo.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"create_repo","parameters":[{"description":"Optional default branch override. When present, it is used if the request body does not already specify one.","example":"main","in":"query","name":"default_branch","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"default_branch":"main"},"examples":{"empty_repo":{"description":"Create a new repository with an explicit default branch.","summary":"Empty repository","value":{"default_branch":"main"}},"fork":{"description":"Create an independent repository by cloning another Code Storage repo at a chosen ref.","summary":"Internal fork","value":{"base_repo":{"auth":{"auth_type":"jwt","token":"BASE_REPO_READ_TOKEN"},"name":"sdk-documentation","operation":"fork","owner":"pierre","provider":"code.storage","ref":"main"},"default_branch":"feature-preview"}},"generic_git_sync":{"description":"Mirror a repository from a generic HTTPS Git provider such as GitLab, Bitbucket, Gitea, or Forgejo.","summary":"Generic HTTPS Git sync","value":{"base_repo":{"default_branch":"main","name":"repo-name","owner":"org-name","provider":"gitea","upstream_host":"git.example.com"},"default_branch":"main"}},"public_github_sync":{"description":"Mirror a public GitHub repository without an app installation.","summary":"Public GitHub sync","value":{"base_repo":{"auth":{"auth_type":"public"},"default_branch":"main","name":"hello-world","owner":"octocat","provider":"github"}}}},"schema":{"additionalProperties":false,"description":"Create-repository request body. The repository identity comes from the JWT `repo` claim; the body supplies optional default-branch and Git Sync or fork configuration.","properties":{"base_repo":{"additionalProperties":false,"description":"Optional upstream or fork source configuration.","properties":{"auth":{"additionalProperties":false,"description":"Authentication used to read the base repository when needed.","properties":{"auth_type":{"description":"Use public for public GitHub sync or jwt for internal forks.","enum":["public","jwt"],"type":"string"},"token":{"description":"JWT granting read access to the base repository for fork operations.","type":"string"}},"type":"object"},"default_branch":{"description":"Default branch to track for sync-backed repositories.","type":"string"},"name":{"description":"Repository name on the upstream provider.","type":"string"},"operation":{"default":"sync","description":"sync mirrors an upstream provider. fork clones another Code Storage repository into a new independent repo.","enum":["sync","fork"],"type":"string"},"owner":{"description":"Repository owner or namespace on the upstream provider.","type":"string"},"provider":{"description":"Upstream provider, such as github, gitlab, or code.storage for forks.","enum":["github","gitlab","bitbucket","gitea","forgejo","codeberg","sr.ht","sourcehut","code.storage"],"type":"string"},"ref":{"description":"Branch or tag to fork from. Ignored when sha is supplied.","type":"string"},"sha":{"description":"Exact commit to fork from. Overrides ref when both are set.","type":"string"},"upstream_host":{"description":"Bare hostname for self-hosted providers, such as gitlab.example.com.","type":"string"}},"required":["provider","owner","name","default_branch"],"type":"object"},"default_branch":{"description":"Default branch for the new repository. Defaults to main when omitted.","examples":["main"],"type":"string"}},"type":"object"}}},"description":"Create either an empty repository, a synced repository backed by an upstream provider, or a fork of another Code Storage repository."},"responses":{"200":{"content":{"application/json":{"example":{"http_url":"pierre/sdk-documentation","message":"repository created","repo_id":"repo_7f2b3d9","repo_name":"pierre/sdk-documentation"},"schema":{"additionalProperties":false,"description":"Result of creating a repository, including the assigned internal repository ID and the repository URL path.","properties":{"http_url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["pierre/sdk-documentation"],"type":"string"},"message":{"description":"High-level creation result.","examples":["repository created"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["pierre/sdk-documentation"],"type":"string"}},"required":["repo_id","repo_name","http_url","message"],"type":"object"}}},"description":"Repository created successfully."},"400":{"content":{"application/json":{"example":{"detail":"unknown provider: example-host","error":"unknown provider: example-host","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"unknown provider: example-host","error":"unknown provider: example-host","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The repository name, base repository configuration, or upstream provider was invalid."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Repo","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-request-validation-profile":"create_repo","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}":{"delete":{"description":"Permanently retire a repository. The API performs a soft delete first and then triggers asynchronous hot and cold storage cleanup.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"delete_repo","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"message":"Repository repo_7f2b3d9 deletion initiated. Physical storage cleanup will complete asynchronously.","repo_id":"repo_7f2b3d9"},"schema":{"additionalProperties":false,"description":"Confirmation that the repository deletion has been accepted.","properties":{"message":{"description":"Human-readable deletion status message.","examples":["Repository repo_7f2b3d9 deletion initiated. Physical storage cleanup will complete asynchronously."],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"}},"required":["repo_id","message"],"type":"object"}}},"description":"Deletion accepted. Physical storage cleanup continues asynchronously."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"detail":"repository already deleted","error":"repository already deleted","instance":"/api/repos/dotfiles","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"repository already deleted","error":"repository already deleted","instance":"/api/repos/dotfiles","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The repository was already deleted."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Repo","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-requires-repo-scope":true,"x-stability":"stable"},"get":{"description":"Fetch repository metadata for the repository identified by the JWT `repo` claim.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_repo","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"base_repo":{"name":"Hello-World","owner":"octocat","provider":"github"},"created_at":"2024-01-15T10:30:00Z","default_branch":"main","repo_id":"repo_7f2b3d9","repo_name":"team/project-alpha","url":"team/project-alpha"},"schema":{"additionalProperties":false,"description":"Detailed view of a single repository, including any Git Sync configuration.","properties":{"base_repo":{"additionalProperties":false,"description":"Git Sync configuration (if configured).","properties":{"name":{"description":"Upstream repository name.","examples":["Hello-World"],"type":"string"},"owner":{"description":"Upstream repository owner or namespace.","examples":["octocat"],"type":"string"},"provider":{"description":"Upstream provider name.","examples":["github"],"type":"string"}},"required":["provider"],"type":"object"},"created_at":{"description":"ISO 8601 creation timestamp.","examples":["2024-01-15T10:30:00Z"],"type":"string"},"default_branch":{"description":"Default branch name.","examples":["main"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["team/project-alpha"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["team/project-alpha"],"type":"string"}},"required":["repo_id","repo_name","url","default_branch","created_at"],"type":"object"}}},"description":"Repository metadata resolved from the JWT `repo` claim."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Repo","tags":["Repositories"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"patch":{"description":"Change the default branch of the repository identified by the JWT `repo` claim.\n\nThe gateway reads the current `HEAD` symbolic ref, then repoints it at the requested branch through a transactional compare-and-swap against that value, and finally records the new default branch in the repository row. Branch names are fully qualified for you: `main` is written as the symref target `refs/heads/main`, and a value that already starts with `refs/` is used verbatim. The branch itself is not created by this call.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"update_repo","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"default_branch":"main"},"schema":{"additionalProperties":false,"description":"Repository settings to patch, such as the default branch.","properties":{"default_branch":{"description":"New default branch name for the Code Storage repository.","examples":["main"],"type":"string"}},"type":"object"}}},"description":"Repository settings to change. `default_branch` is the only supported field and must be a non-empty branch name.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"default_branch":"main","id":"repo_7f2b3d9","repo_id":"repo_7f2b3d9","repo_name":"pierre/sdk-documentation","url":"pierre/sdk-documentation"},"schema":{"additionalProperties":false,"description":"Repository state after applying the patch.","properties":{"default_branch":{"description":"Updated default branch name.","examples":["main"],"type":"string"},"id":{"deprecated":true,"description":"Deprecated: use repo_id. Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["pierre/sdk-documentation"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["pierre/sdk-documentation"],"type":"string"}},"required":["repo_id","id","repo_name","url","default_branch"],"type":"object"}}},"description":"Default branch updated. Returns the repository ID, its URL path, and the branch name now recorded as the default."},"400":{"content":{"application/json":{"example":{"detail":"default_branch is required","error":"default_branch is required","instance":"/api/repos/my-demo-repository","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"default_branch is required","error":"default_branch is required","instance":"/api/repos/my-demo-repository","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The body could not be decoded as JSON, or `default_branch` was missing or empty."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"No repository matching the JWT `repo` claim exists for this organisation."},"409":{"content":{"application/json":{"example":{"detail":"default branch was modified concurrently, please retry","error":"default branch was modified concurrently, please retry","instance":"/api/repos/my-demo-repository","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"default branch was modified concurrently, please retry","error":"default branch was modified concurrently, please retry","instance":"/api/repos/my-demo-repository","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"`HEAD` moved between the read and the compare-and-swap, so the update was rejected. Retry the request."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The current `HEAD` value could not be read from storage, so no compare-and-swap was attempted and nothing was changed."}},"security":[{"bearerAuth":[]}],"summary":"Update Repository Settings","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-request-validation-profile":"update_repo","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/archive":{"post":{"description":"Download a repository snapshot without cloning the repo. This is useful for packaging docs, examples, or release artefacts directly from a branch, tag, or commit.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"archive","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"examples":{"docs_snapshot":{"description":"Download just the docs tree with a prefixed root folder.","summary":"Filtered documentation snapshot","value":{"archive":{"prefix":"sdk-docs/"},"exclude_globs":["**/drafts/**"],"include_globs":["docs/**","README.md"],"ref":"main"}}},"schema":{"additionalProperties":false,"description":"Archive options describing the ref to snapshot and the include or exclude filters applied to the resulting tarball.","properties":{"archive":{"additionalProperties":false,"description":"Optional archive output settings.","properties":{"prefix":{"description":"Prefix to add to every file path inside the archive.","type":"string"}},"type":"object"},"exclude_globs":{"description":"Exclude files matching these glob patterns after include filtering.","items":{"description":"Glob pattern such as `node_modules/**`.","type":"string"},"type":"array"},"include_globs":{"description":"Only include files matching these glob patterns.","items":{"description":"Glob pattern such as `src/**/*.go`.","type":"string"},"type":"array"},"max_blob_size":{"description":"Maximum blob size to include in the archive, in bytes.","format":"int64","type":"integer"},"ref":{"description":"Branch, tag, or commit to archive. When omitted, the default branch or HEAD is used.","type":"string"}},"required":["ref"],"type":"object"}}},"description":"Request a `.tar.gz` snapshot of the repository at a branch, tag, or commit. Include and exclude globs let you shape the archive before it streams back."},"responses":{"200":{"content":{"application/gzip":{"schema":{"contentMediaType":"application/octet-stream","description":"Gzip-compressed tar archive stream.","format":"binary","type":"string"}}},"description":"A streamed `.tar.gz` archive of the resolved revision.","headers":{"Cache-Control":{"description":"Archive downloads are returned with `no-store`.","schema":{"type":"string"}},"Content-Disposition":{"description":"Attachment filename generated from the repository URL and resolved revision.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Archive","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/base":{"delete":{"description":"Detach the repository from its configured upstream provider. The operation is idempotent: already-detached repositories return success.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"unset_base_repo","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"message":"repository detached"},"schema":{"additionalProperties":false,"description":"Confirmation that the upstream link has been detached from the repository.","properties":{"message":{"description":"Human-readable detach status message.","examples":["repository detached"],"type":"string"}},"required":["message"],"type":"object"}}},"description":"Upstream detach result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"message":"repository detached"},"schema":{"additionalProperties":false,"description":"Confirmation that the upstream link has been detached from the repository.","properties":{"message":{"description":"Human-readable detach status message.","examples":["repository detached"],"type":"string"}},"required":["message"],"type":"object"}}},"description":"The detach workflow is already in progress or the sync workflow is missing."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Unset Base Repo","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/blame":{"get":{"description":"Return per-line blame metadata for a file at a branch, tag, or commit. Supports `git blame -L`-style range filters and rename/copy detection for callers building IDE blame views or audit tooling.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"blame","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Repository-relative file path to blame.","example":"src/main.go","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to blame at. When omitted, the repository default branch is used.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Optional `git blame -L`-style range spec. May be repeated to blame multiple regions (max 16). Each value is one `-L` argument: e.g. `10,20`, `10,+5`, `/getUser/,/^}/`, `/getUser/,+30`, `10,`, `,20`, `10`, `:^func .*Foo`, `:funcname`.","example":["10,20"],"in":"query","name":"range","schema":{"items":{"type":"string"},"type":"array"}},{"description":"Follow the file across renames and copies.","in":"query","name":"detect_moves","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"commit_sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","lines":[{"author_email":"jane@example.com","author_name":"Jane Doe","author_time":"2024-01-15T14:32:18Z","commit_sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","committer_email":"jane@example.com","committer_name":"Jane Doe","committer_time":"2024-01-15T14:32:18Z","line_number":42,"original_line_number":40,"original_path":"src/main.go","previous_commit_sha":"a4d39d7c79e819ab003fc78805954584e1ee36","summary":"fix: resolve scrolling issue in dashboard"}],"path":"src/main.go","ref":"main"},"schema":{"additionalProperties":false,"description":"Per-line blame information for the requested file at the resolved revision.","properties":{"commit_sha":{"description":"Commit SHA the blame was computed at.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"lines":{"description":"Per-line blame results in file order.","items":{"additionalProperties":false,"description":"Single blame entry describing the commit and author responsible for a line.","properties":{"author_email":{"description":"Author email of the commit that last touched this line.","examples":["jane@example.com"],"type":"string"},"author_name":{"description":"Author of the commit that last touched this line.","examples":["Jane Doe"],"type":"string"},"author_time":{"description":"Author timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"commit_sha":{"description":"Commit SHA that last touched this line.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"committer_email":{"description":"Committer email of the commit that last touched this line.","examples":["jane@example.com"],"type":"string"},"committer_name":{"description":"Committer of the commit that last touched this line.","examples":["Jane Doe"],"type":"string"},"committer_time":{"description":"Committer timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"line_number":{"description":"Line number in the current file.","examples":[42],"format":"int32","type":"integer"},"original_line_number":{"description":"Line number in the original file before any renames or moves.","examples":[40],"format":"int32","type":"integer"},"original_path":{"description":"Original repository-relative path the line was introduced at.","examples":["src/main.go"],"type":"string"},"previous_commit_sha":{"description":"Commit SHA prior to the current commit when known.","examples":["a4d39d7c79e819ab003fc78805954584e1ee36"],"type":"string"},"summary":{"description":"First line of the commit message.","examples":["fix: resolve scrolling issue in dashboard"],"type":"string"}},"required":["line_number","commit_sha","original_line_number","original_path","author_name","author_email","author_time","committer_name","committer_email","committer_time","summary"],"type":"object"},"type":"array"},"path":{"description":"Repository-relative file path that was blamed.","examples":["src/main.go"],"type":"string"},"ref":{"description":"Resolved ref used for the blame.","examples":["main"],"type":"string"}},"required":["ref","path","commit_sha","lines"],"type":"object"}}},"description":"Per-line blame for the resolved file revision."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Blame","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/branch":{"get":{"description":"Get one branch by its exact short name. The response omits list pagination fields.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_branch","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Exact short branch name.","example":"main","in":"query","name":"name","required":true,"schema":{"type":"string"}},{"description":"When true, get the branch from the ephemeral namespace.","in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"branch":{"created_at":"2024-01-15T10:30:00Z","head_sha":"a1b2c3d4e5f6","name":"main"}},"schema":{"additionalProperties":false,"description":"One branch that matches an exact short name.","properties":{"branch":{"additionalProperties":false,"description":"The branch that has the requested name.","properties":{"created_at":{"description":"ISO 8601 creation timestamp.","examples":["2024-01-15T10:30:00Z"],"type":"string"},"head_sha":{"description":"HEAD commit SHA for the branch.","examples":["a1b2c3d4e5f6"],"type":"string"},"name":{"description":"Branch name.","examples":["main"],"type":"string"}},"required":["name","head_sha","created_at"],"type":"object"}},"required":["branch"],"type":"object"}}},"description":"The branch with the requested name."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Branch","tags":["Branches"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/branches":{"delete":{"description":"Delete a branch from the repository. The default branch is protected and cannot be deleted through this endpoint.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"delete_branch","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"ephemeral":false,"name":"feature/old-onboarding","target_branch":"feature/old-onboarding"},"schema":{"additionalProperties":false,"description":"Branch deletion request identifying the branch to remove.","properties":{"ephemeral":{"description":"Delete the branch from the ephemeral namespace instead of the default namespace.","examples":[false],"type":"boolean"},"name":{"deprecated":true,"description":"Deprecated: use target_branch. Branch name to delete.","examples":["feature/old-onboarding"],"type":"string"},"target_branch":{"description":"Branch name to delete. Must not start with refs/. Provide target_branch or the deprecated name.","examples":["feature/old-onboarding"],"type":"string"}},"type":"object"}}},"description":"Delete a branch by name. The server resolves the current branch tip before deleting, so the caller does not need the branch SHA.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"ephemeral":false,"message":"branch deleted","name":"feature/old-onboarding","target_branch":"feature/old-onboarding"},"schema":{"additionalProperties":false,"description":"Result of deleting a branch.","properties":{"ephemeral":{"description":"Whether the deleted branch lived in the ephemeral namespace.","examples":[false],"type":"boolean"},"message":{"description":"Human-readable result message.","examples":["branch deleted"],"type":"string"},"name":{"deprecated":true,"description":"Deprecated: use target_branch. Deleted branch name.","examples":["feature/old-onboarding"],"type":"string"},"target_branch":{"description":"Deleted branch name.","examples":["feature/old-onboarding"],"type":"string"}},"required":["target_branch","name","ephemeral","message"],"type":"object"}}},"description":"Branch deletion result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"detail":"cannot delete the default branch","error":"cannot delete the default branch","instance":"/api/repos/dotfiles/branches","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"cannot delete the default branch","error":"cannot delete the default branch","instance":"/api/repos/dotfiles/branches","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The branch could not be deleted because it is the repository default branch."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Branch","tags":["Branches"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"},"get":{"description":"List branches in the repository with cursor pagination. Use this to build branch selectors, review tools, or sync jobs without shelling out to Git.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"list_branches","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Pagination cursor returned by a previous `list_branches` response.","example":"b_456def","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of branches to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}},{"description":"When true, list branches under the ephemeral namespace instead of regular branches.","in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"branches":[{"created_at":"2024-01-15T10:30:00Z","cursor":"b_123abc","head_sha":"a1b2c3d4e5f6","name":"main"}],"has_more":true,"next_cursor":"b_456def"},"schema":{"additionalProperties":false,"description":"Paginated list of branches for the repository.","properties":{"branches":{"description":"List of branch objects.","items":{"additionalProperties":false,"description":"Branch summary entry.","properties":{"created_at":{"description":"ISO 8601 creation timestamp.","examples":["2024-01-15T10:30:00Z"],"type":"string"},"cursor":{"description":"Opaque pagination token for this branch entry.","examples":["b_123abc"],"type":"string"},"head_sha":{"description":"HEAD commit SHA for the branch.","examples":["a1b2c3d4e5f6"],"type":"string"},"name":{"description":"Branch name.","examples":["main"],"type":"string"}},"required":["cursor","name","head_sha","created_at"],"type":"object"},"type":"array"},"has_more":{"description":"Whether more branches exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["b_456def"],"type":"string"}},"required":["branches","has_more"],"type":"object"}}},"description":"Repository branches in creation order."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Branches","tags":["Branches"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/branches/create":{"post":{"description":"Create a new branch from an existing branch or ref. This is useful for agent workflows, ephemeral previews, or server-side automation where you do not want to clone the repo first.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"create_branch","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"base_branch":"main","base_is_ephemeral":false,"target_branch":"feature/new-onboarding","target_is_ephemeral":false},"schema":{"additionalProperties":false,"description":"Create-branch request body describing the new branch and its base ref.","properties":{"base_branch":{"deprecated":true,"description":"Deprecated: use base_ref. Preferred source branch name.","examples":["main"],"type":"string"},"base_is_ephemeral":{"description":"Whether the base branch should be resolved from the ephemeral namespace.","examples":[false],"type":"boolean"},"base_ref":{"description":"Optional source ref or revision. Provide base_ref or the deprecated base_branch.","type":"string"},"force":{"description":"Allow non-fast-forward updates when recreating an existing branch.","type":"boolean"},"preferred_base":{"description":"Optional pack hint. A branch name the backend prefers as the delta base when it builds the thin pack. It does not change the source or the result.","type":"string"},"target_branch":{"description":"Destination branch name.","examples":["feature/new-onboarding"],"type":"string"},"target_is_ephemeral":{"description":"Whether the new branch should be created in the ephemeral namespace.","examples":[false],"type":"boolean"}},"required":["target_branch"],"type":"object"}}},"description":"Create a branch from another branch or ref. The source and destination can live in the default namespace or the ephemeral namespace.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"commit_sha":"abc123def4567890abc123def4567890abc123de","message":"branch created","target_branch":"feature/new-onboarding","target_is_ephemeral":false},"schema":{"additionalProperties":false,"description":"Result of creating a branch, including the resulting ref state.","properties":{"commit_sha":{"description":"Resolved commit SHA at the new branch tip.","examples":["abc123def4567890abc123def4567890abc123de"],"type":"string"},"message":{"description":"Human-readable result message.","examples":["branch created"],"type":"string"},"target_branch":{"description":"Destination branch name.","examples":["feature/new-onboarding"],"type":"string"},"target_is_ephemeral":{"description":"Whether the created branch is ephemeral.","examples":[false],"type":"boolean"}},"required":["message","target_branch","target_is_ephemeral"],"type":"object"}}},"description":"Branch creation result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Branch","tags":["Branches"],"x-permission-scopes":["git:write"],"x-request-validation-profile":"create_branch","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/branches/diff":{"get":{"description":"Compare a feature branch to its base branch and return every change that would be reviewed before a merge. Repeated `path` filters limit the diff to selected files and bypass the usual large-file filtering for those requested paths.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_branch_diff","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Branch name to diff.","example":"feature/new-auth","in":"query","name":"branch","required":true,"schema":{"type":"string"}},{"description":"Optional base branch or ref to diff against.","example":"main","in":"query","name":"base","schema":{"type":"string"}},{"description":"Whether `branch` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Whether `base` should be resolved from the ephemeral namespace.","example":false,"in":"query","name":"ephemeral_base","schema":{"type":"boolean"}},{"description":"Optional repeated path filter. Provide multiple `path` query values to restrict the diff to specific files or directories.","example":["src/main.go","README.md"],"in":"query","name":"path","schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"example":{"base":"main","branch":"feature/new-feature","files":[{"bytes":2048,"is_eof":true,"path":"src/main.go","raw":"diff --git a/src/main.go b/src/main.go\n...","state":"M"}],"filtered_files":[{"bytes":50000,"is_eof":true,"path":"package-lock.json","state":"M"}],"merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","stats":{"additions":50,"changes":60,"deletions":10,"files":3}},"schema":{"additionalProperties":false,"description":"Diff between a branch and its base, including merge base, aggregate stats, and per-file changes.","properties":{"base":{"description":"The base branch or ref used for comparison.","examples":["main"],"type":"string"},"branch":{"description":"The branch name being diffed.","examples":["feature/new-feature"],"type":"string"},"files":{"description":"Files returned with inline diff content.","items":{"additionalProperties":false,"description":"Per-file diff entry including the raw unified diff text.","properties":{"additions":{"description":"Added lines in this file.","format":"int64","type":"integer"},"bytes":{"description":"File size in bytes.","examples":[2048],"format":"int64","type":"integer"},"deletions":{"description":"Deleted lines in this file.","format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames).","examples":["src/main.go"],"type":"string"},"raw":{"description":"Raw unified diff content.","examples":["diff --git a/src/main.go b/src/main.go\n..."],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","raw","bytes","is_eof","additions","deletions"],"type":"object"},"type":"array"},"filtered_files":{"description":"Files filtered out of inline diff output because of size or file-type rules.","items":{"additionalProperties":false,"description":"Per-file diff entry that was excluded from inline diff output because of size or file-type rules.","properties":{"bytes":{"description":"File size in bytes.","examples":[50000],"format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames). Excluded from inline diff content because of size or file-type rules.","examples":["package-lock.json"],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","bytes","is_eof"],"type":"object"},"type":"array"},"merge_base_sha":{"description":"Merge base SHA used for the three-dot branch diff.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"stats":{"additionalProperties":false,"description":"Aggregate diff statistics.","properties":{"additions":{"description":"Total added lines across the diff.","examples":[50],"format":"int64","type":"integer"},"changes":{"description":"Total line changes (additions plus deletions).","examples":[60],"format":"int64","type":"integer"},"deletions":{"description":"Total deleted lines across the diff.","examples":[10],"format":"int64","type":"integer"},"files":{"description":"Number of files changed.","examples":[3],"format":"int64","type":"integer"}},"required":["files","additions","deletions","changes"],"type":"object"}},"required":["branch","base","merge_base_sha","stats","files","filtered_files"],"type":"object"}}},"description":"Diff between a source branch and its base, including the merge base used for the three-dot comparison."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Branch Diff","tags":["Commits"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/commit":{"get":{"description":"Resolve a branch name, short SHA, or full SHA to a commit and return the same metadata shape used in commit listings. Use this when you need commit details without computing a diff.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_commit","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Branch name, tag, full commit SHA, short SHA, or other revision Git can resolve. Provide `ref` or the deprecated `sha`.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use ref instead. Commit SHA, short SHA, branch name, or other revision Git can resolve.","example":"main","in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"commit":{"author_email":"jane@example.com","author_name":"Jane Doe","committer_email":"jane@example.com","committer_name":"Jane Doe","date":"2024-01-15T14:32:18Z","message":"fix: resolve scrolling issue in dashboard","parent_shas":["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"],"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","signature":"-----BEGIN PGP SIGNATURE-----\n...\n-----END PGP SIGNATURE-----\n"}},"schema":{"additionalProperties":false,"description":"Commit metadata for a single resolved revision, without diff content.","properties":{"commit":{"additionalProperties":false,"description":"Resolved commit metadata.","properties":{"author_email":{"description":"Commit author email.","examples":["jane@example.com"],"type":"string"},"author_name":{"description":"Commit author name.","examples":["Jane Doe"],"type":"string"},"committer_email":{"description":"Commit committer email.","examples":["jane@example.com"],"type":"string"},"committer_name":{"description":"Commit committer name.","examples":["Jane Doe"],"type":"string"},"date":{"description":"Commit timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"message":{"description":"The commit message.","examples":["fix: resolve scrolling issue in dashboard"],"type":"string"},"parent_shas":{"description":"Parent commit SHAs in Git parent order. Empty for root commits.","examples":[["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"]],"items":{"type":"string"},"type":"array"},"payload":{"description":"The signed payload: the raw commit object with the gpgsig header removed. This is the exact data the signature is computed over. Absent for unsigned commits.","type":"string"},"sha":{"description":"The commit SHA.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"signature":{"description":"Armored signature from the commit's gpgsig header (OpenPGP or SSH). Absent for unsigned commits.","examples":["-----BEGIN PGP SIGNATURE-----\n...\n-----END PGP SIGNATURE-----\n"],"type":"string"}},"required":["sha","parent_shas","message","author_name","author_email","committer_name","committer_email","date"],"type":"object"}},"required":["commit"],"type":"object"}}},"description":"Commit metadata for the resolved revision."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Commit","tags":["Commits"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/commit-pack":{"post":{"description":"Create a commit by streaming file operations directly to the service. This is designed for automation, AI agents, and other workflows that need atomic Git writes without running a local Git process.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"commit_pack","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"expected_target_sha\":\"d34db33fd34db33fd34db33fd34db33fd34db33f\",\"commit_message\":\"Update docs\",\"author\":{\"name\":\"Docs Bot\",\"email\":\"docs@example.com\"},\"files\":[{\"path\":\"docs/changelog.md\",\"operation\":\"upsert\",\"content_id\":\"blob-1\",\"mode\":\"100644\"},{\"path\":\"docs/legacy.txt\",\"operation\":\"delete\",\"content_id\":\"blob-2\"}]}}\n{\"blob_chunk\":{\"content_id\":\"blob-1\",\"data\":\"IyBWZXJzaW9uIDIuMS4wCi0gcmVmcmVzaCBkb2NzCg==\",\"eof\":true}}\n{\"blob_chunk\":{\"content_id\":\"blob-2\",\"data\":\"\",\"eof\":true}}\n","schema":{"description":"NDJSON stream. The first line must be `metadata`; subsequent lines must be `blob_chunk` payloads. Decoded blob chunks are limited to 4 MiB each.","type":"string"}}},"description":"Send newline-delimited JSON where the first line is a `metadata` object and each following line is a `blob_chunk`. This lets you stream file contents without a local Git client.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Commit created and written to the target branch."},"400":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"expected branch head did not match current tip","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The NDJSON stream was malformed or metadata validation failed."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"expected branch head did not match current tip","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The branch moved or the requested update could not be applied cleanly."},"413":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"blob chunk size 5242881 exceeds maximum 4194304","new_sha":"","old_sha":"","status":"payload_too_large","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"A decoded blob chunk exceeded the 4 MiB limit."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Commit from Files","tags":["Commits"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/commits":{"get":{"description":"List commit history for the repository default branch or for an explicit branch. Results are cursor-paginated and ordered by commit date, newest first. Set `path` to restrict the history to commits that modified a specific file or subtree.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"list_commits","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit to list commits from. When omitted, the repository default branch is used. Provide `ref` or the deprecated `branch`.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use ref instead. Optional branch name to list commits from. When omitted, the repository default branch is used.","example":"main","in":"query","name":"branch","schema":{"type":"string"}},{"description":"Optional repository-relative path to scope the history to commits that touched that path.","example":"docs/guide.md","in":"query","name":"path","schema":{"type":"string"}},{"description":"Pagination cursor returned by a previous `list_commits` response.","example":"20","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of commits to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"commits":[{"author_email":"jane@example.com","author_name":"Jane Doe","committer_email":"jane@example.com","committer_name":"Jane Doe","date":"2024-01-15T14:32:18Z","message":"fix: resolve scrolling issue in dashboard","parent_shas":["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"],"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"}],"has_more":true,"next_cursor":"20"},"schema":{"additionalProperties":false,"description":"Paginated commit history for the repository, optionally filtered by branch.","properties":{"commits":{"description":"List of commit objects.","items":{"additionalProperties":false,"description":"Commit summary entry for a list-commits response.","properties":{"author_email":{"description":"Commit author email.","examples":["jane@example.com"],"type":"string"},"author_name":{"description":"Commit author name.","examples":["Jane Doe"],"type":"string"},"committer_email":{"description":"Commit committer email.","examples":["jane@example.com"],"type":"string"},"committer_name":{"description":"Commit committer name.","examples":["Jane Doe"],"type":"string"},"date":{"description":"Commit timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"message":{"description":"The commit message.","examples":["fix: resolve scrolling issue in dashboard"],"type":"string"},"parent_shas":{"description":"Parent commit SHAs in Git parent order. Empty for root commits.","examples":[["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"]],"items":{"type":"string"},"type":"array"},"sha":{"description":"The commit SHA.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"required":["sha","parent_shas","message","author_name","author_email","committer_name","committer_email","date"],"type":"object"},"type":"array"},"has_more":{"description":"Whether more commits exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["20"],"type":"string"}},"required":["commits","has_more"],"type":"object"}}},"description":"Commit history ordered from newest to oldest."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Commits","tags":["Commits"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/diff":{"get":{"description":"Get the diff for a commit, optionally relative to a specific base commit. Repeated `path` parameters narrow the diff to selected files or directories.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_commit_diff","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Branch, tag, or commit to diff. Provide `ref` or the deprecated `sha`.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use ref instead. Commit SHA to diff.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"sha","schema":{"type":"string"}},{"description":"Optional base branch, tag, or commit to diff against. When omitted, the diff is generated against the commit's parent. Provide `base_ref` or the deprecated `baseSha`.","example":"a4d39d7c79e819ab003fc78805954584e1ee36","in":"query","name":"base_ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use base_ref instead. Optional base commit SHA to diff against. When omitted, the diff is generated against the commit's parent.","example":"a4d39d7c79e819ab003fc78805954584e1ee36","in":"query","name":"baseSha","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","in":"query","name":"ref_is_ephemeral","schema":{"type":"boolean"}},{"description":"Whether `base_ref` should be resolved from the ephemeral namespace.","in":"query","name":"base_is_ephemeral","schema":{"type":"boolean"}},{"description":"Optional repeated path filter. Provide multiple `path` query values to restrict the diff to specific files or directories.","example":["src/main.go","README.md"],"in":"query","name":"path","schema":{"items":{"type":"string"},"type":"array"}},{"description":"When enabled, concatenate `files[].raw` in response order and apply the result against the selected base with `git apply`. Changes listed in `filtered_files` are not included in the patch. Defaults to false, preserving review-oriented whitespace suppression. Provide `git_apply_compatible` or the deprecated `gitApplyCompatible`.","example":false,"in":"query","name":"git_apply_compatible","schema":{"type":"boolean"}},{"deprecated":true,"description":"Deprecated: use git_apply_compatible instead. When enabled, concatenate `files[].raw` in response order and apply the result against the selected base with `git apply`. Changes listed in `filtered_files` are not included in the patch. Defaults to false, preserving review-oriented whitespace suppression.","example":false,"in":"query","name":"gitApplyCompatible","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"files":[{"bytes":2048,"is_eof":true,"path":"src/main.go","raw":"diff --git a/src/main.go b/src/main.go\n...","state":"M"}],"filtered_files":[{"bytes":50000,"is_eof":true,"path":"package-lock.json","state":"M"}],"merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","stats":{"additions":50,"changes":60,"deletions":10,"files":3}},"schema":{"additionalProperties":false,"description":"Diff for a single commit, including merge base when applicable, aggregate stats, and per-file changes.","properties":{"files":{"description":"Files returned with inline diff content.","items":{"additionalProperties":false,"description":"Per-file diff entry including the raw unified diff text.","properties":{"additions":{"description":"Added lines in this file.","format":"int64","type":"integer"},"bytes":{"description":"File size in bytes.","examples":[2048],"format":"int64","type":"integer"},"deletions":{"description":"Deleted lines in this file.","format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames).","examples":["src/main.go"],"type":"string"},"raw":{"description":"Raw unified diff content.","examples":["diff --git a/src/main.go b/src/main.go\n..."],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","raw","bytes","is_eof","additions","deletions"],"type":"object"},"type":"array"},"filtered_files":{"description":"Files filtered out of inline diff output because of size or file-type rules.","items":{"additionalProperties":false,"description":"Per-file diff entry that was excluded from inline diff output because of size or file-type rules.","properties":{"bytes":{"description":"File size in bytes.","examples":[50000],"format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames). Excluded from inline diff content because of size or file-type rules.","examples":["package-lock.json"],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","bytes","is_eof"],"type":"object"},"type":"array"},"merge_base_sha":{"description":"Merge base SHA used for explicit baseSha three-dot comparisons. Empty for single-commit diffs.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"sha":{"description":"The commit SHA to diff.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"stats":{"additionalProperties":false,"description":"Aggregate diff statistics.","properties":{"additions":{"description":"Total added lines across the diff.","examples":[50],"format":"int64","type":"integer"},"changes":{"description":"Total line changes (additions plus deletions).","examples":[60],"format":"int64","type":"integer"},"deletions":{"description":"Total deleted lines across the diff.","examples":[10],"format":"int64","type":"integer"},"files":{"description":"Number of files changed.","examples":[3],"format":"int64","type":"integer"}},"required":["files","additions","deletions","changes"],"type":"object"}},"required":["sha","stats","files","filtered_files"],"type":"object"}}},"description":"Full diff for the requested commit, including file-level stats, line-level hunks, and merge base for explicit base comparisons."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Commit Diff","tags":["Commits"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/diff-commit":{"post":{"description":"Create a commit by streaming a Git patch instead of individual file blobs. Use this when your workflow already produces unified diffs or generated patches.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"diff_commit","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"expected_target_sha\":\"d34db33fd34db33fd34db33fd34db33fd34db33f\",\"commit_message\":\"Apply generated patch\",\"author\":{\"name\":\"Diff Bot\",\"email\":\"diff@example.com\"}}}\n{\"diff_chunk\":{\"data\":\"ZGlmZiAtLWdpdCBhL1JFQURNRS5tZCBiL1JFQURNRS5tZAo=\",\"eof\":false}}\n{\"diff_chunk\":{\"data\":\"QEAgLTEsMSArMSwyIEBACi1IZWxsbworSGVsbG8gV29ybGQK\",\"eof\":true}}\n","schema":{"description":"NDJSON stream. The first line must be `metadata`; subsequent lines must be `diff_chunk` payloads. Decoded diff chunks are limited to 4 MiB each.","type":"string"}}},"description":"Send newline-delimited JSON where the first line is a `metadata` object and each following line is a `diff_chunk`. The combined diff must be compatible with `git apply --cached --binary`.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Commit created from the supplied diff."},"400":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"diff payload could not be decoded","new_sha":"","old_sha":"","status":"invalid_diff","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The NDJSON stream or diff payload was invalid."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"patch does not apply cleanly","new_sha":"","old_sha":"","status":"conflict","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The diff could not be applied cleanly or the target branch tip changed."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Commit from Diff","tags":["Commits"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/file":{"get":{"description":"Stream a file directly from the repository with byte ranges, ETag validators, and Last-Modified conditionals. Use `ref` to read from a branch, tag, or commit without cloning the repo locally.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_file","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Repository-relative file path to fetch.","example":"src/main.js","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to read from. When omitted, the repository default branch is used.","example":"v1.0.0","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Standard HTTP byte-range header (`bytes=\u003cstart\u003e-\u003cend\u003e`). Triggers a `206 Partial Content` response.","in":"header","name":"Range","schema":{"type":"string"}},{"description":"Conditional range request: when the supplied validator matches `ETag` or `Last-Modified`, the server returns `206 Partial Content`; otherwise the full body is returned with `200 OK`.","in":"header","name":"If-Range","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when the current `ETag` does not match.","in":"header","name":"If-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when the current `ETag` matches.","in":"header","name":"If-None-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when `Last-Modified` is on or before this date.","in":"header","name":"If-Modified-Since","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when `Last-Modified` is after this date.","in":"header","name":"If-Unmodified-Since","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"contentMediaType":"application/octet-stream","description":"Raw file bytes exactly as stored in the Git blob. No transcoding or encoding is applied.","format":"binary","type":"string"}}},"description":"File content returned.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"206":{"content":{"application/octet-stream":{"schema":{"contentMediaType":"application/octet-stream","description":"The requested slice of the raw file bytes. `Content-Range` identifies which bytes were served.","format":"binary","type":"string"}}},"description":"Byte range satisfied. Body contains only the requested bytes; `Content-Range` identifies the range.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"304":{"description":"Cached representation still valid. Returned when `If-None-Match` matches the current `ETag` or `If-Modified-Since` is on or after `Last-Modified`. Body is empty.","headers":{"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Precondition from `If-Match` or `If-Unmodified-Since` failed: the resource has changed since the validator the client supplied."},"416":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Requested byte range is outside the blob size."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get File","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"head":{"description":"Return file metadata headers for a repository file without streaming the file body. Supports byte ranges, ETag validators, and Last-Modified conditionals. Use `ref` to inspect a branch, tag, or commit without cloning the repo locally.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"head_file","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Repository-relative file path to fetch.","example":"src/main.js","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to read from. When omitted, the repository default branch is used.","example":"v1.0.0","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Standard HTTP byte-range header (`bytes=\u003cstart\u003e-\u003cend\u003e`). Triggers a `206 Partial Content` response.","in":"header","name":"Range","schema":{"type":"string"}},{"description":"Conditional range request: when the supplied validator matches `ETag` or `Last-Modified`, the server returns `206 Partial Content`; otherwise the full body is returned with `200 OK`.","in":"header","name":"If-Range","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when the current `ETag` does not match.","in":"header","name":"If-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when the current `ETag` matches.","in":"header","name":"If-None-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when `Last-Modified` is on or before this date.","in":"header","name":"If-Modified-Since","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when `Last-Modified` is after this date.","in":"header","name":"If-Unmodified-Since","schema":{"type":"string"}}],"responses":{"200":{"description":"File metadata headers returned. Body is empty.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"206":{"description":"Byte range satisfied. Body is empty; `Content-Range` identifies the range.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"304":{"description":"Cached representation still valid. Returned when `If-None-Match` matches the current `ETag` or `If-Modified-Since` is on or after `Last-Modified`. Body is empty.","headers":{"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Precondition from `If-Match` or `If-Unmodified-Since` failed: the resource has changed since the validator the client supplied."},"416":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Requested byte range is outside the blob size."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get File Headers","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/files":{"get":{"description":"List files or direct child entries at a branch, tag, or commit without cloning the repository. Each entry includes its path, Git mode, and derived type (`blob`, `tree`, `symlink`, or `submodule`). Trees no longer carry a trailing `/`; branch on `type` instead.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"list_files","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to list from. When omitted, the repository default branch is used.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Optional repository-relative subtree to list. Empty means the repository root.","example":"docs","in":"query","name":"path","schema":{"type":"string"}},{"description":"When true, include descendants recursively. When false, only direct children are returned.","example":false,"in":"query","name":"recursive","schema":{"type":"boolean"}},{"description":"Pagination cursor returned by a previous `list_files` response.","example":"docs/guide.md","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of paths to return. Defaults to 1000.","example":1000,"in":"query","name":"limit","schema":{"default":1000,"maximum":5000,"minimum":0,"type":"integer"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"entries":[{"mode":"100644","path":"src/main.go","type":"blob"}],"has_more":true,"next_cursor":"docs/guide.md","paths":["README.md"],"ref":"main"},"schema":{"additionalProperties":false,"description":"Paginated tree entries in the repository at the resolved revision.","properties":{"entries":{"description":"Tree entries for the resolved revision.","items":{"additionalProperties":false,"description":"Tree entry in a list-files response, including the repository-rooted path, six-digit Git mode, and derived type.","properties":{"mode":{"description":"Six-digit Git mode for the entry.","examples":["100644"],"type":"string"},"path":{"description":"Repository-rooted path.","examples":["src/main.go"],"type":"string"},"type":{"description":"Entry type: blob, tree, symlink, or submodule.","examples":["blob"],"type":"string"}},"required":["path","type","mode"],"type":"object"},"type":"array"},"has_more":{"description":"Whether another page of entries is available.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Cursor to resume pagination from. Empty when there are no more results.","examples":["docs/guide.md"],"type":"string"},"paths":{"description":"Flat blob-only path list. Mirrors the path of every entry whose type is \"blob\". Convenience shape for callers that just want file paths; use entries when you need type/mode.","examples":[["README.md"]],"items":{"description":"Repository-relative path used to scope the operation.","type":"string"},"type":"array"},"ref":{"description":"The resolved reference (branch name or commit SHA) that was used.","examples":["main"],"type":"string"}},"required":["entries","paths","ref","has_more"],"type":"object"}}},"description":"Tree entries for the resolved revision."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Files","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/files/metadata":{"get":{"description":"Return a recursive file tree together with per-file commit metadata in one request. Each file also includes a derived `type` field for symmetry with `/files`.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"list_files_metadata","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to list from. When omitted, the repository default branch is used.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Optional repository-relative subtree to list recursively. Empty means the repository root.","example":"docs","in":"query","name":"path","schema":{"type":"string"}},{"description":"Accepted for API symmetry. Metadata listings are recursive regardless of this flag.","example":true,"in":"query","name":"recursive","schema":{"type":"boolean"}},{"description":"Pagination cursor returned by a previous `list_files_with_metadata` response.","example":"docs/guide.md","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of files to return. Defaults to 200.","example":200,"in":"query","name":"limit","schema":{"default":200,"maximum":1000,"minimum":0,"type":"integer"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"files":[{"last_commit_sha":"a1b2c3d4e5f6","mode":"100644","path":"README.md","size":2048,"type":"blob"}],"has_more":true,"next_cursor":"docs/guide.md","ref":"main"},"schema":{"additionalProperties":false,"description":"Files in the repository at the resolved revision, each annotated with mode, type, and the latest commit that changed it.","properties":{"commits":{"additionalProperties":{"additionalProperties":false,"description":"Commit metadata shared by one or more files in a list-files-with-metadata response.","properties":{"author":{"description":"Author display name for the commit.","examples":["Jon Crosby"],"type":"string"},"date":{"description":"RFC 3339 author date for the commit.","examples":["2026-02-18T10:30:00Z"],"type":"string"},"message":{"description":"Commit message.","examples":["add list files with metadata endpoint"],"type":"string"}},"required":["author","date","message"],"type":"object"},"description":"Commit metadata keyed by last_commit_sha so repeated commits are only sent once.","type":"object"},"files":{"description":"Files in the resolved revision, each annotated with the latest commit that changed it.","items":{"additionalProperties":false,"description":"File entry in a list-files-with-metadata response, including mode, type, and the SHA of the most recent commit that touched it.","properties":{"last_commit_sha":{"description":"Commit SHA of the most recent commit that touched this file.","examples":["a1b2c3d4e5f6"],"type":"string"},"mode":{"description":"File mode as stored in Git, for example 100644.","examples":["100644"],"type":"string"},"path":{"description":"Repository-relative file path.","examples":["README.md"],"type":"string"},"size":{"description":"File size in bytes.","examples":[2048],"format":"int64","type":"integer"},"type":{"description":"Derived file type: blob, tree, symlink, or submodule.","examples":["blob"],"type":"string"}},"required":["path","mode","type","size","last_commit_sha"],"type":"object"},"type":"array"},"has_more":{"description":"Whether another page of files is available.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Cursor to resume pagination from. Empty when there are no more results.","examples":["docs/guide.md"],"type":"string"},"ref":{"description":"The resolved ref or commit used to generate the listing.","examples":["main"],"type":"string"}},"required":["files","commits","ref","has_more"],"type":"object"}}},"description":"The repository tree plus deduplicated commit metadata for the latest change touching each file."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Files with Metadata","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/git-credentials":{"post":{"description":"Create a stored HTTPS credential for a repository configured with a generic Git upstream.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"create_generic_git_credential","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"password":"glpat_xxxxxxxxxxxx","username":"git"},"schema":{"additionalProperties":false,"description":"Request body for storing a new HTTPS Git credential when the repository is identified via the URL path.","properties":{"password":{"description":"Password or access token for the upstream provider.","examples":["glpat_xxxxxxxxxxxx"],"type":"string"},"username":{"description":"Optional username for HTTPS authentication. Omit it for token-only providers.","examples":["git"],"type":"string"}},"required":["username","password"],"type":"object"}}},"description":"Store HTTPS credentials for a generic Git upstream such as GitLab, Bitbucket, Gitea, Forgejo, Codeberg, or SourceHut.","required":true},"responses":{"201":{"content":{"application/json":{"example":{"created_at":"2026-03-12T15:04:05Z","id":"ggc_1234567890abcdef"},"schema":{"additionalProperties":false,"description":"Stored Git credential summary returned after a credential is created or updated.","properties":{"created_at":{"description":"Credential creation timestamp in ISO 8601 format.","examples":["2026-03-12T15:04:05Z"],"type":"string"},"id":{"description":"Credential ID returned when the credential is created.","examples":["ggc_1234567890abcdef"],"type":"string"}},"required":["id"],"type":"object"}}},"description":"Credential created successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Git Credential","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-request-validation-profile":"create_generic_git_credential_by_path","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/git-credentials/{git_credential_id}":{"delete":{"description":"Delete a stored HTTPS credential for a generic Git upstream.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"delete_generic_git_credential","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Credential identifier.","example":"cred_01hs8z6j9m6v2m3v0x7g1h5n8q","in":"path","name":"git_credential_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Credential deleted successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Git Credential","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-requires-repo-scope":true,"x-stability":"stable"},"put":{"description":"Update a stored HTTPS credential for a generic Git upstream.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes","operationId":"update_generic_git_credential","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Credential identifier.","example":"cred_01hs8z6j9m6v2m3v0x7g1h5n8q","in":"path","name":"git_credential_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"password":"glpat_rotated_token","username":"git"},"schema":{"additionalProperties":false,"description":"Request body for rotating an existing HTTPS Git credential when the credential is identified via the URL path.","properties":{"password":{"description":"Updated password or access token for the upstream provider.","examples":["glpat_rotated_token"],"type":"string"},"username":{"description":"Optional username for HTTPS authentication. Omit for token-only providers.","examples":["git"],"type":"string"}},"required":["username","password"],"type":"object"}}},"description":"Rotate or replace an existing generic Git credential.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-03-12T15:04:05Z","id":"ggc_1234567890abcdef"},"schema":{"additionalProperties":false,"description":"Stored Git credential summary returned after a credential is created or updated.","properties":{"created_at":{"description":"Credential creation timestamp in ISO 8601 format.","examples":["2026-03-12T15:04:05Z"],"type":"string"},"id":{"description":"Credential ID returned when the credential is created.","examples":["ggc_1234567890abcdef"],"type":"string"}},"required":["id"],"type":"object"}}},"description":"Credential updated successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Update Git Credential","tags":["Repositories"],"x-permission-scopes":["repo:write"],"x-request-validation-profile":"update_generic_git_credential_by_path","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/grep":{"post":{"description":"Search a repository without cloning it. Results are paginated and can include surrounding context lines so downstream tools only fetch the relevant slices.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"grep","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"context":{"after":1,"before":0},"pagination":{"limit":50},"query":{"case_sensitive":true,"pattern":"ephemeral branches"},"rev":"main"},"schema":{"additionalProperties":false,"description":"Grep request describing the pattern, ref, filters, limits, and pagination for a repository content search.","properties":{"context":{"additionalProperties":false,"description":"Lines of context to include before and after each match.","properties":{"after":{"description":"Number of lines to include after each match.","examples":[1],"format":"int32","type":"integer"},"before":{"description":"Number of lines to include before each match.","examples":[0],"format":"int32","type":"integer"}},"type":"object"},"ephemeral":{"description":"Whether ref should be resolved from the ephemeral namespace.","type":"boolean"},"file_filters":{"additionalProperties":false,"description":"Optional include and exclude filters applied before matching.","properties":{"exclude_globs":{"description":"Glob patterns for files to exclude.","items":{"description":"Glob pattern such as `node_modules/**`.","type":"string"},"type":"array"},"extension_filters":{"description":"File extensions to filter by (e.g. [\".js\", \".py\"]).","items":{"description":"File extension to match, including the leading dot (e.g. `.js`).","type":"string"},"type":"array"},"include_globs":{"description":"Glob patterns for files to include.","items":{"description":"Glob pattern such as `src/**/*.go`.","type":"string"},"type":"array"}},"type":"object"},"limits":{"additionalProperties":false,"description":"Maximum line and per-file match limits.","properties":{"max_lines":{"description":"Maximum total lines to return (default 2000, max 2000).","format":"int32","type":"integer"},"max_matches_per_file":{"description":"Maximum matches returned per file (default 200).","format":"int32","type":"integer"}},"type":"object"},"pagination":{"additionalProperties":false,"description":"Cursor-based pagination controls for large result sets.","properties":{"cursor":{"description":"Pagination cursor returned by a previous grep response.","type":"string"},"limit":{"description":"Maximum number of matches to return (default 200).","examples":[50],"format":"int32","type":"integer"}},"type":"object"},"paths":{"description":"Optional path prefixes used to narrow the search before pattern matching.","items":{"description":"Repository-relative path used to scope the operation.","type":"string"},"type":"array"},"query":{"additionalProperties":false,"description":"Pattern configuration.","properties":{"case_sensitive":{"default":true,"description":"Defaults to true when omitted.","examples":[true],"type":"boolean"},"pattern":{"description":"Regular expression or literal pattern to search for.","examples":["ephemeral branches"],"type":"string"}},"required":["pattern"],"type":"object"},"ref":{"description":"Preferred branch, tag, or commit to search.","type":"string"},"rev":{"deprecated":true,"description":"Deprecated: use ref. Legacy ref field retained for backwards compatibility.","examples":["main"],"type":"string"}},"required":["query"],"type":"object"}}},"description":"Search repository contents by pattern. Optional file filters, context lines, and pagination let you retrieve only the relevant slices for agents and tools.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"incomplete_results":false,"matches":[{"path":"app/blog/markdown/ephemeral-branches.md"}],"query":{"case_sensitive":true,"pattern":"ephemeral branches"},"repo":{"commit":"b003fc78805954584e1ee364a4ad39d7c79e819a","ref":"main"}},"schema":{"additionalProperties":false,"description":"Grep results grouped per file, including the resolved ref and pagination state.","properties":{"has_more":{"description":"Whether additional matches remain.","examples":[true],"type":"boolean"},"incomplete_results":{"description":"True when the result set is incomplete because the server-side output cap was reached. Matches beyond the cap exist in the repo but cannot be retrieved by paging: narrow the query (pattern, paths, file filters) or raise max_lines if it was set below the maximum. next_cursor still pages through everything collected below the cap.","examples":[false],"type":"boolean"},"matches":{"description":"Files that matched the query, each with matching and context lines.","items":{"additionalProperties":false,"description":"Matches grouped under a single file path.","properties":{"lines":{"description":"Lines returned for the match, including optional context lines.","items":{"additionalProperties":false,"description":"Single line returned by grep, either a match or a surrounding context line.","properties":{"line_number":{"description":"Line number in the file.","format":"int32","type":"integer"},"text":{"description":"Line text content.","type":"string"},"type":{"description":"match for lines satisfying the pattern, or context for surrounding context lines.","type":"string"}},"required":["line_number","text","type"],"type":"object"},"type":"array"},"path":{"description":"Repository-relative file path that matched.","examples":["app/blog/markdown/ephemeral-branches.md"],"type":"string"}},"required":["path","lines"],"type":"object"},"type":"array"},"next_cursor":{"description":"Opaque cursor for the next page, if any.","type":["string","null"]},"query":{"additionalProperties":false,"description":"The effective query settings used by the server.","properties":{"case_sensitive":{"description":"Echoed case-sensitivity setting.","examples":[true],"type":"boolean"},"pattern":{"description":"Echoed pattern that was searched.","examples":["ephemeral branches"],"type":"string"}},"required":["pattern","case_sensitive"],"type":"object"},"repo":{"additionalProperties":false,"description":"Resolved repository ref and commit used for the search.","properties":{"commit":{"description":"Resolved commit SHA the grep ran against.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"ref":{"description":"Ref that was grepped.","examples":["main"],"type":"string"}},"required":["ref","commit"],"type":"object"}},"required":["query","repo","matches","next_cursor","has_more","incomplete_results"],"type":"object"}}},"description":"Search results for the requested pattern.","headers":{"X-Cache":{"description":"Indicates grep cache status (`HIT` or `MISS`).","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Grep","tags":["Files"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/merge":{"post":{"description":"Merge changes between branches without cloning the repository or shelling out to Git. This endpoint also supports promoting work from ephemeral branches into long-lived branches such as `main`. Omit `expected_target_sha` to merge into the current target tip and allow the gateway to retry stale target/repository movement internally; set `expected_target_sha` to require a strict target-tip precondition. GitHub-backed public targets currently do not use automatic retry.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"merge_branch","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"commit_message":"Merge feature/preview","expected_target_sha":"c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2","source_branch":"feature/preview","source_is_ephemeral":true,"source_ref":"feature/preview","squash":false,"strategy":"merge","target_branch":"main"},"schema":{"additionalProperties":false,"description":"Merge request body specifying source and target branches, optional pinned source SHA, merge strategy, optional squash flag, and optional retry-on-target-move behavior, which is currently unsupported for GitHub-backed public targets.","properties":{"allow_unrelated_histories":{"description":"Permit merges between unrelated histories.","type":"boolean"},"author":{"additionalProperties":false,"description":"Author identity used when the backend creates a merge commit. Required for merge-commit strategies.","properties":{"email":{"description":"Email address for the signature.","type":"string"},"name":{"description":"Display name for the signature.","type":"string"}},"required":["name","email"],"type":"object"},"commit_message":{"description":"Commit message used when a merge commit is created.","examples":["Merge feature/preview"],"type":"string"},"committer":{"additionalProperties":false,"description":"Committer identity for the merge commit. Defaults to author when omitted.","properties":{"email":{"description":"Email address for the signature.","type":"string"},"name":{"description":"Display name for the signature.","type":"string"}},"required":["name","email"],"type":"object"},"expected_target_sha":{"description":"Optional branch tip guard. The merge fails if the target has moved since this SHA.","examples":["c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"],"type":"string"},"source_branch":{"deprecated":true,"description":"Deprecated: use source_ref. Source branch to merge from.","examples":["feature/preview"],"type":"string"},"source_is_ephemeral":{"description":"Whether source_ref should be resolved from the ephemeral namespace.","examples":[true],"type":"boolean"},"source_ref":{"description":"Branch or refs/heads ref to merge from. The merge reads the source and never updates it. Provide source_ref or the deprecated source_branch.","examples":["feature/preview"],"type":"string"},"squash":{"description":"When true, collapse the source into a single new commit whose only parent is the current target tip. Defaults to false, which preserves the standard merge/fast-forward behavior. Incompatible with the ff_only strategy.","examples":[false],"type":"boolean"},"strategy":{"description":"Merge strategy. merge creates a merge commit when needed, ff_only rejects non-fast-forward merges, and ff_prefer fast-forwards when possible before falling back to a merge commit.","enum":["merge","ff_only","ff_prefer"],"examples":["merge"],"type":"string"},"target_branch":{"description":"Destination branch to update. A merge always updates a branch.","examples":["main"],"type":"string"},"target_is_ephemeral":{"description":"Whether target_branch should be resolved from the ephemeral namespace.","type":"boolean"}},"required":["target_branch","strategy"],"type":"object"}}},"description":"Merge a source branch into a target branch using a merge commit, fast-forward only, or fast-forward preferred behaviour. Source and target can live in the default or ephemeral namespace. When expected_target_sha is omitted, the gateway may retry stale target updates internally while keeping the originally resolved source commit pinned. Automatic stale-target retry is disabled for GitHub-backed public targets.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"commit_sha":"41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84","merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","promoted_commits":3,"result":"merged","source":{"branch":"feature/preview","ephemeral":true,"ref":"feature/preview","sha":"9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1"},"target":{"branch":"main","new_sha":"41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84","old_sha":"c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"},"tree_sha":"b9532c5d5be50d88e2f45d7c229566b2f1f99731"},"schema":{"additionalProperties":false,"description":"Merge outcome including the resulting commit, source and target state, merge base information, and retry attempt counters when applicable.","properties":{"commit_sha":{"description":"Commit SHA for the merge result. For a fast-forward or no-op, this is the resulting target tip.","examples":["41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84"],"type":"string"},"merge_base_sha":{"description":"Merge base SHA when one exists and the backend reports it.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"promoted_commits":{"description":"Number of commits promoted from source onto target.","examples":[3],"format":"int32","minimum":0,"type":"integer"},"result":{"description":"Merge outcome: merge_commit, fast_forward, no_op, squash, or unknown.","examples":["merged"],"type":"string"},"source":{"additionalProperties":false,"description":"Source ref metadata with branch, ephemeral, and resolved sha.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use ref. Source branch name.","examples":["feature/preview"],"type":"string"},"ephemeral":{"description":"Whether the source ref was resolved under the ephemeral namespace.","examples":[true],"type":"boolean"},"ref":{"description":"The source ref the merge reads.","examples":["feature/preview"],"type":"string"},"sha":{"description":"Resolved source SHA.","examples":["9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1"],"type":"string"}},"required":["ref","branch","ephemeral","sha"],"type":"object"},"target":{"additionalProperties":false,"description":"Target ref metadata with branch, ephemeral, previous old_sha, and resulting new_sha.","properties":{"branch":{"description":"Target branch name.","examples":["main"],"type":"string"},"ephemeral":{"description":"Whether the target ref was resolved under the ephemeral namespace.","type":"boolean"},"new_sha":{"description":"New target tip SHA after the merge.","examples":["41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84"],"type":"string"},"old_sha":{"description":"Previous target tip SHA before the merge.","examples":["c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"],"type":"string"}},"required":["branch","ephemeral","old_sha","new_sha"],"type":"object"},"tree_sha":{"description":"Tree SHA for the resulting commit or target tip.","examples":["b9532c5d5be50d88e2f45d7c229566b2f1f99731"],"type":"string"}},"required":["result","commit_sha","tree_sha","source","target","promoted_commits"],"type":"object"}}},"description":"Merge result, including the source and target commit state after the operation."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"conflict_type":"merge_conflict","error":"merge conflict"},"schema":{"additionalProperties":false,"properties":{"conflict_paths":{"description":"Repository paths that conflicted during the merge.","items":{"type":"string"},"type":"array"},"conflict_type":{"description":"Machine-readable conflict type: merge_conflict, target_moved, or repo_changed.","examples":["merge_conflict"],"type":"string"},"error":{"description":"High-level conflict result.","examples":["merge conflict"],"type":"string"},"merge_base_sha":{"description":"Merge base SHA used when the conflict was calculated.","type":"string"}},"required":["error"],"type":"object"}}},"description":"The merge could not be completed because of file-level conflicts, or an automatic stale-target retry could not absorb concurrent target/repository movement. Inspect conflict_type to distinguish merge_conflict, target_moved, and repo_changed."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Merge Branch","tags":["Branches"],"x-permission-scopes":["git:write"],"x-request-validation-profile":"merge_branch","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/merge/preview":{"get":{"description":"Preview merge conflicts without creating commits, updating refs, or touching a working tree. When requested, conflict content is rendered from Git objects produced in request-local scratch storage.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"preview_merge","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Source branch to merge from.","example":"feature/preview","in":"query","name":"source_branch","required":true,"schema":{"type":"string"}},{"description":"Destination branch to preview merging into.","example":"main","in":"query","name":"target_branch","required":true,"schema":{"type":"string"}},{"description":"Whether `source_branch` should be resolved from the ephemeral namespace.","in":"query","name":"source_is_ephemeral","schema":{"type":"boolean"}},{"description":"Whether `target_branch` should be resolved from the ephemeral namespace.","in":"query","name":"target_is_ephemeral","schema":{"type":"boolean"}},{"description":"When true, include bounded conflict content in the response.","example":true,"in":"query","name":"include_content","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"conflicts":[{"base":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false},"ours":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false},"path":"docs/conflict.txt","result":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false},"theirs":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false}}],"filtered_conflicts":[{"path":"src/app.ts","reason":"max_conflict_files_exceeded"}],"merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","result":"merge_commit","source_branch":"feature/preview","source_tip_sha":"9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1","status":"conflicted","target_branch":"main","target_tip_sha":"c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"},"schema":{"additionalProperties":false,"description":"Read-only merge preview result, including clean or conflicted status and optional inline conflict content.","properties":{"conflict_paths":{"description":"Repository paths that conflicted during the merge preview.","items":{"type":"string"},"type":"array"},"conflicts":{"description":"Inline conflict content, populated only when include_content=true.","items":{"additionalProperties":false,"description":"Inline conflict content for a single conflicted repository path.","properties":{"base":{"additionalProperties":false,"description":"Base stage blob.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"},"ours":{"additionalProperties":false,"description":"Target branch stage blob.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"},"path":{"description":"Repository path for this conflict.","examples":["docs/conflict.txt"],"type":"string"},"result":{"additionalProperties":false,"description":"Best-effort merged blob content, usually with conflict markers for text conflicts.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"},"theirs":{"additionalProperties":false,"description":"Source branch stage blob.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"}},"required":["path","result","base","ours","theirs"],"type":"object"},"type":"array"},"filtered_conflicts":{"description":"Conflicts omitted from inline content because of request or server limits.","items":{"additionalProperties":false,"description":"Conflict omitted from inline content because of request or server limits.","properties":{"path":{"description":"Repository path omitted from inline conflict content.","examples":["src/app.ts"],"type":"string"},"reason":{"description":"Reason the conflict content was omitted.","examples":["max_conflict_files_exceeded"],"type":"string"}},"required":["path","reason"],"type":"object"},"type":"array"},"merge_base_sha":{"description":"Merge base SHA used for the preview.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"result":{"description":"Operation result if applied: merge_commit, fast_forward, or no_op.","enum":["merge_commit","fast_forward","no_op"],"examples":["merge_commit"],"type":"string"},"source_branch":{"description":"Source branch requested by the caller.","examples":["feature/preview"],"type":"string"},"source_tip_sha":{"description":"Resolved source branch tip SHA.","examples":["9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1"],"type":"string"},"status":{"description":"Preview status: clean or conflicted.","enum":["clean","conflicted"],"examples":["conflicted"],"type":"string"},"target_branch":{"description":"Target branch requested by the caller.","examples":["main"],"type":"string"},"target_tip_sha":{"description":"Resolved target branch tip SHA.","examples":["c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"],"type":"string"}},"required":["status","result","source_branch","target_branch","source_tip_sha","target_tip_sha","conflict_paths","conflicts"],"type":"object"}}},"description":"Merge preview result. Conflicted previews return HTTP 200 with `status=conflicted`; request and storage failures use normal HTTP errors."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Preview Merge","tags":["Branches"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/notes":{"delete":{"description":"Remove the Git note attached to a commit or other Git object SHA.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"notes_delete","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"author":{"email":"review@example.com","name":"Review Bot"},"notes_ref":"refs/notes/commits","object_ref":"b003fc78805954584e1ee364a4ad39d7c79e819a","ref":"refs/notes/commits","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"},"schema":{"additionalProperties":false,"description":"Notes write request describing the commit, the action (`add`, `append`, or `remove`), the note content, and optional concurrency guard.","properties":{"action":{"default":"add","description":"add creates a note and fails if one already exists. append adds new text to the existing note body.","type":"string"},"author":{"additionalProperties":false,"description":"Author object with name and email for the notes commit.","properties":{"email":{"description":"Email address for the notes commit signature.","examples":["review@example.com"],"type":"string"},"name":{"description":"Display name for the notes commit signature.","examples":["Review Bot"],"type":"string"}},"required":["name","email"],"type":"object"},"expected_notes_ref_sha":{"description":"Optional compare-and-swap guard for the notes ref. Provide expected_notes_ref_sha or the deprecated expected_ref_sha.","type":"string"},"expected_ref_sha":{"deprecated":true,"description":"Deprecated: use expected_notes_ref_sha. Optional compare-and-swap guard for the notes ref.","type":"string"},"note":{"description":"Plain-text note content. Required for add and append.","type":"string"},"notes_ref":{"description":"Optional notes ref to target. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.","examples":["refs/notes/commits"],"type":"string"},"object_ref":{"description":"Git object the note attaches to. A full object SHA today. Provide object_ref or the deprecated sha.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"ref":{"deprecated":true,"description":"Deprecated: use notes_ref. Optional notes ref to target.","examples":["refs/notes/commits"],"type":"string"},"sha":{"deprecated":true,"description":"Deprecated: use object_ref. Git object SHA to attach the note to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"type":"object"}}},"description":"Delete the Git note for the supplied SHA. Set `ref` to target a notes ref other than refs/notes/commits; a bare name like `reviews` is accepted and placed under refs/notes/. `note` and `action` are ignored for `DELETE` requests.","required":true},"responses":{"201":{"content":{"application/json":{"example":{"base_commit":"0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492","new_ref_sha":"3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55","notes_ref":"refs/notes/commits","result":{"status":"ok","success":true},"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","target_ref":"refs/notes/commits"},"schema":{"additionalProperties":false,"description":"Result of a notes write operation, including the resulting notes ref state.","properties":{"base_commit":{"description":"Previous notes ref commit SHA.","examples":["0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492"],"type":"string"},"new_ref_sha":{"description":"New notes ref SHA after the operation.","examples":["3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55"],"type":"string"},"notes_ref":{"description":"The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"},"result":{"additionalProperties":false,"description":"Operation result with success, status, and optional message.","properties":{"message":{"description":"Optional human-readable message.","type":"string"},"status":{"description":"Status code (e.g. ok).","examples":["ok"],"type":"string"},"success":{"description":"Whether the operation succeeded.","examples":[true],"type":"boolean"}},"required":["success","status"],"type":"object"},"sha":{"description":"The commit SHA the note is attached to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"target_ref":{"deprecated":true,"description":"Deprecated: use notes_ref. The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"}},"required":["sha","notes_ref","target_ref","new_ref_sha","result"],"type":"object"}}},"description":"Note removed from the notes ref."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Note","tags":["Notes"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"},"get":{"description":"Read the Git note attached to a commit or other Git object SHA. Notes let you store review status, handoff details, or other context without changing repository contents.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"notes_read","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Git object whose note should be fetched. A full object SHA today. Provide object_ref or the deprecated sha.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"object_ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use object_ref instead. Git object SHA whose note should be fetched.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"sha","schema":{"type":"string"}},{"description":"Optional notes ref to read from. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.","example":"refs/notes/commits","in":"query","name":"notes_ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use notes_ref instead. Optional notes ref to read from. Defaults to refs/notes/commits.","example":"refs/notes/commits","in":"query","name":"ref","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"note":"Reviewed. Ready for production.","ref_sha":"0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"},"schema":{"additionalProperties":false,"description":"A single Git note attached to a commit, including the current notes ref tip.","properties":{"note":{"description":"The note content.","examples":["Reviewed. Ready for production."],"type":"string"},"ref_sha":{"description":"Current SHA of the notes ref the note was read from.","examples":["0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492"],"type":"string"},"sha":{"description":"The commit SHA.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"required":["sha","note","ref_sha"],"type":"object"}}},"description":"The note stored for the requested Git object."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Note","tags":["Notes"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"post":{"description":"Attach text to a Git object without changing the repository contents. Use notes for review markers, internal decisions, or other lightweight context.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"notes_write","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"author":{"email":"review@example.com","name":"Review Bot"},"notes_ref":"refs/notes/commits","object_ref":"b003fc78805954584e1ee364a4ad39d7c79e819a","ref":"refs/notes/commits","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"},"examples":{"append_note":{"description":"Append new content to an existing note.","summary":"Append note","value":{"action":"append","author":{"email":"review@example.com","name":"Review Bot"},"note":"Deployment complete.","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"}},"create_note":{"description":"Create a new note on a commit.","summary":"Create note","value":{"action":"add","author":{"email":"review@example.com","name":"Review Bot"},"note":"Reviewed. Ready for production.","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"}}},"schema":{"additionalProperties":false,"description":"Notes write request describing the commit, the action (`add`, `append`, or `remove`), the note content, and optional concurrency guard.","properties":{"action":{"default":"add","description":"add creates a note and fails if one already exists. append adds new text to the existing note body.","type":"string"},"author":{"additionalProperties":false,"description":"Author object with name and email for the notes commit.","properties":{"email":{"description":"Email address for the notes commit signature.","examples":["review@example.com"],"type":"string"},"name":{"description":"Display name for the notes commit signature.","examples":["Review Bot"],"type":"string"}},"required":["name","email"],"type":"object"},"expected_notes_ref_sha":{"description":"Optional compare-and-swap guard for the notes ref. Provide expected_notes_ref_sha or the deprecated expected_ref_sha.","type":"string"},"expected_ref_sha":{"deprecated":true,"description":"Deprecated: use expected_notes_ref_sha. Optional compare-and-swap guard for the notes ref.","type":"string"},"note":{"description":"Plain-text note content. Required for add and append.","type":"string"},"notes_ref":{"description":"Optional notes ref to target. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.","examples":["refs/notes/commits"],"type":"string"},"object_ref":{"description":"Git object the note attaches to. A full object SHA today. Provide object_ref or the deprecated sha.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"ref":{"deprecated":true,"description":"Deprecated: use notes_ref. Optional notes ref to target.","examples":["refs/notes/commits"],"type":"string"},"sha":{"deprecated":true,"description":"Deprecated: use object_ref. Git object SHA to attach the note to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"type":"object"}}},"description":"Create or append a Git note for the supplied SHA. `add` fails if a note already exists; use `append` to extend one. When `action` is omitted the server behaves as though `add` was supplied. Set `ref` to target a notes ref other than refs/notes/commits; a bare name like `reviews` is accepted and placed under refs/notes/.","required":true},"responses":{"201":{"content":{"application/json":{"example":{"base_commit":"0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492","new_ref_sha":"3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55","notes_ref":"refs/notes/commits","result":{"status":"ok","success":true},"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","target_ref":"refs/notes/commits"},"schema":{"additionalProperties":false,"description":"Result of a notes write operation, including the resulting notes ref state.","properties":{"base_commit":{"description":"Previous notes ref commit SHA.","examples":["0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492"],"type":"string"},"new_ref_sha":{"description":"New notes ref SHA after the operation.","examples":["3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55"],"type":"string"},"notes_ref":{"description":"The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"},"result":{"additionalProperties":false,"description":"Operation result with success, status, and optional message.","properties":{"message":{"description":"Optional human-readable message.","type":"string"},"status":{"description":"Status code (e.g. ok).","examples":["ok"],"type":"string"},"success":{"description":"Whether the operation succeeded.","examples":[true],"type":"boolean"}},"required":["success","status"],"type":"object"},"sha":{"description":"The commit SHA the note is attached to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"target_ref":{"deprecated":true,"description":"Deprecated: use notes_ref. The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"}},"required":["sha","notes_ref","target_ref","new_ref_sha","result"],"type":"object"}}},"description":"Note update applied to the notes ref."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create or Append Note","tags":["Notes"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/notes/refs":{"get":{"description":"List Git notes refs under a notes ref prefix with cursor pagination. Use this to discover custom notes namespaces before reading individual notes.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"list_notes_refs","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Notes ref prefix to enumerate. A bare prefix like reviews is placed under refs/notes/; a fully-qualified refs/notes/* prefix is also accepted. Defaults to refs/notes/.","example":"reviews/","in":"query","name":"prefix","schema":{"type":"string"}},{"description":"Pagination cursor returned by a previous `list_notes_refs` response.","example":"refs/notes/reviews/session-b","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of notes refs to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"next_cursor":"refs/notes/reviews/session-b","prefix":"refs/notes/reviews/","refs":[{"cursor":"refs/notes/reviews/session-a","ref":"refs/notes/reviews/session-a","sha":"a1b2c3d4e5f6"}]},"schema":{"additionalProperties":false,"description":"Paginated list of Git notes refs under the requested prefix.","properties":{"has_more":{"description":"Whether more notes refs exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["refs/notes/reviews/session-b"],"type":"string"},"prefix":{"description":"Normalized notes ref prefix used for the listing.","examples":["refs/notes/reviews/"],"type":"string"},"refs":{"description":"List of notes refs.","items":{"additionalProperties":false,"description":"Git notes ref entry including its full ref name and current tip SHA.","properties":{"cursor":{"description":"Opaque pagination token for this notes ref entry.","examples":["refs/notes/reviews/session-a"],"type":"string"},"ref":{"description":"Full notes ref name.","examples":["refs/notes/reviews/session-a"],"type":"string"},"sha":{"description":"Current tip SHA stored in the notes ref.","examples":["a1b2c3d4e5f6"],"type":"string"}},"required":["cursor","ref","sha"],"type":"object"},"type":"array"}},"required":["refs","has_more","prefix"],"type":"object"}}},"description":"Notes refs in lexical order."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Notes Refs","tags":["Notes"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/pull-upstream":{"post":{"description":"Trigger a sync from the configured upstream for the repository in the JWT `repo` claim. This only works for repositories that were created with an upstream `base_repo`.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"pull_upstream","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"ref":"main"},"schema":{"additionalProperties":false,"description":"Optional parameters for triggering a sync from the configured upstream.","properties":{"after":{"description":"Optional opaque token from a previous pull-upstream response. Reserved for compatibility with future incremental syncs.","type":"string"},"ref":{"description":"Optional branch or tag to pull from the configured upstream. Defaults to the repository's tracked default branch.","examples":["main"],"type":"string"}},"type":"object"}}},"description":"Optional sync hints. Most callers can omit the body entirely and simply trigger the next upstream pull."},"responses":{"202":{"content":{"application/json":{"example":{"message":"Repository sync initiated successfully"},"schema":{"additionalProperties":false,"description":"Acknowledgement that an upstream sync has been initiated; the sync itself runs asynchronously.","properties":{"message":{"description":"Human-readable status message.","examples":["Repository sync initiated successfully"],"type":"string"}},"required":["message"],"type":"object"}}},"description":"Sync trigger accepted. The repository sync runs asynchronously."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Pull Upstream","tags":["Repositories"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/reset-commits":{"post":{"description":"Create a new commit that resets a branch back to a specific commit SHA while preserving normal Git history.\n\nThis is an alias of `restore-commit` and is served by the same handler; prefer `restore-commit` for new integrations. A successful reset responds with `201 Created`. Ref-level outcomes are reported in `result.status` and `result.success`, not by the status code alone, and failures raised by the restore itself come back in that same restore-result body. The problem-details schemas below describe gateway-level rejections such as `401`, `403` and `429`.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"reset_commits","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"base_ref\":\"abc123def4567890abc123def4567890abc123de\",\"expected_target_sha\":\"0123456789abcdef0123456789abcdef01234567\",\"commit_message\":\"Reset branch\",\"author\":{\"name\":\"Docs Bot\",\"email\":\"docs@example.com\"}}}\n","schema":{"description":"NDJSON stream containing one `metadata` object.","type":"string"}}},"description":"Send a single NDJSON metadata line describing the branch to restore and the commit SHA to restore it to. The handler requires this line and rejects an empty body with `400`, even though the published contract leaves it optional."},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Documented for backwards compatibility with clients written against the original `reset-commits` contract. Successful resets return `201 Created`; see the `201` response."},"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Restore commit created and the branch reset. This is the status a successful reset returns."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"example":{"commit":null,"result":{"branch":"","message":"branch already matches target commit","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Storage rejected the restore because the branch cannot move as requested: the branch already points at `base_ref`, the restore would produce no change, or `base_ref` is not an ancestor of the current tip. The body carries the restore result with `result.status` set to `precondition_failed`."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Reset Branch to Commit","tags":["Commits"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/restore-commit":{"post":{"description":"Create a new commit that resets a branch back to a specific commit SHA while preserving normal Git history.\n\nRef-level outcomes are reported in `result.status` and `result.success`, not by the status code alone, and failures raised by the restore itself come back in that same restore-result body. The problem-details schemas below describe gateway-level rejections such as `401`, `403` and `429`.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"restore_commit","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"base_ref\":\"abc123def4567890abc123def4567890abc123de\",\"expected_target_sha\":\"0123456789abcdef0123456789abcdef01234567\",\"commit_message\":\"Reset branch\",\"author\":{\"name\":\"Docs Bot\",\"email\":\"docs@example.com\"}}}\n","schema":{"description":"NDJSON stream containing one `metadata` object.","type":"string"}}},"description":"Send a single NDJSON metadata line describing the branch to restore and the commit SHA to restore it to.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Restore commit created successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"example":{"commit":null,"result":{"branch":"","message":"branch already matches target commit","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Storage rejected the restore because the branch cannot move as requested: the branch already points at `base_ref`, the restore would produce no change, or `base_ref` is not an ancestor of the current tip. The body carries the restore result with `result.status` set to `precondition_failed`."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Restore Commit","tags":["Commits"],"x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/tag":{"get":{"description":"Get one tag by its exact short name. The response returns the dereferenced commit SHA and omits internal fields.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"get_tag","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Exact short tag name.","example":"v1.0.0","in":"query","name":"name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"tag":{"name":"v1.0.0","sha":"a1b2c3d4e5f6"}},"schema":{"additionalProperties":false,"description":"One tag that matches an exact short name.","properties":{"tag":{"additionalProperties":false,"description":"The tag that has the requested name.","properties":{"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"},"sha":{"description":"Dereferenced commit SHA for the tag.","examples":["a1b2c3d4e5f6"],"type":"string"}},"required":["name","sha"],"type":"object"}},"required":["tag"],"type":"object"}}},"description":"The tag with the requested name."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Tag","tags":["Tags"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/tags":{"get":{"description":"List tags in lexical order with cursor pagination. The returned `sha` is the dereferenced commit SHA, even for annotated tags.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes","operationId":"list_tags","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Pagination cursor returned by a previous `list_tags` response.","example":"t_def456","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of tags to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"next_cursor":"t_def456","tags":[{"cursor":"t_abc123","name":"v1.0.0","sha":"a1b2c3d4e5f6"}]},"schema":{"additionalProperties":false,"description":"Paginated list of tags for the repository.","properties":{"has_more":{"description":"Whether more tags exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["t_def456"],"type":"string"},"tags":{"description":"List of tag objects.","items":{"additionalProperties":false,"description":"Tag summary entry.","properties":{"cursor":{"description":"Opaque pagination token for this tag entry.","examples":["t_abc123"],"type":"string"},"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"},"sha":{"description":"Dereferenced commit SHA for the tag.","examples":["a1b2c3d4e5f6"],"type":"string"}},"required":["cursor","name","sha"],"type":"object"},"type":"array"}},"required":["tags","has_more"],"type":"object"}}},"description":"Repository tags in lexical order."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Tags","tags":["Tags"],"x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"post":{"description":"Create a lightweight tag pointing to a specific commit. Annotated tags are not created through this endpoint.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes","operationId":"create_tag","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"name":"v1.0.0","ref":"main","target":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"},"schema":{"additionalProperties":false,"description":"Create-tag request body describing the new tag and the commit it points to.","properties":{"name":{"description":"Tag name. Must be a valid Git ref name and must not start with refs/.","examples":["v1.0.0"],"type":"string"},"ref":{"description":"Branch, tag, or commit the tag should point to. Provide ref or the deprecated target.","examples":["main"],"type":"string"},"target":{"deprecated":true,"description":"Deprecated: use ref. Commit the tag should point to.","examples":["a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"],"type":"string"}},"required":["name"],"type":"object"}}},"description":"Create a lightweight tag that points to an exact commit SHA.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"message":"tag created","name":"v1.0.0","sha":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"},"schema":{"additionalProperties":false,"description":"Result of creating a tag.","properties":{"message":{"description":"Human-readable result message.","examples":["tag created"],"type":"string"},"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"},"sha":{"description":"Commit SHA the tag points to.","examples":["a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"],"type":"string"}},"required":["name","sha","message"],"type":"object"}}},"description":"Tag creation result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Tag","tags":["Tags"],"x-permission-scopes":["git:write"],"x-request-validation-profile":"create_tag","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/repos/{repo_name}/tags/{tag_name}":{"delete":{"description":"Delete a tag from the repository. The server resolves the stored ref correctly for both lightweight and annotated tags.\n#### JWT claims\nRequired scopes: `git:read`, `git:write`  \nRequires per repo scope: Yes","operationId":"delete_tag","parameters":[{"description":"Repository name. Names that contain `/` or any other character that is not safe in a URL path segment must be URL encoded so the value occupies a single path segment. For example `pierre/example` is sent as `pierre%2Fexample`. Plain names such as `example` can be sent as-is. The server URL-decodes the value before resolving the repository.","example":"my-demo-repository","in":"path","name":"repo_name","required":true,"schema":{"type":"string"}},{"description":"Tag name.","example":"v1.0.0","in":"path","name":"tag_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"message":"tag deleted","name":"v1.0.0"},"schema":{"additionalProperties":false,"description":"Result of deleting a tag.","properties":{"message":{"description":"Human-readable result message.","examples":["tag deleted"],"type":"string"},"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"}},"required":["name","message"],"type":"object"}}},"description":"Tag deletion result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Tag","tags":["Tags"],"x-permission-scopes":["git:read","git:write"],"x-request-validation-profile":"delete_tag_by_path","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repo":{"get":{"deprecated":true,"description":"Fetch repository metadata for the repository identified by the JWT `repo` claim.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}` instead.","operationId":"get_repo_legacy","responses":{"200":{"content":{"application/json":{"example":{"base_repo":{"name":"Hello-World","owner":"octocat","provider":"github"},"created_at":"2024-01-15T10:30:00Z","default_branch":"main","repo_id":"repo_7f2b3d9","repo_name":"team/project-alpha","url":"team/project-alpha"},"schema":{"additionalProperties":false,"description":"Detailed view of a single repository, including any Git Sync configuration.","properties":{"base_repo":{"additionalProperties":false,"description":"Git Sync configuration (if configured).","properties":{"name":{"description":"Upstream repository name.","examples":["Hello-World"],"type":"string"},"owner":{"description":"Upstream repository owner or namespace.","examples":["octocat"],"type":"string"},"provider":{"description":"Upstream provider name.","examples":["github"],"type":"string"}},"required":["provider"],"type":"object"},"created_at":{"description":"ISO 8601 creation timestamp.","examples":["2024-01-15T10:30:00Z"],"type":"string"},"default_branch":{"description":"Default branch name.","examples":["main"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["team/project-alpha"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["team/project-alpha"],"type":"string"}},"required":["repo_id","repo_name","url","default_branch","created_at"],"type":"object"}}},"description":"Repository metadata resolved from the JWT `repo` claim."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Repo","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"patch":{"deprecated":true,"description":"Change the default branch of the repository identified by the JWT `repo` claim.\n\nThe gateway reads the current `HEAD` symbolic ref, then repoints it at the requested branch through a transactional compare-and-swap against that value, and finally records the new default branch in the repository row. Branch names are fully qualified for you: `main` is written as the symref target `refs/heads/main`, and a value that already starts with `refs/` is used verbatim. The branch itself is not created by this call.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}` instead.","operationId":"update_repo_legacy","requestBody":{"content":{"application/json":{"example":{"default_branch":"main"},"schema":{"additionalProperties":false,"description":"Repository settings to patch, such as the default branch.","properties":{"default_branch":{"description":"New default branch name for the Code Storage repository.","examples":["main"],"type":"string"}},"type":"object"}}},"description":"Repository settings to change. `default_branch` is the only supported field and must be a non-empty branch name.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"default_branch":"main","id":"repo_7f2b3d9","repo_id":"repo_7f2b3d9","repo_name":"pierre/sdk-documentation","url":"pierre/sdk-documentation"},"schema":{"additionalProperties":false,"description":"Repository state after applying the patch.","properties":{"default_branch":{"description":"Updated default branch name.","examples":["main"],"type":"string"},"id":{"deprecated":true,"description":"Deprecated: use repo_id. Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["pierre/sdk-documentation"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["pierre/sdk-documentation"],"type":"string"}},"required":["repo_id","id","repo_name","url","default_branch"],"type":"object"}}},"description":"Default branch updated. Returns the repository ID, its URL path, and the branch name now recorded as the default."},"400":{"content":{"application/json":{"example":{"detail":"default_branch is required","error":"default_branch is required","instance":"/api/repos/my-demo-repository","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"default_branch is required","error":"default_branch is required","instance":"/api/repos/my-demo-repository","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The body could not be decoded as JSON, or `default_branch` was missing or empty."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"No repository matching the JWT `repo` claim exists for this organisation."},"409":{"content":{"application/json":{"example":{"detail":"default branch was modified concurrently, please retry","error":"default branch was modified concurrently, please retry","instance":"/api/repos/my-demo-repository","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"default branch was modified concurrently, please retry","error":"default branch was modified concurrently, please retry","instance":"/api/repos/my-demo-repository","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"`HEAD` moved between the read and the compare-and-swap, so the update was rejected. Retry the request."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The current `HEAD` value could not be read from storage, so no compare-and-swap was attempted and nothing was changed."}},"security":[{"bearerAuth":[]}],"summary":"Update Repository Settings","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}` instead.","x-permission-scopes":["repo:write"],"x-request-validation-profile":"update_repo","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos":{"get":{"deprecated":true,"description":"List repositories for the current organisation with cursor-based pagination. Supply `q` to filter results by a case-insensitive substring match against the repository `url` (for example `pierre/sdk-documentation`).\n#### JWT claims\nRequired scopes: `org:read`  \nRequires per repo scope: No\n\nDeprecated: Use `/api/repos` instead.","operationId":"list_repos_legacy","parameters":[{"description":"Case-insensitive substring to match against the repository `url`. Trimmed before matching. When omitted or empty after trimming, the full repository list is returned.","example":"sdk","in":"query","name":"q","schema":{"type":"string"}},{"description":"Pagination cursor from previous response (base64 encoded)","example":"MTcwNzU3MzQ1MTAwMDAwMDAwMHxyZXBvXzlhNGMyMWY","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of repositories to return. Defaults to 20 and is capped at 100.","example":20,"in":"query","name":"limit","schema":{"default":20,"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"next_cursor":"MTcwNzU3MzQ1MTAwMDAwMDAwMHxyZXBvXzlhNGMyMWY","repos":[{"base_repo":{"name":"Hello-World","owner":"octocat","provider":"github"},"created_at":"2026-02-11T18:22:41Z","default_branch":"main","repo_id":"repo_7f2b3d9","repo_name":"pierre/sdk-documentation","url":"pierre/sdk-documentation"}]},"schema":{"additionalProperties":false,"description":"Paginated list of repositories for the current organisation.","properties":{"has_more":{"description":"Whether another page is available.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page, if any.","examples":["MTcwNzU3MzQ1MTAwMDAwMDAwMHxyZXBvXzlhNGMyMWY"],"type":"string"},"repos":{"description":"Repositories in the current page.","items":{"additionalProperties":false,"description":"Repository summary entry.","properties":{"base_repo":{"additionalProperties":false,"description":"Git Sync configuration (if configured)","properties":{"name":{"description":"Upstream repository name.","examples":["Hello-World"],"type":"string"},"owner":{"description":"Upstream repository owner or namespace.","examples":["octocat"],"type":"string"},"provider":{"description":"Upstream provider name.","examples":["github"],"type":"string"}},"required":["provider"],"type":"object"},"created_at":{"description":"ISO 8601 creation timestamp","examples":["2026-02-11T18:22:41Z"],"type":"string"},"default_branch":{"description":"Default branch name","examples":["main"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["pierre/sdk-documentation"],"type":"string"},"url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["pierre/sdk-documentation"],"type":"string"}},"required":["repo_id","repo_name","url","default_branch","created_at"],"type":"object"},"type":"array"}},"required":["repos","has_more"],"type":"object"}}},"description":"A paginated view of repositories in the organisation."},"400":{"content":{"application/json":{"example":{"detail":"invalid cursor","error":"invalid cursor","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"invalid cursor","error":"invalid cursor","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The supplied pagination cursor could not be decoded."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Repos","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos` instead.","x-permission-scopes":["org:read"],"x-requires-repo-scope":false,"x-stability":"stable"},"post":{"deprecated":true,"description":"Create a repository using the repo name embedded in the JWT. You can start empty, mirror an upstream repository, or fork another Code Storage repository into a new independent repo.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos` instead.","operationId":"create_repo_legacy","parameters":[{"description":"Optional default branch override. When present, it is used if the request body does not already specify one.","example":"main","in":"query","name":"default_branch","schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"example":{"default_branch":"main"},"examples":{"empty_repo":{"description":"Create a new repository with an explicit default branch.","summary":"Empty repository","value":{"default_branch":"main"}},"fork":{"description":"Create an independent repository by cloning another Code Storage repo at a chosen ref.","summary":"Internal fork","value":{"base_repo":{"auth":{"auth_type":"jwt","token":"BASE_REPO_READ_TOKEN"},"name":"sdk-documentation","operation":"fork","owner":"pierre","provider":"code.storage","ref":"main"},"default_branch":"feature-preview"}},"generic_git_sync":{"description":"Mirror a repository from a generic HTTPS Git provider such as GitLab, Bitbucket, Gitea, or Forgejo.","summary":"Generic HTTPS Git sync","value":{"base_repo":{"default_branch":"main","name":"repo-name","owner":"org-name","provider":"gitea","upstream_host":"git.example.com"},"default_branch":"main"}},"public_github_sync":{"description":"Mirror a public GitHub repository without an app installation.","summary":"Public GitHub sync","value":{"base_repo":{"auth":{"auth_type":"public"},"default_branch":"main","name":"hello-world","owner":"octocat","provider":"github"}}}},"schema":{"additionalProperties":false,"description":"Create-repository request body. The repository identity comes from the JWT `repo` claim; the body supplies optional default-branch and Git Sync or fork configuration.","properties":{"base_repo":{"additionalProperties":false,"description":"Optional upstream or fork source configuration.","properties":{"auth":{"additionalProperties":false,"description":"Authentication used to read the base repository when needed.","properties":{"auth_type":{"description":"Use public for public GitHub sync or jwt for internal forks.","enum":["public","jwt"],"type":"string"},"token":{"description":"JWT granting read access to the base repository for fork operations.","type":"string"}},"type":"object"},"default_branch":{"description":"Default branch to track for sync-backed repositories.","type":"string"},"name":{"description":"Repository name on the upstream provider.","type":"string"},"operation":{"default":"sync","description":"sync mirrors an upstream provider. fork clones another Code Storage repository into a new independent repo.","enum":["sync","fork"],"type":"string"},"owner":{"description":"Repository owner or namespace on the upstream provider.","type":"string"},"provider":{"description":"Upstream provider, such as github, gitlab, or code.storage for forks.","enum":["github","gitlab","bitbucket","gitea","forgejo","codeberg","sr.ht","sourcehut","code.storage"],"type":"string"},"ref":{"description":"Branch or tag to fork from. Ignored when sha is supplied.","type":"string"},"sha":{"description":"Exact commit to fork from. Overrides ref when both are set.","type":"string"},"upstream_host":{"description":"Bare hostname for self-hosted providers, such as gitlab.example.com.","type":"string"}},"required":["provider","owner","name","default_branch"],"type":"object"},"default_branch":{"description":"Default branch for the new repository. Defaults to main when omitted.","examples":["main"],"type":"string"}},"type":"object"}}},"description":"Create either an empty repository, a synced repository backed by an upstream provider, or a fork of another Code Storage repository."},"responses":{"200":{"content":{"application/json":{"example":{"http_url":"pierre/sdk-documentation","message":"repository created","repo_id":"repo_7f2b3d9","repo_name":"pierre/sdk-documentation"},"schema":{"additionalProperties":false,"description":"Result of creating a repository, including the assigned internal repository ID and the repository URL path.","properties":{"http_url":{"deprecated":true,"description":"Deprecated: use repo_name. Repository name or path, not a full URL.","examples":["pierre/sdk-documentation"],"type":"string"},"message":{"description":"High-level creation result.","examples":["repository created"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"repo_name":{"description":"Repository name or path. It can contain a slash. It matches the JWT repo claim.","examples":["pierre/sdk-documentation"],"type":"string"}},"required":["repo_id","repo_name","http_url","message"],"type":"object"}}},"description":"Repository created successfully."},"400":{"content":{"application/json":{"example":{"detail":"unknown provider: example-host","error":"unknown provider: example-host","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"unknown provider: example-host","error":"unknown provider: example-host","instance":"/api/repos","status":400,"title":"Bad Request","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The repository name, base repository configuration, or upstream provider was invalid."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Repo","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos` instead.","x-permission-scopes":["repo:write"],"x-request-validation-profile":"create_repo","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/archive":{"post":{"deprecated":true,"description":"Download a repository snapshot without cloning the repo. This is useful for packaging docs, examples, or release artefacts directly from a branch, tag, or commit.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/archive` instead.","operationId":"archive_legacy","requestBody":{"content":{"application/json":{"examples":{"docs_snapshot":{"description":"Download just the docs tree with a prefixed root folder.","summary":"Filtered documentation snapshot","value":{"archive":{"prefix":"sdk-docs/"},"exclude_globs":["**/drafts/**"],"include_globs":["docs/**","README.md"],"ref":"main"}}},"schema":{"additionalProperties":false,"description":"Archive options describing the ref to snapshot and the include or exclude filters applied to the resulting tarball.","properties":{"archive":{"additionalProperties":false,"description":"Optional archive output settings.","properties":{"prefix":{"description":"Prefix to add to every file path inside the archive.","type":"string"}},"type":"object"},"exclude_globs":{"description":"Exclude files matching these glob patterns after include filtering.","items":{"description":"Glob pattern such as `node_modules/**`.","type":"string"},"type":"array"},"include_globs":{"description":"Only include files matching these glob patterns.","items":{"description":"Glob pattern such as `src/**/*.go`.","type":"string"},"type":"array"},"max_blob_size":{"description":"Maximum blob size to include in the archive, in bytes.","format":"int64","type":"integer"},"ref":{"description":"Branch, tag, or commit to archive. When omitted, the default branch or HEAD is used.","type":"string"}},"required":["ref"],"type":"object"}}},"description":"Request a `.tar.gz` snapshot of the repository at a branch, tag, or commit. Include and exclude globs let you shape the archive before it streams back."},"responses":{"200":{"content":{"application/gzip":{"schema":{"contentMediaType":"application/octet-stream","description":"Gzip-compressed tar archive stream.","format":"binary","type":"string"}}},"description":"A streamed `.tar.gz` archive of the resolved revision.","headers":{"Cache-Control":{"description":"Archive downloads are returned with `no-store`.","schema":{"type":"string"}},"Content-Disposition":{"description":"Attachment filename generated from the repository URL and resolved revision.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Archive","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/archive` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/base":{"delete":{"deprecated":true,"description":"Detach the repository from its configured upstream provider. The operation is idempotent: already-detached repositories return success.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/base` instead.","operationId":"unset_base_repo_legacy","responses":{"200":{"content":{"application/json":{"example":{"message":"repository detached"},"schema":{"additionalProperties":false,"description":"Confirmation that the upstream link has been detached from the repository.","properties":{"message":{"description":"Human-readable detach status message.","examples":["repository detached"],"type":"string"}},"required":["message"],"type":"object"}}},"description":"Upstream detach result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"message":"repository detached"},"schema":{"additionalProperties":false,"description":"Confirmation that the upstream link has been detached from the repository.","properties":{"message":{"description":"Human-readable detach status message.","examples":["repository detached"],"type":"string"}},"required":["message"],"type":"object"}}},"description":"The detach workflow is already in progress or the sync workflow is missing."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Unset Base Repo","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}/base` instead.","x-permission-scopes":["repo:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/blame":{"get":{"deprecated":true,"description":"Return per-line blame metadata for a file at a branch, tag, or commit. Supports `git blame -L`-style range filters and rename/copy detection for callers building IDE blame views or audit tooling.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/blame` instead.","operationId":"blame_legacy","parameters":[{"description":"Repository-relative file path to blame.","example":"src/main.go","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to blame at. When omitted, the repository default branch is used.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Optional `git blame -L`-style range spec. May be repeated to blame multiple regions (max 16). Each value is one `-L` argument: e.g. `10,20`, `10,+5`, `/getUser/,/^}/`, `/getUser/,+30`, `10,`, `,20`, `10`, `:^func .*Foo`, `:funcname`.","example":["10,20"],"in":"query","name":"range","schema":{"items":{"type":"string"},"type":"array"}},{"description":"Follow the file across renames and copies.","in":"query","name":"detect_moves","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"commit_sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","lines":[{"author_email":"jane@example.com","author_name":"Jane Doe","author_time":"2024-01-15T14:32:18Z","commit_sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","committer_email":"jane@example.com","committer_name":"Jane Doe","committer_time":"2024-01-15T14:32:18Z","line_number":42,"original_line_number":40,"original_path":"src/main.go","previous_commit_sha":"a4d39d7c79e819ab003fc78805954584e1ee36","summary":"fix: resolve scrolling issue in dashboard"}],"path":"src/main.go","ref":"main"},"schema":{"additionalProperties":false,"description":"Per-line blame information for the requested file at the resolved revision.","properties":{"commit_sha":{"description":"Commit SHA the blame was computed at.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"lines":{"description":"Per-line blame results in file order.","items":{"additionalProperties":false,"description":"Single blame entry describing the commit and author responsible for a line.","properties":{"author_email":{"description":"Author email of the commit that last touched this line.","examples":["jane@example.com"],"type":"string"},"author_name":{"description":"Author of the commit that last touched this line.","examples":["Jane Doe"],"type":"string"},"author_time":{"description":"Author timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"commit_sha":{"description":"Commit SHA that last touched this line.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"committer_email":{"description":"Committer email of the commit that last touched this line.","examples":["jane@example.com"],"type":"string"},"committer_name":{"description":"Committer of the commit that last touched this line.","examples":["Jane Doe"],"type":"string"},"committer_time":{"description":"Committer timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"line_number":{"description":"Line number in the current file.","examples":[42],"format":"int32","type":"integer"},"original_line_number":{"description":"Line number in the original file before any renames or moves.","examples":[40],"format":"int32","type":"integer"},"original_path":{"description":"Original repository-relative path the line was introduced at.","examples":["src/main.go"],"type":"string"},"previous_commit_sha":{"description":"Commit SHA prior to the current commit when known.","examples":["a4d39d7c79e819ab003fc78805954584e1ee36"],"type":"string"},"summary":{"description":"First line of the commit message.","examples":["fix: resolve scrolling issue in dashboard"],"type":"string"}},"required":["line_number","commit_sha","original_line_number","original_path","author_name","author_email","author_time","committer_name","committer_email","committer_time","summary"],"type":"object"},"type":"array"},"path":{"description":"Repository-relative file path that was blamed.","examples":["src/main.go"],"type":"string"},"ref":{"description":"Resolved ref used for the blame.","examples":["main"],"type":"string"}},"required":["ref","path","commit_sha","lines"],"type":"object"}}},"description":"Per-line blame for the resolved file revision."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Blame","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/blame` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/branches":{"delete":{"deprecated":true,"description":"Delete a branch from the repository. The default branch is protected and cannot be deleted through this endpoint.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/branches` instead.","operationId":"delete_branch_legacy","requestBody":{"content":{"application/json":{"example":{"ephemeral":false,"name":"feature/old-onboarding","target_branch":"feature/old-onboarding"},"schema":{"additionalProperties":false,"description":"Branch deletion request identifying the branch to remove.","properties":{"ephemeral":{"description":"Delete the branch from the ephemeral namespace instead of the default namespace.","examples":[false],"type":"boolean"},"name":{"deprecated":true,"description":"Deprecated: use target_branch. Branch name to delete.","examples":["feature/old-onboarding"],"type":"string"},"target_branch":{"description":"Branch name to delete. Must not start with refs/. Provide target_branch or the deprecated name.","examples":["feature/old-onboarding"],"type":"string"}},"type":"object"}}},"description":"Delete a branch by name. The server resolves the current branch tip before deleting, so the caller does not need the branch SHA.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"ephemeral":false,"message":"branch deleted","name":"feature/old-onboarding","target_branch":"feature/old-onboarding"},"schema":{"additionalProperties":false,"description":"Result of deleting a branch.","properties":{"ephemeral":{"description":"Whether the deleted branch lived in the ephemeral namespace.","examples":[false],"type":"boolean"},"message":{"description":"Human-readable result message.","examples":["branch deleted"],"type":"string"},"name":{"deprecated":true,"description":"Deprecated: use target_branch. Deleted branch name.","examples":["feature/old-onboarding"],"type":"string"},"target_branch":{"description":"Deleted branch name.","examples":["feature/old-onboarding"],"type":"string"}},"required":["target_branch","name","ephemeral","message"],"type":"object"}}},"description":"Branch deletion result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"detail":"cannot delete the default branch","error":"cannot delete the default branch","instance":"/api/repos/dotfiles/branches","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"cannot delete the default branch","error":"cannot delete the default branch","instance":"/api/repos/dotfiles/branches","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The branch could not be deleted because it is the repository default branch."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Branch","tags":["Branches"],"x-deprecation-message":"Use `/api/repos/{repo_name}/branches` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"},"get":{"deprecated":true,"description":"List branches in the repository with cursor pagination. Use this to build branch selectors, review tools, or sync jobs without shelling out to Git.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/branches` instead.","operationId":"list_branches_legacy","parameters":[{"description":"Pagination cursor returned by a previous `list_branches` response.","example":"b_456def","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of branches to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}},{"description":"When true, list branches under the ephemeral namespace instead of regular branches.","in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"branches":[{"created_at":"2024-01-15T10:30:00Z","cursor":"b_123abc","head_sha":"a1b2c3d4e5f6","name":"main"}],"has_more":true,"next_cursor":"b_456def"},"schema":{"additionalProperties":false,"description":"Paginated list of branches for the repository.","properties":{"branches":{"description":"List of branch objects.","items":{"additionalProperties":false,"description":"Branch summary entry.","properties":{"created_at":{"description":"ISO 8601 creation timestamp.","examples":["2024-01-15T10:30:00Z"],"type":"string"},"cursor":{"description":"Opaque pagination token for this branch entry.","examples":["b_123abc"],"type":"string"},"head_sha":{"description":"HEAD commit SHA for the branch.","examples":["a1b2c3d4e5f6"],"type":"string"},"name":{"description":"Branch name.","examples":["main"],"type":"string"}},"required":["cursor","name","head_sha","created_at"],"type":"object"},"type":"array"},"has_more":{"description":"Whether more branches exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["b_456def"],"type":"string"}},"required":["branches","has_more"],"type":"object"}}},"description":"Repository branches in creation order."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Branches","tags":["Branches"],"x-deprecation-message":"Use `/api/repos/{repo_name}/branches` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/branches/create":{"post":{"deprecated":true,"description":"Create a new branch from an existing branch or ref. This is useful for agent workflows, ephemeral previews, or server-side automation where you do not want to clone the repo first.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/branches/create` instead.","operationId":"create_branch_legacy","requestBody":{"content":{"application/json":{"example":{"base_branch":"main","base_is_ephemeral":false,"target_branch":"feature/new-onboarding","target_is_ephemeral":false},"schema":{"additionalProperties":false,"description":"Create-branch request body describing the new branch and its base ref.","properties":{"base_branch":{"deprecated":true,"description":"Deprecated: use base_ref. Preferred source branch name.","examples":["main"],"type":"string"},"base_is_ephemeral":{"description":"Whether the base branch should be resolved from the ephemeral namespace.","examples":[false],"type":"boolean"},"base_ref":{"description":"Optional source ref or revision. Provide base_ref or the deprecated base_branch.","type":"string"},"force":{"description":"Allow non-fast-forward updates when recreating an existing branch.","type":"boolean"},"preferred_base":{"description":"Optional pack hint. A branch name the backend prefers as the delta base when it builds the thin pack. It does not change the source or the result.","type":"string"},"target_branch":{"description":"Destination branch name.","examples":["feature/new-onboarding"],"type":"string"},"target_is_ephemeral":{"description":"Whether the new branch should be created in the ephemeral namespace.","examples":[false],"type":"boolean"}},"required":["target_branch"],"type":"object"}}},"description":"Create a branch from another branch or ref. The source and destination can live in the default namespace or the ephemeral namespace.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"commit_sha":"abc123def4567890abc123def4567890abc123de","message":"branch created","target_branch":"feature/new-onboarding","target_is_ephemeral":false},"schema":{"additionalProperties":false,"description":"Result of creating a branch, including the resulting ref state.","properties":{"commit_sha":{"description":"Resolved commit SHA at the new branch tip.","examples":["abc123def4567890abc123def4567890abc123de"],"type":"string"},"message":{"description":"Human-readable result message.","examples":["branch created"],"type":"string"},"target_branch":{"description":"Destination branch name.","examples":["feature/new-onboarding"],"type":"string"},"target_is_ephemeral":{"description":"Whether the created branch is ephemeral.","examples":[false],"type":"boolean"}},"required":["message","target_branch","target_is_ephemeral"],"type":"object"}}},"description":"Branch creation result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Branch","tags":["Branches"],"x-deprecation-message":"Use `/api/repos/{repo_name}/branches/create` instead.","x-permission-scopes":["git:write"],"x-request-validation-profile":"create_branch","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/branches/diff":{"get":{"deprecated":true,"description":"Compare a feature branch to its base branch and return every change that would be reviewed before a merge. Repeated `path` filters limit the diff to selected files and bypass the usual large-file filtering for those requested paths.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/branches/diff` instead.","operationId":"get_branch_diff_legacy","parameters":[{"description":"Branch name to diff.","example":"feature/new-auth","in":"query","name":"branch","required":true,"schema":{"type":"string"}},{"description":"Optional base branch or ref to diff against.","example":"main","in":"query","name":"base","schema":{"type":"string"}},{"description":"Whether `branch` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Whether `base` should be resolved from the ephemeral namespace.","example":false,"in":"query","name":"ephemeral_base","schema":{"type":"boolean"}},{"description":"Optional repeated path filter. Provide multiple `path` query values to restrict the diff to specific files or directories.","example":["src/main.go","README.md"],"in":"query","name":"path","schema":{"items":{"type":"string"},"type":"array"}}],"responses":{"200":{"content":{"application/json":{"example":{"base":"main","branch":"feature/new-feature","files":[{"bytes":2048,"is_eof":true,"path":"src/main.go","raw":"diff --git a/src/main.go b/src/main.go\n...","state":"M"}],"filtered_files":[{"bytes":50000,"is_eof":true,"path":"package-lock.json","state":"M"}],"merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","stats":{"additions":50,"changes":60,"deletions":10,"files":3}},"schema":{"additionalProperties":false,"description":"Diff between a branch and its base, including merge base, aggregate stats, and per-file changes.","properties":{"base":{"description":"The base branch or ref used for comparison.","examples":["main"],"type":"string"},"branch":{"description":"The branch name being diffed.","examples":["feature/new-feature"],"type":"string"},"files":{"description":"Files returned with inline diff content.","items":{"additionalProperties":false,"description":"Per-file diff entry including the raw unified diff text.","properties":{"additions":{"description":"Added lines in this file.","format":"int64","type":"integer"},"bytes":{"description":"File size in bytes.","examples":[2048],"format":"int64","type":"integer"},"deletions":{"description":"Deleted lines in this file.","format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames).","examples":["src/main.go"],"type":"string"},"raw":{"description":"Raw unified diff content.","examples":["diff --git a/src/main.go b/src/main.go\n..."],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","raw","bytes","is_eof","additions","deletions"],"type":"object"},"type":"array"},"filtered_files":{"description":"Files filtered out of inline diff output because of size or file-type rules.","items":{"additionalProperties":false,"description":"Per-file diff entry that was excluded from inline diff output because of size or file-type rules.","properties":{"bytes":{"description":"File size in bytes.","examples":[50000],"format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames). Excluded from inline diff content because of size or file-type rules.","examples":["package-lock.json"],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","bytes","is_eof"],"type":"object"},"type":"array"},"merge_base_sha":{"description":"Merge base SHA used for the three-dot branch diff.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"stats":{"additionalProperties":false,"description":"Aggregate diff statistics.","properties":{"additions":{"description":"Total added lines across the diff.","examples":[50],"format":"int64","type":"integer"},"changes":{"description":"Total line changes (additions plus deletions).","examples":[60],"format":"int64","type":"integer"},"deletions":{"description":"Total deleted lines across the diff.","examples":[10],"format":"int64","type":"integer"},"files":{"description":"Number of files changed.","examples":[3],"format":"int64","type":"integer"}},"required":["files","additions","deletions","changes"],"type":"object"}},"required":["branch","base","merge_base_sha","stats","files","filtered_files"],"type":"object"}}},"description":"Diff between a source branch and its base, including the merge base used for the three-dot comparison."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Branch Diff","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/branches/diff` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/commit":{"get":{"deprecated":true,"description":"Resolve a branch name, short SHA, or full SHA to a commit and return the same metadata shape used in commit listings. Use this when you need commit details without computing a diff.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/commit` instead.","operationId":"get_commit_legacy","parameters":[{"description":"Branch name, tag, full commit SHA, short SHA, or other revision Git can resolve. Provide `ref` or the deprecated `sha`.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use ref instead. Commit SHA, short SHA, branch name, or other revision Git can resolve.","example":"main","in":"query","name":"sha","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"commit":{"author_email":"jane@example.com","author_name":"Jane Doe","committer_email":"jane@example.com","committer_name":"Jane Doe","date":"2024-01-15T14:32:18Z","message":"fix: resolve scrolling issue in dashboard","parent_shas":["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"],"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","signature":"-----BEGIN PGP SIGNATURE-----\n...\n-----END PGP SIGNATURE-----\n"}},"schema":{"additionalProperties":false,"description":"Commit metadata for a single resolved revision, without diff content.","properties":{"commit":{"additionalProperties":false,"description":"Resolved commit metadata.","properties":{"author_email":{"description":"Commit author email.","examples":["jane@example.com"],"type":"string"},"author_name":{"description":"Commit author name.","examples":["Jane Doe"],"type":"string"},"committer_email":{"description":"Commit committer email.","examples":["jane@example.com"],"type":"string"},"committer_name":{"description":"Commit committer name.","examples":["Jane Doe"],"type":"string"},"date":{"description":"Commit timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"message":{"description":"The commit message.","examples":["fix: resolve scrolling issue in dashboard"],"type":"string"},"parent_shas":{"description":"Parent commit SHAs in Git parent order. Empty for root commits.","examples":[["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"]],"items":{"type":"string"},"type":"array"},"payload":{"description":"The signed payload: the raw commit object with the gpgsig header removed. This is the exact data the signature is computed over. Absent for unsigned commits.","type":"string"},"sha":{"description":"The commit SHA.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"signature":{"description":"Armored signature from the commit's gpgsig header (OpenPGP or SSH). Absent for unsigned commits.","examples":["-----BEGIN PGP SIGNATURE-----\n...\n-----END PGP SIGNATURE-----\n"],"type":"string"}},"required":["sha","parent_shas","message","author_name","author_email","committer_name","committer_email","date"],"type":"object"}},"required":["commit"],"type":"object"}}},"description":"Commit metadata for the resolved revision."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Commit","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/commit` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/commit-pack":{"post":{"deprecated":true,"description":"Create a commit by streaming file operations directly to the service. This is designed for automation, AI agents, and other workflows that need atomic Git writes without running a local Git process.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/commit-pack` instead.","operationId":"commit_pack_legacy","requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"expected_target_sha\":\"d34db33fd34db33fd34db33fd34db33fd34db33f\",\"commit_message\":\"Update docs\",\"author\":{\"name\":\"Docs Bot\",\"email\":\"docs@example.com\"},\"files\":[{\"path\":\"docs/changelog.md\",\"operation\":\"upsert\",\"content_id\":\"blob-1\",\"mode\":\"100644\"},{\"path\":\"docs/legacy.txt\",\"operation\":\"delete\",\"content_id\":\"blob-2\"}]}}\n{\"blob_chunk\":{\"content_id\":\"blob-1\",\"data\":\"IyBWZXJzaW9uIDIuMS4wCi0gcmVmcmVzaCBkb2NzCg==\",\"eof\":true}}\n{\"blob_chunk\":{\"content_id\":\"blob-2\",\"data\":\"\",\"eof\":true}}\n","schema":{"description":"NDJSON stream. The first line must be `metadata`; subsequent lines must be `blob_chunk` payloads. Decoded blob chunks are limited to 4 MiB each.","type":"string"}}},"description":"Send newline-delimited JSON where the first line is a `metadata` object and each following line is a `blob_chunk`. This lets you stream file contents without a local Git client.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Commit created and written to the target branch."},"400":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"expected branch head did not match current tip","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The NDJSON stream was malformed or metadata validation failed."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"expected branch head did not match current tip","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The branch moved or the requested update could not be applied cleanly."},"413":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"blob chunk size 5242881 exceeds maximum 4194304","new_sha":"","old_sha":"","status":"payload_too_large","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"A decoded blob chunk exceeded the 4 MiB limit."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Commit from Files","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/commit-pack` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/commits":{"get":{"deprecated":true,"description":"List commit history for the repository default branch or for an explicit branch. Results are cursor-paginated and ordered by commit date, newest first. Set `path` to restrict the history to commits that modified a specific file or subtree.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/commits` instead.","operationId":"list_commits_legacy","parameters":[{"description":"Optional branch, tag, or commit to list commits from. When omitted, the repository default branch is used. Provide `ref` or the deprecated `branch`.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use ref instead. Optional branch name to list commits from. When omitted, the repository default branch is used.","example":"main","in":"query","name":"branch","schema":{"type":"string"}},{"description":"Optional repository-relative path to scope the history to commits that touched that path.","example":"docs/guide.md","in":"query","name":"path","schema":{"type":"string"}},{"description":"Pagination cursor returned by a previous `list_commits` response.","example":"20","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of commits to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"commits":[{"author_email":"jane@example.com","author_name":"Jane Doe","committer_email":"jane@example.com","committer_name":"Jane Doe","date":"2024-01-15T14:32:18Z","message":"fix: resolve scrolling issue in dashboard","parent_shas":["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"],"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"}],"has_more":true,"next_cursor":"20"},"schema":{"additionalProperties":false,"description":"Paginated commit history for the repository, optionally filtered by branch.","properties":{"commits":{"description":"List of commit objects.","items":{"additionalProperties":false,"description":"Commit summary entry for a list-commits response.","properties":{"author_email":{"description":"Commit author email.","examples":["jane@example.com"],"type":"string"},"author_name":{"description":"Commit author name.","examples":["Jane Doe"],"type":"string"},"committer_email":{"description":"Commit committer email.","examples":["jane@example.com"],"type":"string"},"committer_name":{"description":"Commit committer name.","examples":["Jane Doe"],"type":"string"},"date":{"description":"Commit timestamp in RFC 3339 format.","examples":["2024-01-15T14:32:18Z"],"type":"string"},"message":{"description":"The commit message.","examples":["fix: resolve scrolling issue in dashboard"],"type":"string"},"parent_shas":{"description":"Parent commit SHAs in Git parent order. Empty for root commits.","examples":[["f4f9df3b8db66c73f6bf67e8f8f4f14f6522731e"]],"items":{"type":"string"},"type":"array"},"sha":{"description":"The commit SHA.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"required":["sha","parent_shas","message","author_name","author_email","committer_name","committer_email","date"],"type":"object"},"type":"array"},"has_more":{"description":"Whether more commits exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["20"],"type":"string"}},"required":["commits","has_more"],"type":"object"}}},"description":"Commit history ordered from newest to oldest."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Commits","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/commits` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/delete":{"delete":{"deprecated":true,"description":"Permanently retire a repository. The API performs a soft delete first and then triggers asynchronous hot and cold storage cleanup.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}` instead.","operationId":"delete_repo_legacy","responses":{"200":{"content":{"application/json":{"example":{"message":"Repository repo_7f2b3d9 deletion initiated. Physical storage cleanup will complete asynchronously.","repo_id":"repo_7f2b3d9"},"schema":{"additionalProperties":false,"description":"Confirmation that the repository deletion has been accepted.","properties":{"message":{"description":"Human-readable deletion status message.","examples":["Repository repo_7f2b3d9 deletion initiated. Physical storage cleanup will complete asynchronously."],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"}},"required":["repo_id","message"],"type":"object"}}},"description":"Deletion accepted. Physical storage cleanup continues asynchronously."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"detail":"repository already deleted","error":"repository already deleted","instance":"/api/repos/dotfiles","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"example":{"detail":"repository already deleted","error":"repository already deleted","instance":"/api/repos/dotfiles","status":409,"title":"Conflict","type":"about:blank"},"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"The repository was already deleted."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Repo","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}` instead.","x-permission-scopes":["repo:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/diff":{"get":{"deprecated":true,"description":"Get the diff for a commit, optionally relative to a specific base commit. Repeated `path` parameters narrow the diff to selected files or directories.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/diff` instead.","operationId":"get_commit_diff_legacy","parameters":[{"description":"Branch, tag, or commit to diff. Provide `ref` or the deprecated `sha`.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use ref instead. Commit SHA to diff.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"sha","schema":{"type":"string"}},{"description":"Optional base branch, tag, or commit to diff against. When omitted, the diff is generated against the commit's parent. Provide `base_ref` or the deprecated `baseSha`.","example":"a4d39d7c79e819ab003fc78805954584e1ee36","in":"query","name":"base_ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use base_ref instead. Optional base commit SHA to diff against. When omitted, the diff is generated against the commit's parent.","example":"a4d39d7c79e819ab003fc78805954584e1ee36","in":"query","name":"baseSha","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","in":"query","name":"ref_is_ephemeral","schema":{"type":"boolean"}},{"description":"Whether `base_ref` should be resolved from the ephemeral namespace.","in":"query","name":"base_is_ephemeral","schema":{"type":"boolean"}},{"description":"Optional repeated path filter. Provide multiple `path` query values to restrict the diff to specific files or directories.","example":["src/main.go","README.md"],"in":"query","name":"path","schema":{"items":{"type":"string"},"type":"array"}},{"description":"When enabled, concatenate `files[].raw` in response order and apply the result against the selected base with `git apply`. Changes listed in `filtered_files` are not included in the patch. Defaults to false, preserving review-oriented whitespace suppression. Provide `git_apply_compatible` or the deprecated `gitApplyCompatible`.","example":false,"in":"query","name":"git_apply_compatible","schema":{"type":"boolean"}},{"deprecated":true,"description":"Deprecated: use git_apply_compatible instead. When enabled, concatenate `files[].raw` in response order and apply the result against the selected base with `git apply`. Changes listed in `filtered_files` are not included in the patch. Defaults to false, preserving review-oriented whitespace suppression.","example":false,"in":"query","name":"gitApplyCompatible","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"files":[{"bytes":2048,"is_eof":true,"path":"src/main.go","raw":"diff --git a/src/main.go b/src/main.go\n...","state":"M"}],"filtered_files":[{"bytes":50000,"is_eof":true,"path":"package-lock.json","state":"M"}],"merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","stats":{"additions":50,"changes":60,"deletions":10,"files":3}},"schema":{"additionalProperties":false,"description":"Diff for a single commit, including merge base when applicable, aggregate stats, and per-file changes.","properties":{"files":{"description":"Files returned with inline diff content.","items":{"additionalProperties":false,"description":"Per-file diff entry including the raw unified diff text.","properties":{"additions":{"description":"Added lines in this file.","format":"int64","type":"integer"},"bytes":{"description":"File size in bytes.","examples":[2048],"format":"int64","type":"integer"},"deletions":{"description":"Deleted lines in this file.","format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames).","examples":["src/main.go"],"type":"string"},"raw":{"description":"Raw unified diff content.","examples":["diff --git a/src/main.go b/src/main.go\n..."],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","raw","bytes","is_eof","additions","deletions"],"type":"object"},"type":"array"},"filtered_files":{"description":"Files filtered out of inline diff output because of size or file-type rules.","items":{"additionalProperties":false,"description":"Per-file diff entry that was excluded from inline diff output because of size or file-type rules.","properties":{"bytes":{"description":"File size in bytes.","examples":[50000],"format":"int64","type":"integer"},"is_eof":{"description":"Whether the file ends with a newline.","examples":[true],"type":"boolean"},"old_path":{"description":"Previous file path for renamed files.","type":"string"},"path":{"description":"Repository-relative file path (new location for renames). Excluded from inline diff content because of size or file-type rules.","examples":["package-lock.json"],"type":"string"},"state":{"description":"Git status code: A (added), M (modified), D (deleted), R (renamed), C (copied), or T (type changed).","examples":["M"],"type":"string"}},"required":["path","state","bytes","is_eof"],"type":"object"},"type":"array"},"merge_base_sha":{"description":"Merge base SHA used for explicit baseSha three-dot comparisons. Empty for single-commit diffs.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"sha":{"description":"The commit SHA to diff.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"stats":{"additionalProperties":false,"description":"Aggregate diff statistics.","properties":{"additions":{"description":"Total added lines across the diff.","examples":[50],"format":"int64","type":"integer"},"changes":{"description":"Total line changes (additions plus deletions).","examples":[60],"format":"int64","type":"integer"},"deletions":{"description":"Total deleted lines across the diff.","examples":[10],"format":"int64","type":"integer"},"files":{"description":"Number of files changed.","examples":[3],"format":"int64","type":"integer"}},"required":["files","additions","deletions","changes"],"type":"object"}},"required":["sha","stats","files","filtered_files"],"type":"object"}}},"description":"Full diff for the requested commit, including file-level stats, line-level hunks, and merge base for explicit base comparisons."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Commit Diff","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/diff` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/diff-commit":{"post":{"deprecated":true,"description":"Create a commit by streaming a Git patch instead of individual file blobs. Use this when your workflow already produces unified diffs or generated patches.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/diff-commit` instead.","operationId":"diff_commit_legacy","requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"expected_target_sha\":\"d34db33fd34db33fd34db33fd34db33fd34db33f\",\"commit_message\":\"Apply generated patch\",\"author\":{\"name\":\"Diff Bot\",\"email\":\"diff@example.com\"}}}\n{\"diff_chunk\":{\"data\":\"ZGlmZiAtLWdpdCBhL1JFQURNRS5tZCBiL1JFQURNRS5tZAo=\",\"eof\":false}}\n{\"diff_chunk\":{\"data\":\"QEAgLTEsMSArMSwyIEBACi1IZWxsbworSGVsbG8gV29ybGQK\",\"eof\":true}}\n","schema":{"description":"NDJSON stream. The first line must be `metadata`; subsequent lines must be `diff_chunk` payloads. Decoded diff chunks are limited to 4 MiB each.","type":"string"}}},"description":"Send newline-delimited JSON where the first line is a `metadata` object and each following line is a `diff_chunk`. The combined diff must be compatible with `git apply --cached --binary`.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Commit created from the supplied diff."},"400":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"diff payload could not be decoded","new_sha":"","old_sha":"","status":"invalid_diff","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The NDJSON stream or diff payload was invalid."},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"result":{"branch":"main","message":"patch does not apply cleanly","new_sha":"","old_sha":"","status":"conflict","success":false}},"schema":{"additionalProperties":false,"description":"Result of applying an NDJSON commit pack, including the resulting commit and branch update.","properties":{"commit":{"additionalProperties":false,"description":"Commit object information generated by the storage service.","properties":{"blob_count":{"description":"Number of blobs included in the pack.","format":"int32","minimum":0,"type":"integer"},"commit_sha":{"description":"SHA of the new commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch the commit was written to.","type":"string"},"tree_sha":{"description":"Tree SHA of the new commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes","blob_count"],"type":"object"},"result":{"additionalProperties":false,"description":"Final branch update outcome.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the commit updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after the update.","type":"string"},"old_sha":{"description":"Previous tip SHA (40-char hex; all zeros when the branch did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the operation succeeded.","type":"boolean"},"target_branch":{"description":"The branch the commit updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"The diff could not be applied cleanly or the target branch tip changed."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Commit from Diff","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/diff-commit` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/file":{"get":{"deprecated":true,"description":"Stream a file directly from the repository with byte ranges, ETag validators, and Last-Modified conditionals. Use `ref` to read from a branch, tag, or commit without cloning the repo locally.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/file` instead.","operationId":"get_file_legacy","parameters":[{"description":"Repository-relative file path to fetch.","example":"src/main.js","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to read from. When omitted, the repository default branch is used.","example":"v1.0.0","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Standard HTTP byte-range header (`bytes=\u003cstart\u003e-\u003cend\u003e`). Triggers a `206 Partial Content` response.","in":"header","name":"Range","schema":{"type":"string"}},{"description":"Conditional range request: when the supplied validator matches `ETag` or `Last-Modified`, the server returns `206 Partial Content`; otherwise the full body is returned with `200 OK`.","in":"header","name":"If-Range","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when the current `ETag` does not match.","in":"header","name":"If-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when the current `ETag` matches.","in":"header","name":"If-None-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when `Last-Modified` is on or before this date.","in":"header","name":"If-Modified-Since","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when `Last-Modified` is after this date.","in":"header","name":"If-Unmodified-Since","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/octet-stream":{"schema":{"contentMediaType":"application/octet-stream","description":"Raw file bytes exactly as stored in the Git blob. No transcoding or encoding is applied.","format":"binary","type":"string"}}},"description":"File content returned.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"206":{"content":{"application/octet-stream":{"schema":{"contentMediaType":"application/octet-stream","description":"The requested slice of the raw file bytes. `Content-Range` identifies which bytes were served.","format":"binary","type":"string"}}},"description":"Byte range satisfied. Body contains only the requested bytes; `Content-Range` identifies the range.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"304":{"description":"Cached representation still valid. Returned when `If-None-Match` matches the current `ETag` or `If-Modified-Since` is on or after `Last-Modified`. Body is empty.","headers":{"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Precondition from `If-Match` or `If-Unmodified-Since` failed: the resource has changed since the validator the client supplied."},"416":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Requested byte range is outside the blob size."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get File","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/file` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"head":{"deprecated":true,"description":"Return file metadata headers for a repository file without streaming the file body. Supports byte ranges, ETag validators, and Last-Modified conditionals. Use `ref` to inspect a branch, tag, or commit without cloning the repo locally.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/file` instead.","operationId":"head_file_legacy","parameters":[{"description":"Repository-relative file path to fetch.","example":"src/main.js","in":"query","name":"path","required":true,"schema":{"type":"string"}},{"description":"Optional branch, tag, or commit SHA to read from. When omitted, the repository default branch is used.","example":"v1.0.0","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}},{"description":"Standard HTTP byte-range header (`bytes=\u003cstart\u003e-\u003cend\u003e`). Triggers a `206 Partial Content` response.","in":"header","name":"Range","schema":{"type":"string"}},{"description":"Conditional range request: when the supplied validator matches `ETag` or `Last-Modified`, the server returns `206 Partial Content`; otherwise the full body is returned with `200 OK`.","in":"header","name":"If-Range","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when the current `ETag` does not match.","in":"header","name":"If-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when the current `ETag` matches.","in":"header","name":"If-None-Match","schema":{"type":"string"}},{"description":"Returns `304 Not Modified` when `Last-Modified` is on or before this date.","in":"header","name":"If-Modified-Since","schema":{"type":"string"}},{"description":"Returns `412 Precondition Failed` when `Last-Modified` is after this date.","in":"header","name":"If-Unmodified-Since","schema":{"type":"string"}}],"responses":{"200":{"description":"File metadata headers returned. Body is empty.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"206":{"description":"Byte range satisfied. Body is empty; `Content-Range` identifies the range.","headers":{"Accept-Ranges":{"description":"Set to `bytes`; the endpoint accepts byte-range requests via `Range`.","schema":{"type":"string"}},"Content-Length":{"description":"Full blob size in bytes for 200 responses, or range size for 206 responses.","schema":{"type":"string"}},"Content-Range":{"description":"Returned for 206 responses; identifies the byte range served.","schema":{"type":"string"}},"Content-Type":{"description":"Always `application/octet-stream`.","schema":{"type":"string"}},"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"304":{"description":"Cached representation still valid. Returned when `If-None-Match` matches the current `ETag` or `If-Modified-Since` is on or after `Last-Modified`. Body is empty.","headers":{"ETag":{"description":"Strong validator equal to the quoted blob object SHA. Use with `If-Match` / `If-None-Match`.","schema":{"type":"string"}},"Last-Modified":{"description":"Committer date of the most recent commit reachable from `ref` that modified `path`. Use with `If-Modified-Since` / `If-Unmodified-Since`.","schema":{"type":"string"}},"X-Blob-Sha":{"description":"Git blob object SHA of the served file.","schema":{"type":"string"}},"X-Last-Commit-Sha":{"description":"SHA of the most recent commit reachable from `ref` that modified `path`.","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Precondition from `If-Match` or `If-Unmodified-Since` failed: the resource has changed since the validator the client supplied."},"416":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Requested byte range is outside the blob size."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get File Headers","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/file` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/files":{"get":{"deprecated":true,"description":"List files or direct child entries at a branch, tag, or commit without cloning the repository. Each entry includes its path, Git mode, and derived type (`blob`, `tree`, `symlink`, or `submodule`). Trees no longer carry a trailing `/`; branch on `type` instead.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/files` instead.","operationId":"list_files_legacy","parameters":[{"description":"Optional branch, tag, or commit SHA to list from. When omitted, the repository default branch is used.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Optional repository-relative subtree to list. Empty means the repository root.","example":"docs","in":"query","name":"path","schema":{"type":"string"}},{"description":"When true, include descendants recursively. When false, only direct children are returned.","example":false,"in":"query","name":"recursive","schema":{"type":"boolean"}},{"description":"Pagination cursor returned by a previous `list_files` response.","example":"docs/guide.md","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of paths to return. Defaults to 1000.","example":1000,"in":"query","name":"limit","schema":{"default":1000,"maximum":5000,"minimum":0,"type":"integer"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"entries":[{"mode":"100644","path":"src/main.go","type":"blob"}],"has_more":true,"next_cursor":"docs/guide.md","paths":["README.md"],"ref":"main"},"schema":{"additionalProperties":false,"description":"Paginated tree entries in the repository at the resolved revision.","properties":{"entries":{"description":"Tree entries for the resolved revision.","items":{"additionalProperties":false,"description":"Tree entry in a list-files response, including the repository-rooted path, six-digit Git mode, and derived type.","properties":{"mode":{"description":"Six-digit Git mode for the entry.","examples":["100644"],"type":"string"},"path":{"description":"Repository-rooted path.","examples":["src/main.go"],"type":"string"},"type":{"description":"Entry type: blob, tree, symlink, or submodule.","examples":["blob"],"type":"string"}},"required":["path","type","mode"],"type":"object"},"type":"array"},"has_more":{"description":"Whether another page of entries is available.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Cursor to resume pagination from. Empty when there are no more results.","examples":["docs/guide.md"],"type":"string"},"paths":{"description":"Flat blob-only path list. Mirrors the path of every entry whose type is \"blob\". Convenience shape for callers that just want file paths; use entries when you need type/mode.","examples":[["README.md"]],"items":{"description":"Repository-relative path used to scope the operation.","type":"string"},"type":"array"},"ref":{"description":"The resolved reference (branch name or commit SHA) that was used.","examples":["main"],"type":"string"}},"required":["entries","paths","ref","has_more"],"type":"object"}}},"description":"Tree entries for the resolved revision."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Files","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/files` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/files/metadata":{"get":{"deprecated":true,"description":"Return a recursive file tree together with per-file commit metadata in one request. Each file also includes a derived `type` field for symmetry with `/files`.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/files/metadata` instead.","operationId":"list_files_metadata_legacy","parameters":[{"description":"Optional branch, tag, or commit SHA to list from. When omitted, the repository default branch is used.","example":"main","in":"query","name":"ref","schema":{"type":"string"}},{"description":"Optional repository-relative subtree to list recursively. Empty means the repository root.","example":"docs","in":"query","name":"path","schema":{"type":"string"}},{"description":"Accepted for API symmetry. Metadata listings are recursive regardless of this flag.","example":true,"in":"query","name":"recursive","schema":{"type":"boolean"}},{"description":"Pagination cursor returned by a previous `list_files_with_metadata` response.","example":"docs/guide.md","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of files to return. Defaults to 200.","example":200,"in":"query","name":"limit","schema":{"default":200,"maximum":1000,"minimum":0,"type":"integer"}},{"description":"Whether `ref` should be resolved from the ephemeral namespace.","example":true,"in":"query","name":"ephemeral","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"files":[{"last_commit_sha":"a1b2c3d4e5f6","mode":"100644","path":"README.md","size":2048,"type":"blob"}],"has_more":true,"next_cursor":"docs/guide.md","ref":"main"},"schema":{"additionalProperties":false,"description":"Files in the repository at the resolved revision, each annotated with mode, type, and the latest commit that changed it.","properties":{"commits":{"additionalProperties":{"additionalProperties":false,"description":"Commit metadata shared by one or more files in a list-files-with-metadata response.","properties":{"author":{"description":"Author display name for the commit.","examples":["Jon Crosby"],"type":"string"},"date":{"description":"RFC 3339 author date for the commit.","examples":["2026-02-18T10:30:00Z"],"type":"string"},"message":{"description":"Commit message.","examples":["add list files with metadata endpoint"],"type":"string"}},"required":["author","date","message"],"type":"object"},"description":"Commit metadata keyed by last_commit_sha so repeated commits are only sent once.","type":"object"},"files":{"description":"Files in the resolved revision, each annotated with the latest commit that changed it.","items":{"additionalProperties":false,"description":"File entry in a list-files-with-metadata response, including mode, type, and the SHA of the most recent commit that touched it.","properties":{"last_commit_sha":{"description":"Commit SHA of the most recent commit that touched this file.","examples":["a1b2c3d4e5f6"],"type":"string"},"mode":{"description":"File mode as stored in Git, for example 100644.","examples":["100644"],"type":"string"},"path":{"description":"Repository-relative file path.","examples":["README.md"],"type":"string"},"size":{"description":"File size in bytes.","examples":[2048],"format":"int64","type":"integer"},"type":{"description":"Derived file type: blob, tree, symlink, or submodule.","examples":["blob"],"type":"string"}},"required":["path","mode","type","size","last_commit_sha"],"type":"object"},"type":"array"},"has_more":{"description":"Whether another page of files is available.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Cursor to resume pagination from. Empty when there are no more results.","examples":["docs/guide.md"],"type":"string"},"ref":{"description":"The resolved ref or commit used to generate the listing.","examples":["main"],"type":"string"}},"required":["files","commits","ref","has_more"],"type":"object"}}},"description":"The repository tree plus deduplicated commit metadata for the latest change touching each file."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Files with Metadata","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/files/metadata` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/git-credentials":{"delete":{"deprecated":true,"description":"Delete a stored HTTPS credential for a generic Git upstream.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/git-credentials/{git_credential_id}` instead.","operationId":"delete_generic_git_credential_legacy","requestBody":{"content":{"application/json":{"example":{"id":"ggc_1234567890abcdef"},"schema":{"additionalProperties":false,"description":"Request body identifying the HTTPS Git credential to delete.","properties":{"id":{"description":"Credential ID to delete.","examples":["ggc_1234567890abcdef"],"type":"string"}},"required":["id"],"type":"object"}}},"description":"Delete the stored HTTPS credential for a repository's generic Git upstream.","required":true},"responses":{"204":{"description":"Credential deleted successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Git Credential","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}/git-credentials/{git_credential_id}` instead.","x-permission-scopes":["repo:write"],"x-request-validation-profile":"delete_generic_git_credential","x-requires-repo-scope":true,"x-stability":"stable"},"post":{"deprecated":true,"description":"Create a stored HTTPS credential for a repository configured with a generic Git upstream.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/git-credentials` instead.","operationId":"create_generic_git_credential_legacy","requestBody":{"content":{"application/json":{"example":{"password":"glpat_xxxxxxxxxxxx","repo_id":"repo_7f2b3d9","username":"git"},"schema":{"additionalProperties":false,"description":"Request body for storing a new HTTPS Git credential against a repository configured for a generic Git provider.","properties":{"password":{"description":"Password or access token for the upstream provider.","examples":["glpat_xxxxxxxxxxxx"],"type":"string"},"repo_id":{"description":"Stable repository identifier.","examples":["repo_7f2b3d9"],"type":"string"},"username":{"description":"Optional username for HTTPS authentication. Omit it for token-only providers.","examples":["git"],"type":"string"}},"required":["repo_id","username","password"],"type":"object"}}},"description":"Store HTTPS credentials for a generic Git upstream such as GitLab, Bitbucket, Gitea, Forgejo, Codeberg, or SourceHut.","required":true},"responses":{"201":{"content":{"application/json":{"example":{"created_at":"2026-03-12T15:04:05Z","id":"ggc_1234567890abcdef"},"schema":{"additionalProperties":false,"description":"Stored Git credential summary returned after a credential is created or updated.","properties":{"created_at":{"description":"Credential creation timestamp in ISO 8601 format.","examples":["2026-03-12T15:04:05Z"],"type":"string"},"id":{"description":"Credential ID returned when the credential is created.","examples":["ggc_1234567890abcdef"],"type":"string"}},"required":["id"],"type":"object"}}},"description":"Credential created successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Git Credential","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}/git-credentials` instead.","x-permission-scopes":["repo:write"],"x-request-validation-profile":"create_generic_git_credential","x-requires-repo-scope":true,"x-stability":"stable"},"put":{"deprecated":true,"description":"Update a stored HTTPS credential for a generic Git upstream.\n#### JWT claims\nRequired scopes: `repo:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/git-credentials/{git_credential_id}` instead.","operationId":"update_generic_git_credential_legacy","requestBody":{"content":{"application/json":{"example":{"id":"ggc_1234567890abcdef","password":"glpat_rotated_token","username":"git"},"schema":{"additionalProperties":false,"description":"Request body for rotating an existing HTTPS Git credential by credential ID.","properties":{"id":{"description":"Credential ID returned at create time.","examples":["ggc_1234567890abcdef"],"type":"string"},"password":{"description":"Updated password or access token for the upstream provider.","examples":["glpat_rotated_token"],"type":"string"},"username":{"description":"Optional username for HTTPS authentication. Omit for token-only providers.","examples":["git"],"type":"string"}},"required":["id","username","password"],"type":"object"}}},"description":"Rotate or replace an existing generic Git credential.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"created_at":"2026-03-12T15:04:05Z","id":"ggc_1234567890abcdef"},"schema":{"additionalProperties":false,"description":"Stored Git credential summary returned after a credential is created or updated.","properties":{"created_at":{"description":"Credential creation timestamp in ISO 8601 format.","examples":["2026-03-12T15:04:05Z"],"type":"string"},"id":{"description":"Credential ID returned when the credential is created.","examples":["ggc_1234567890abcdef"],"type":"string"}},"required":["id"],"type":"object"}}},"description":"Credential updated successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Update Git Credential","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}/git-credentials/{git_credential_id}` instead.","x-permission-scopes":["repo:write"],"x-request-validation-profile":"update_generic_git_credential","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/grep":{"post":{"deprecated":true,"description":"Search a repository without cloning it. Results are paginated and can include surrounding context lines so downstream tools only fetch the relevant slices.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/grep` instead.","operationId":"grep_legacy","requestBody":{"content":{"application/json":{"example":{"context":{"after":1,"before":0},"pagination":{"limit":50},"query":{"case_sensitive":true,"pattern":"ephemeral branches"},"rev":"main"},"schema":{"additionalProperties":false,"description":"Grep request describing the pattern, ref, filters, limits, and pagination for a repository content search.","properties":{"context":{"additionalProperties":false,"description":"Lines of context to include before and after each match.","properties":{"after":{"description":"Number of lines to include after each match.","examples":[1],"format":"int32","type":"integer"},"before":{"description":"Number of lines to include before each match.","examples":[0],"format":"int32","type":"integer"}},"type":"object"},"ephemeral":{"description":"Whether ref should be resolved from the ephemeral namespace.","type":"boolean"},"file_filters":{"additionalProperties":false,"description":"Optional include and exclude filters applied before matching.","properties":{"exclude_globs":{"description":"Glob patterns for files to exclude.","items":{"description":"Glob pattern such as `node_modules/**`.","type":"string"},"type":"array"},"extension_filters":{"description":"File extensions to filter by (e.g. [\".js\", \".py\"]).","items":{"description":"File extension to match, including the leading dot (e.g. `.js`).","type":"string"},"type":"array"},"include_globs":{"description":"Glob patterns for files to include.","items":{"description":"Glob pattern such as `src/**/*.go`.","type":"string"},"type":"array"}},"type":"object"},"limits":{"additionalProperties":false,"description":"Maximum line and per-file match limits.","properties":{"max_lines":{"description":"Maximum total lines to return (default 2000, max 2000).","format":"int32","type":"integer"},"max_matches_per_file":{"description":"Maximum matches returned per file (default 200).","format":"int32","type":"integer"}},"type":"object"},"pagination":{"additionalProperties":false,"description":"Cursor-based pagination controls for large result sets.","properties":{"cursor":{"description":"Pagination cursor returned by a previous grep response.","type":"string"},"limit":{"description":"Maximum number of matches to return (default 200).","examples":[50],"format":"int32","type":"integer"}},"type":"object"},"paths":{"description":"Optional path prefixes used to narrow the search before pattern matching.","items":{"description":"Repository-relative path used to scope the operation.","type":"string"},"type":"array"},"query":{"additionalProperties":false,"description":"Pattern configuration.","properties":{"case_sensitive":{"default":true,"description":"Defaults to true when omitted.","examples":[true],"type":"boolean"},"pattern":{"description":"Regular expression or literal pattern to search for.","examples":["ephemeral branches"],"type":"string"}},"required":["pattern"],"type":"object"},"ref":{"description":"Preferred branch, tag, or commit to search.","type":"string"},"rev":{"deprecated":true,"description":"Deprecated: use ref. Legacy ref field retained for backwards compatibility.","examples":["main"],"type":"string"}},"required":["query"],"type":"object"}}},"description":"Search repository contents by pattern. Optional file filters, context lines, and pagination let you retrieve only the relevant slices for agents and tools.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"incomplete_results":false,"matches":[{"path":"app/blog/markdown/ephemeral-branches.md"}],"query":{"case_sensitive":true,"pattern":"ephemeral branches"},"repo":{"commit":"b003fc78805954584e1ee364a4ad39d7c79e819a","ref":"main"}},"schema":{"additionalProperties":false,"description":"Grep results grouped per file, including the resolved ref and pagination state.","properties":{"has_more":{"description":"Whether additional matches remain.","examples":[true],"type":"boolean"},"incomplete_results":{"description":"True when the result set is incomplete because the server-side output cap was reached. Matches beyond the cap exist in the repo but cannot be retrieved by paging: narrow the query (pattern, paths, file filters) or raise max_lines if it was set below the maximum. next_cursor still pages through everything collected below the cap.","examples":[false],"type":"boolean"},"matches":{"description":"Files that matched the query, each with matching and context lines.","items":{"additionalProperties":false,"description":"Matches grouped under a single file path.","properties":{"lines":{"description":"Lines returned for the match, including optional context lines.","items":{"additionalProperties":false,"description":"Single line returned by grep, either a match or a surrounding context line.","properties":{"line_number":{"description":"Line number in the file.","format":"int32","type":"integer"},"text":{"description":"Line text content.","type":"string"},"type":{"description":"match for lines satisfying the pattern, or context for surrounding context lines.","type":"string"}},"required":["line_number","text","type"],"type":"object"},"type":"array"},"path":{"description":"Repository-relative file path that matched.","examples":["app/blog/markdown/ephemeral-branches.md"],"type":"string"}},"required":["path","lines"],"type":"object"},"type":"array"},"next_cursor":{"description":"Opaque cursor for the next page, if any.","type":["string","null"]},"query":{"additionalProperties":false,"description":"The effective query settings used by the server.","properties":{"case_sensitive":{"description":"Echoed case-sensitivity setting.","examples":[true],"type":"boolean"},"pattern":{"description":"Echoed pattern that was searched.","examples":["ephemeral branches"],"type":"string"}},"required":["pattern","case_sensitive"],"type":"object"},"repo":{"additionalProperties":false,"description":"Resolved repository ref and commit used for the search.","properties":{"commit":{"description":"Resolved commit SHA the grep ran against.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"ref":{"description":"Ref that was grepped.","examples":["main"],"type":"string"}},"required":["ref","commit"],"type":"object"}},"required":["query","repo","matches","next_cursor","has_more","incomplete_results"],"type":"object"}}},"description":"Search results for the requested pattern.","headers":{"X-Cache":{"description":"Indicates grep cache status (`HIT` or `MISS`).","schema":{"type":"string"}}}},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Grep","tags":["Files"],"x-deprecation-message":"Use `/api/repos/{repo_name}/grep` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/merge":{"post":{"deprecated":true,"description":"Merge changes between branches without cloning the repository or shelling out to Git. This endpoint also supports promoting work from ephemeral branches into long-lived branches such as `main`. Omit `expected_target_sha` to merge into the current target tip and allow the gateway to retry stale target/repository movement internally; set `expected_target_sha` to require a strict target-tip precondition. GitHub-backed public targets currently do not use automatic retry.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/merge` instead.","operationId":"merge_branch_legacy","requestBody":{"content":{"application/json":{"example":{"commit_message":"Merge feature/preview","expected_target_sha":"c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2","source_branch":"feature/preview","source_is_ephemeral":true,"source_ref":"feature/preview","squash":false,"strategy":"merge","target_branch":"main"},"schema":{"additionalProperties":false,"description":"Merge request body specifying source and target branches, optional pinned source SHA, merge strategy, optional squash flag, and optional retry-on-target-move behavior, which is currently unsupported for GitHub-backed public targets.","properties":{"allow_unrelated_histories":{"description":"Permit merges between unrelated histories.","type":"boolean"},"author":{"additionalProperties":false,"description":"Author identity used when the backend creates a merge commit. Required for merge-commit strategies.","properties":{"email":{"description":"Email address for the signature.","type":"string"},"name":{"description":"Display name for the signature.","type":"string"}},"required":["name","email"],"type":"object"},"commit_message":{"description":"Commit message used when a merge commit is created.","examples":["Merge feature/preview"],"type":"string"},"committer":{"additionalProperties":false,"description":"Committer identity for the merge commit. Defaults to author when omitted.","properties":{"email":{"description":"Email address for the signature.","type":"string"},"name":{"description":"Display name for the signature.","type":"string"}},"required":["name","email"],"type":"object"},"expected_target_sha":{"description":"Optional branch tip guard. The merge fails if the target has moved since this SHA.","examples":["c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"],"type":"string"},"source_branch":{"deprecated":true,"description":"Deprecated: use source_ref. Source branch to merge from.","examples":["feature/preview"],"type":"string"},"source_is_ephemeral":{"description":"Whether source_ref should be resolved from the ephemeral namespace.","examples":[true],"type":"boolean"},"source_ref":{"description":"Branch or refs/heads ref to merge from. The merge reads the source and never updates it. Provide source_ref or the deprecated source_branch.","examples":["feature/preview"],"type":"string"},"squash":{"description":"When true, collapse the source into a single new commit whose only parent is the current target tip. Defaults to false, which preserves the standard merge/fast-forward behavior. Incompatible with the ff_only strategy.","examples":[false],"type":"boolean"},"strategy":{"description":"Merge strategy. merge creates a merge commit when needed, ff_only rejects non-fast-forward merges, and ff_prefer fast-forwards when possible before falling back to a merge commit.","enum":["merge","ff_only","ff_prefer"],"examples":["merge"],"type":"string"},"target_branch":{"description":"Destination branch to update. A merge always updates a branch.","examples":["main"],"type":"string"},"target_is_ephemeral":{"description":"Whether target_branch should be resolved from the ephemeral namespace.","type":"boolean"}},"required":["target_branch","strategy"],"type":"object"}}},"description":"Merge a source branch into a target branch using a merge commit, fast-forward only, or fast-forward preferred behaviour. Source and target can live in the default or ephemeral namespace. When expected_target_sha is omitted, the gateway may retry stale target updates internally while keeping the originally resolved source commit pinned. Automatic stale-target retry is disabled for GitHub-backed public targets.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"commit_sha":"41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84","merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","promoted_commits":3,"result":"merged","source":{"branch":"feature/preview","ephemeral":true,"ref":"feature/preview","sha":"9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1"},"target":{"branch":"main","new_sha":"41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84","old_sha":"c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"},"tree_sha":"b9532c5d5be50d88e2f45d7c229566b2f1f99731"},"schema":{"additionalProperties":false,"description":"Merge outcome including the resulting commit, source and target state, merge base information, and retry attempt counters when applicable.","properties":{"commit_sha":{"description":"Commit SHA for the merge result. For a fast-forward or no-op, this is the resulting target tip.","examples":["41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84"],"type":"string"},"merge_base_sha":{"description":"Merge base SHA when one exists and the backend reports it.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"promoted_commits":{"description":"Number of commits promoted from source onto target.","examples":[3],"format":"int32","minimum":0,"type":"integer"},"result":{"description":"Merge outcome: merge_commit, fast_forward, no_op, squash, or unknown.","examples":["merged"],"type":"string"},"source":{"additionalProperties":false,"description":"Source ref metadata with branch, ephemeral, and resolved sha.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use ref. Source branch name.","examples":["feature/preview"],"type":"string"},"ephemeral":{"description":"Whether the source ref was resolved under the ephemeral namespace.","examples":[true],"type":"boolean"},"ref":{"description":"The source ref the merge reads.","examples":["feature/preview"],"type":"string"},"sha":{"description":"Resolved source SHA.","examples":["9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1"],"type":"string"}},"required":["ref","branch","ephemeral","sha"],"type":"object"},"target":{"additionalProperties":false,"description":"Target ref metadata with branch, ephemeral, previous old_sha, and resulting new_sha.","properties":{"branch":{"description":"Target branch name.","examples":["main"],"type":"string"},"ephemeral":{"description":"Whether the target ref was resolved under the ephemeral namespace.","type":"boolean"},"new_sha":{"description":"New target tip SHA after the merge.","examples":["41f0d5c6cc5f4d0fb4a3af2de27ccf9a80ab3b84"],"type":"string"},"old_sha":{"description":"Previous target tip SHA before the merge.","examples":["c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"],"type":"string"}},"required":["branch","ephemeral","old_sha","new_sha"],"type":"object"},"tree_sha":{"description":"Tree SHA for the resulting commit or target tip.","examples":["b9532c5d5be50d88e2f45d7c229566b2f1f99731"],"type":"string"}},"required":["result","commit_sha","tree_sha","source","target","promoted_commits"],"type":"object"}}},"description":"Merge result, including the source and target commit state after the operation."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"example":{"conflict_type":"merge_conflict","error":"merge conflict"},"schema":{"additionalProperties":false,"properties":{"conflict_paths":{"description":"Repository paths that conflicted during the merge.","items":{"type":"string"},"type":"array"},"conflict_type":{"description":"Machine-readable conflict type: merge_conflict, target_moved, or repo_changed.","examples":["merge_conflict"],"type":"string"},"error":{"description":"High-level conflict result.","examples":["merge conflict"],"type":"string"},"merge_base_sha":{"description":"Merge base SHA used when the conflict was calculated.","type":"string"}},"required":["error"],"type":"object"}}},"description":"The merge could not be completed because of file-level conflicts, or an automatic stale-target retry could not absorb concurrent target/repository movement. Inspect conflict_type to distinguish merge_conflict, target_moved, and repo_changed."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Merge Branch","tags":["Branches"],"x-deprecation-message":"Use `/api/repos/{repo_name}/merge` instead.","x-permission-scopes":["git:write"],"x-request-validation-profile":"merge_branch","x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/merge/preview":{"get":{"deprecated":true,"description":"Preview merge conflicts without creating commits, updating refs, or touching a working tree. When requested, conflict content is rendered from Git objects produced in request-local scratch storage.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/merge/preview` instead.","operationId":"preview_merge_legacy","parameters":[{"description":"Source branch to merge from.","example":"feature/preview","in":"query","name":"source_branch","required":true,"schema":{"type":"string"}},{"description":"Destination branch to preview merging into.","example":"main","in":"query","name":"target_branch","required":true,"schema":{"type":"string"}},{"description":"Whether `source_branch` should be resolved from the ephemeral namespace.","in":"query","name":"source_is_ephemeral","schema":{"type":"boolean"}},{"description":"Whether `target_branch` should be resolved from the ephemeral namespace.","in":"query","name":"target_is_ephemeral","schema":{"type":"boolean"}},{"description":"When true, include bounded conflict content in the response.","example":true,"in":"query","name":"include_content","schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"example":{"conflicts":[{"base":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false},"ours":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false},"path":"docs/conflict.txt","result":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false},"theirs":{"binary":false,"oid":"1111111111111111111111111111111111111111","truncated":false}}],"filtered_conflicts":[{"path":"src/app.ts","reason":"max_conflict_files_exceeded"}],"merge_base_sha":"a2d127e6a4d54bb7390de828a99e36411f0c84df","result":"merge_commit","source_branch":"feature/preview","source_tip_sha":"9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1","status":"conflicted","target_branch":"main","target_tip_sha":"c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"},"schema":{"additionalProperties":false,"description":"Read-only merge preview result, including clean or conflicted status and optional inline conflict content.","properties":{"conflict_paths":{"description":"Repository paths that conflicted during the merge preview.","items":{"type":"string"},"type":"array"},"conflicts":{"description":"Inline conflict content, populated only when include_content=true.","items":{"additionalProperties":false,"description":"Inline conflict content for a single conflicted repository path.","properties":{"base":{"additionalProperties":false,"description":"Base stage blob.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"},"ours":{"additionalProperties":false,"description":"Target branch stage blob.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"},"path":{"description":"Repository path for this conflict.","examples":["docs/conflict.txt"],"type":"string"},"result":{"additionalProperties":false,"description":"Best-effort merged blob content, usually with conflict markers for text conflicts.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"},"theirs":{"additionalProperties":false,"description":"Source branch stage blob.","properties":{"binary":{"description":"Whether the blob appears to be binary content.","examples":[false],"type":"boolean"},"content":{"description":"UTF-8 text content when available and not binary.","type":"string"},"oid":{"description":"Git object ID for this blob.","examples":["1111111111111111111111111111111111111111"],"type":"string"},"truncated":{"description":"Whether content was truncated by server-side limits.","examples":[false],"type":"boolean"}},"required":["truncated","binary"],"type":"object"}},"required":["path","result","base","ours","theirs"],"type":"object"},"type":"array"},"filtered_conflicts":{"description":"Conflicts omitted from inline content because of request or server limits.","items":{"additionalProperties":false,"description":"Conflict omitted from inline content because of request or server limits.","properties":{"path":{"description":"Repository path omitted from inline conflict content.","examples":["src/app.ts"],"type":"string"},"reason":{"description":"Reason the conflict content was omitted.","examples":["max_conflict_files_exceeded"],"type":"string"}},"required":["path","reason"],"type":"object"},"type":"array"},"merge_base_sha":{"description":"Merge base SHA used for the preview.","examples":["a2d127e6a4d54bb7390de828a99e36411f0c84df"],"type":"string"},"result":{"description":"Operation result if applied: merge_commit, fast_forward, or no_op.","enum":["merge_commit","fast_forward","no_op"],"examples":["merge_commit"],"type":"string"},"source_branch":{"description":"Source branch requested by the caller.","examples":["feature/preview"],"type":"string"},"source_tip_sha":{"description":"Resolved source branch tip SHA.","examples":["9eb378bdb5bf1944f6ba0bd5a2c4df3ce32f4df1"],"type":"string"},"status":{"description":"Preview status: clean or conflicted.","enum":["clean","conflicted"],"examples":["conflicted"],"type":"string"},"target_branch":{"description":"Target branch requested by the caller.","examples":["main"],"type":"string"},"target_tip_sha":{"description":"Resolved target branch tip SHA.","examples":["c4f0fdfc41adab56630b34f5f4fd4e84a2c5b4d2"],"type":"string"}},"required":["status","result","source_branch","target_branch","source_tip_sha","target_tip_sha","conflict_paths","conflicts"],"type":"object"}}},"description":"Merge preview result. Conflicted previews return HTTP 200 with `status=conflicted`; request and storage failures use normal HTTP errors."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Preview Merge","tags":["Branches"],"x-deprecation-message":"Use `/api/repos/{repo_name}/merge/preview` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/notes":{"delete":{"deprecated":true,"description":"Remove the Git note attached to a commit or other Git object SHA.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/notes` instead.","operationId":"notes_delete_legacy","requestBody":{"content":{"application/json":{"example":{"author":{"email":"review@example.com","name":"Review Bot"},"notes_ref":"refs/notes/commits","object_ref":"b003fc78805954584e1ee364a4ad39d7c79e819a","ref":"refs/notes/commits","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"},"schema":{"additionalProperties":false,"description":"Notes write request describing the commit, the action (`add`, `append`, or `remove`), the note content, and optional concurrency guard.","properties":{"action":{"default":"add","description":"add creates a note and fails if one already exists. append adds new text to the existing note body.","type":"string"},"author":{"additionalProperties":false,"description":"Author object with name and email for the notes commit.","properties":{"email":{"description":"Email address for the notes commit signature.","examples":["review@example.com"],"type":"string"},"name":{"description":"Display name for the notes commit signature.","examples":["Review Bot"],"type":"string"}},"required":["name","email"],"type":"object"},"expected_notes_ref_sha":{"description":"Optional compare-and-swap guard for the notes ref. Provide expected_notes_ref_sha or the deprecated expected_ref_sha.","type":"string"},"expected_ref_sha":{"deprecated":true,"description":"Deprecated: use expected_notes_ref_sha. Optional compare-and-swap guard for the notes ref.","type":"string"},"note":{"description":"Plain-text note content. Required for add and append.","type":"string"},"notes_ref":{"description":"Optional notes ref to target. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.","examples":["refs/notes/commits"],"type":"string"},"object_ref":{"description":"Git object the note attaches to. A full object SHA today. Provide object_ref or the deprecated sha.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"ref":{"deprecated":true,"description":"Deprecated: use notes_ref. Optional notes ref to target.","examples":["refs/notes/commits"],"type":"string"},"sha":{"deprecated":true,"description":"Deprecated: use object_ref. Git object SHA to attach the note to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"type":"object"}}},"description":"Delete the Git note for the supplied SHA. Set `ref` to target a notes ref other than refs/notes/commits; a bare name like `reviews` is accepted and placed under refs/notes/. `note` and `action` are ignored for `DELETE` requests.","required":true},"responses":{"201":{"content":{"application/json":{"example":{"base_commit":"0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492","new_ref_sha":"3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55","notes_ref":"refs/notes/commits","result":{"status":"ok","success":true},"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","target_ref":"refs/notes/commits"},"schema":{"additionalProperties":false,"description":"Result of a notes write operation, including the resulting notes ref state.","properties":{"base_commit":{"description":"Previous notes ref commit SHA.","examples":["0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492"],"type":"string"},"new_ref_sha":{"description":"New notes ref SHA after the operation.","examples":["3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55"],"type":"string"},"notes_ref":{"description":"The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"},"result":{"additionalProperties":false,"description":"Operation result with success, status, and optional message.","properties":{"message":{"description":"Optional human-readable message.","type":"string"},"status":{"description":"Status code (e.g. ok).","examples":["ok"],"type":"string"},"success":{"description":"Whether the operation succeeded.","examples":[true],"type":"boolean"}},"required":["success","status"],"type":"object"},"sha":{"description":"The commit SHA the note is attached to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"target_ref":{"deprecated":true,"description":"Deprecated: use notes_ref. The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"}},"required":["sha","notes_ref","target_ref","new_ref_sha","result"],"type":"object"}}},"description":"Note removed from the notes ref."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Note","tags":["Notes"],"x-deprecation-message":"Use `/api/repos/{repo_name}/notes` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"},"get":{"deprecated":true,"description":"Read the Git note attached to a commit or other Git object SHA. Notes let you store review status, handoff details, or other context without changing repository contents.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/notes` instead.","operationId":"notes_read_legacy","parameters":[{"description":"Git object whose note should be fetched. A full object SHA today. Provide object_ref or the deprecated sha.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"object_ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use object_ref instead. Git object SHA whose note should be fetched.","example":"b003fc78805954584e1ee364a4ad39d7c79e819a","in":"query","name":"sha","schema":{"type":"string"}},{"description":"Optional notes ref to read from. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.","example":"refs/notes/commits","in":"query","name":"notes_ref","schema":{"type":"string"}},{"deprecated":true,"description":"Deprecated: use notes_ref instead. Optional notes ref to read from. Defaults to refs/notes/commits.","example":"refs/notes/commits","in":"query","name":"ref","schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"example":{"note":"Reviewed. Ready for production.","ref_sha":"0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"},"schema":{"additionalProperties":false,"description":"A single Git note attached to a commit, including the current notes ref tip.","properties":{"note":{"description":"The note content.","examples":["Reviewed. Ready for production."],"type":"string"},"ref_sha":{"description":"Current SHA of the notes ref the note was read from.","examples":["0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492"],"type":"string"},"sha":{"description":"The commit SHA.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"required":["sha","note","ref_sha"],"type":"object"}}},"description":"The note stored for the requested Git object."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Get Note","tags":["Notes"],"x-deprecation-message":"Use `/api/repos/{repo_name}/notes` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"post":{"deprecated":true,"description":"Attach text to a Git object without changing the repository contents. Use notes for review markers, internal decisions, or other lightweight context.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/notes` instead.","operationId":"notes_write_legacy","requestBody":{"content":{"application/json":{"example":{"author":{"email":"review@example.com","name":"Review Bot"},"notes_ref":"refs/notes/commits","object_ref":"b003fc78805954584e1ee364a4ad39d7c79e819a","ref":"refs/notes/commits","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"},"examples":{"append_note":{"description":"Append new content to an existing note.","summary":"Append note","value":{"action":"append","author":{"email":"review@example.com","name":"Review Bot"},"note":"Deployment complete.","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"}},"create_note":{"description":"Create a new note on a commit.","summary":"Create note","value":{"action":"add","author":{"email":"review@example.com","name":"Review Bot"},"note":"Reviewed. Ready for production.","sha":"b003fc78805954584e1ee364a4ad39d7c79e819a"}}},"schema":{"additionalProperties":false,"description":"Notes write request describing the commit, the action (`add`, `append`, or `remove`), the note content, and optional concurrency guard.","properties":{"action":{"default":"add","description":"add creates a note and fails if one already exists. append adds new text to the existing note body.","type":"string"},"author":{"additionalProperties":false,"description":"Author object with name and email for the notes commit.","properties":{"email":{"description":"Email address for the notes commit signature.","examples":["review@example.com"],"type":"string"},"name":{"description":"Display name for the notes commit signature.","examples":["Review Bot"],"type":"string"}},"required":["name","email"],"type":"object"},"expected_notes_ref_sha":{"description":"Optional compare-and-swap guard for the notes ref. Provide expected_notes_ref_sha or the deprecated expected_ref_sha.","type":"string"},"expected_ref_sha":{"deprecated":true,"description":"Deprecated: use expected_notes_ref_sha. Optional compare-and-swap guard for the notes ref.","type":"string"},"note":{"description":"Plain-text note content. Required for add and append.","type":"string"},"notes_ref":{"description":"Optional notes ref to target. A bare name like reviews is placed under refs/notes/; a fully-qualified refs/notes/* ref is also accepted. Defaults to refs/notes/commits. Provide notes_ref or the deprecated ref.","examples":["refs/notes/commits"],"type":"string"},"object_ref":{"description":"Git object the note attaches to. A full object SHA today. Provide object_ref or the deprecated sha.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"ref":{"deprecated":true,"description":"Deprecated: use notes_ref. Optional notes ref to target.","examples":["refs/notes/commits"],"type":"string"},"sha":{"deprecated":true,"description":"Deprecated: use object_ref. Git object SHA to attach the note to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"}},"type":"object"}}},"description":"Create or append a Git note for the supplied SHA. `add` fails if a note already exists; use `append` to extend one. When `action` is omitted the server behaves as though `add` was supplied. Set `ref` to target a notes ref other than refs/notes/commits; a bare name like `reviews` is accepted and placed under refs/notes/.","required":true},"responses":{"201":{"content":{"application/json":{"example":{"base_commit":"0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492","new_ref_sha":"3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55","notes_ref":"refs/notes/commits","result":{"status":"ok","success":true},"sha":"b003fc78805954584e1ee364a4ad39d7c79e819a","target_ref":"refs/notes/commits"},"schema":{"additionalProperties":false,"description":"Result of a notes write operation, including the resulting notes ref state.","properties":{"base_commit":{"description":"Previous notes ref commit SHA.","examples":["0c8b5bb9d550d58fcfd651a4fdce8024ef7f1492"],"type":"string"},"new_ref_sha":{"description":"New notes ref SHA after the operation.","examples":["3a1d9f7d6b6d482c970554e2a6ef980ecf4f1d55"],"type":"string"},"notes_ref":{"description":"The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"},"result":{"additionalProperties":false,"description":"Operation result with success, status, and optional message.","properties":{"message":{"description":"Optional human-readable message.","type":"string"},"status":{"description":"Status code (e.g. ok).","examples":["ok"],"type":"string"},"success":{"description":"Whether the operation succeeded.","examples":[true],"type":"boolean"}},"required":["success","status"],"type":"object"},"sha":{"description":"The commit SHA the note is attached to.","examples":["b003fc78805954584e1ee364a4ad39d7c79e819a"],"type":"string"},"target_ref":{"deprecated":true,"description":"Deprecated: use notes_ref. The notes ref the operation updates.","examples":["refs/notes/commits"],"type":"string"}},"required":["sha","notes_ref","target_ref","new_ref_sha","result"],"type":"object"}}},"description":"Note update applied to the notes ref."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create or Append Note","tags":["Notes"],"x-deprecation-message":"Use `/api/repos/{repo_name}/notes` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/notes/refs":{"get":{"deprecated":true,"description":"List Git notes refs under a notes ref prefix with cursor pagination. Use this to discover custom notes namespaces before reading individual notes.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/notes/refs` instead.","operationId":"list_notes_refs_legacy","parameters":[{"description":"Notes ref prefix to enumerate. A bare prefix like reviews is placed under refs/notes/; a fully-qualified refs/notes/* prefix is also accepted. Defaults to refs/notes/.","example":"reviews/","in":"query","name":"prefix","schema":{"type":"string"}},{"description":"Pagination cursor returned by a previous `list_notes_refs` response.","example":"refs/notes/reviews/session-b","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of notes refs to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"next_cursor":"refs/notes/reviews/session-b","prefix":"refs/notes/reviews/","refs":[{"cursor":"refs/notes/reviews/session-a","ref":"refs/notes/reviews/session-a","sha":"a1b2c3d4e5f6"}]},"schema":{"additionalProperties":false,"description":"Paginated list of Git notes refs under the requested prefix.","properties":{"has_more":{"description":"Whether more notes refs exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["refs/notes/reviews/session-b"],"type":"string"},"prefix":{"description":"Normalized notes ref prefix used for the listing.","examples":["refs/notes/reviews/"],"type":"string"},"refs":{"description":"List of notes refs.","items":{"additionalProperties":false,"description":"Git notes ref entry including its full ref name and current tip SHA.","properties":{"cursor":{"description":"Opaque pagination token for this notes ref entry.","examples":["refs/notes/reviews/session-a"],"type":"string"},"ref":{"description":"Full notes ref name.","examples":["refs/notes/reviews/session-a"],"type":"string"},"sha":{"description":"Current tip SHA stored in the notes ref.","examples":["a1b2c3d4e5f6"],"type":"string"}},"required":["cursor","ref","sha"],"type":"object"},"type":"array"}},"required":["refs","has_more","prefix"],"type":"object"}}},"description":"Notes refs in lexical order."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Notes Refs","tags":["Notes"],"x-deprecation-message":"Use `/api/repos/{repo_name}/notes/refs` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/pull-upstream":{"post":{"deprecated":true,"description":"Trigger a sync from the configured upstream for the repository in the JWT `repo` claim. This only works for repositories that were created with an upstream `base_repo`.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/pull-upstream` instead.","operationId":"pull_upstream_legacy","requestBody":{"content":{"application/json":{"example":{"ref":"main"},"schema":{"additionalProperties":false,"description":"Optional parameters for triggering a sync from the configured upstream.","properties":{"after":{"description":"Optional opaque token from a previous pull-upstream response. Reserved for compatibility with future incremental syncs.","type":"string"},"ref":{"description":"Optional branch or tag to pull from the configured upstream. Defaults to the repository's tracked default branch.","examples":["main"],"type":"string"}},"type":"object"}}},"description":"Optional sync hints. Most callers can omit the body entirely and simply trigger the next upstream pull."},"responses":{"202":{"content":{"application/json":{"example":{"message":"Repository sync initiated successfully"},"schema":{"additionalProperties":false,"description":"Acknowledgement that an upstream sync has been initiated; the sync itself runs asynchronously.","properties":{"message":{"description":"Human-readable status message.","examples":["Repository sync initiated successfully"],"type":"string"}},"required":["message"],"type":"object"}}},"description":"Sync trigger accepted. The repository sync runs asynchronously."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Pull Upstream","tags":["Repositories"],"x-deprecation-message":"Use `/api/repos/{repo_name}/pull-upstream` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/reset-commits":{"post":{"deprecated":true,"description":"Create a new commit that resets a branch back to a specific commit SHA while preserving normal Git history.\n\nThis is an alias of `restore-commit` and is served by the same handler; prefer `restore-commit` for new integrations. A successful reset responds with `201 Created`. Ref-level outcomes are reported in `result.status` and `result.success`, not by the status code alone, and failures raised by the restore itself come back in that same restore-result body. The problem-details schemas below describe gateway-level rejections such as `401`, `403` and `429`.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/reset-commits` instead.","operationId":"reset_commits_legacy","requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"base_ref\":\"abc123def4567890abc123def4567890abc123de\",\"expected_target_sha\":\"0123456789abcdef0123456789abcdef01234567\",\"commit_message\":\"Reset branch\",\"author\":{\"name\":\"Docs Bot\",\"email\":\"docs@example.com\"}}}\n","schema":{"description":"NDJSON stream containing one `metadata` object.","type":"string"}}},"description":"Send a single NDJSON metadata line describing the branch to restore and the commit SHA to restore it to. The handler requires this line and rejects an empty body with `400`, even though the published contract leaves it optional."},"responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Documented for backwards compatibility with clients written against the original `reset-commits` contract. Successful resets return `201 Created`; see the `201` response."},"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Restore commit created and the branch reset. This is the status a successful reset returns."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"example":{"commit":null,"result":{"branch":"","message":"branch already matches target commit","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Storage rejected the restore because the branch cannot move as requested: the branch already points at `base_ref`, the restore would produce no change, or `base_ref` is not an ancestor of the current tip. The body carries the restore result with `result.status` set to `precondition_failed`."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Reset Branch to Commit","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/reset-commits` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/restore-commit":{"post":{"deprecated":true,"description":"Create a new commit that resets a branch back to a specific commit SHA while preserving normal Git history.\n\nRef-level outcomes are reported in `result.status` and `result.success`, not by the status code alone, and failures raised by the restore itself come back in that same restore-result body. The problem-details schemas below describe gateway-level rejections such as `401`, `403` and `429`.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/restore-commit` instead.","operationId":"restore_commit_legacy","requestBody":{"content":{"application/x-ndjson":{"example":"{\"metadata\":{\"target_branch\":\"main\",\"base_ref\":\"abc123def4567890abc123def4567890abc123de\",\"expected_target_sha\":\"0123456789abcdef0123456789abcdef01234567\",\"commit_message\":\"Reset branch\",\"author\":{\"name\":\"Docs Bot\",\"email\":\"docs@example.com\"}}}\n","schema":{"description":"NDJSON stream containing one `metadata` object.","type":"string"}}},"description":"Send a single NDJSON metadata line describing the branch to restore and the commit SHA to restore it to.","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Restore commit created successfully."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"412":{"content":{"application/json":{"example":{"commit":null,"result":{"branch":"","message":"branch already matches target commit","new_sha":"","old_sha":"","status":"precondition_failed","success":false}},"schema":{"additionalProperties":false,"description":"Result of a restore commit operation, including the created commit and the branch update.","properties":{"commit":{"additionalProperties":false,"description":"Created restore commit metadata.","properties":{"commit_sha":{"description":"SHA of the new restore commit.","type":"string"},"pack_bytes":{"description":"Size of the generated pack in bytes.","format":"int64","minimum":0,"type":"integer"},"target_branch":{"description":"Branch that was reset.","type":"string"},"tree_sha":{"description":"Tree SHA of the restore commit.","type":"string"}},"required":["commit_sha","tree_sha","target_branch","pack_bytes"],"type":"object"},"result":{"additionalProperties":false,"description":"Branch update result.","properties":{"branch":{"deprecated":true,"description":"Deprecated: use target_branch. The branch the restore updates.","type":"string"},"message":{"description":"Optional human-readable message.","type":"string"},"new_sha":{"description":"New tip SHA after restore.","type":"string"},"old_sha":{"description":"Previous tip SHA before restore (40-char hex; zeros when the ref did not previously exist).","type":"string"},"status":{"description":"Status code (ok, conflict, precondition_failed, etc.).","type":"string"},"success":{"description":"Whether the restore succeeded.","type":"boolean"},"target_branch":{"description":"The branch the restore updates.","type":"string"}},"required":["target_branch","branch","old_sha","new_sha","success","status"],"type":"object"}},"required":["commit","result"],"type":"object"}}},"description":"Storage rejected the restore because the branch cannot move as requested: the branch already points at `base_ref`, the restore would produce no change, or `base_ref` is not an ancestor of the current tip. The body carries the restore result with `result.status` set to `precondition_failed`."},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Restore Commit","tags":["Commits"],"x-deprecation-message":"Use `/api/repos/{repo_name}/restore-commit` instead.","x-permission-scopes":["git:write"],"x-requires-repo-scope":true,"x-stability":"stable"}},"/api/v1/repos/tags":{"delete":{"deprecated":true,"description":"Delete a tag from the repository. The server resolves the stored ref correctly for both lightweight and annotated tags.\n#### JWT claims\nRequired scopes: `git:read`, `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/tags/{tag_name}` instead.","operationId":"delete_tag_legacy","requestBody":{"content":{"application/json":{"example":{"name":"v1.0.0"},"schema":{"additionalProperties":false,"description":"Tag deletion request identifying the tag to remove.","properties":{"name":{"description":"Tag name to delete. Must not start with refs/.","examples":["v1.0.0"],"type":"string"}},"required":["name"],"type":"object"}}},"description":"Delete a lightweight or annotated tag by name.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"message":"tag deleted","name":"v1.0.0"},"schema":{"additionalProperties":false,"description":"Result of deleting a tag.","properties":{"message":{"description":"Human-readable result message.","examples":["tag deleted"],"type":"string"},"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"}},"required":["name","message"],"type":"object"}}},"description":"Tag deletion result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Delete Tag","tags":["Tags"],"x-deprecation-message":"Use `/api/repos/{repo_name}/tags/{tag_name}` instead.","x-permission-scopes":["git:read","git:write"],"x-request-validation-profile":"delete_tag","x-requires-repo-scope":true,"x-stability":"stable"},"get":{"deprecated":true,"description":"List tags in lexical order with cursor pagination. The returned `sha` is the dereferenced commit SHA, even for annotated tags.\n#### JWT claims\nRequired scopes: `git:read`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/tags` instead.","operationId":"list_tags_legacy","parameters":[{"description":"Pagination cursor returned by a previous `list_tags` response.","example":"t_def456","in":"query","name":"cursor","schema":{"type":"string"}},{"description":"Maximum number of tags to return. Defaults to 20.","example":20,"in":"query","name":"limit","schema":{"default":20,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"example":{"has_more":true,"next_cursor":"t_def456","tags":[{"cursor":"t_abc123","name":"v1.0.0","sha":"a1b2c3d4e5f6"}]},"schema":{"additionalProperties":false,"description":"Paginated list of tags for the repository.","properties":{"has_more":{"description":"Whether more tags exist.","examples":[true],"type":"boolean"},"next_cursor":{"description":"Opaque cursor for the next page (absent when no more results).","examples":["t_def456"],"type":"string"},"tags":{"description":"List of tag objects.","items":{"additionalProperties":false,"description":"Tag summary entry.","properties":{"cursor":{"description":"Opaque pagination token for this tag entry.","examples":["t_abc123"],"type":"string"},"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"},"sha":{"description":"Dereferenced commit SHA for the tag.","examples":["a1b2c3d4e5f6"],"type":"string"}},"required":["cursor","name","sha"],"type":"object"},"type":"array"}},"required":["tags","has_more"],"type":"object"}}},"description":"Repository tags in lexical order."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"List Tags","tags":["Tags"],"x-deprecation-message":"Use `/api/repos/{repo_name}/tags` instead.","x-permission-scopes":["git:read"],"x-requires-repo-scope":true,"x-stability":"stable"},"post":{"deprecated":true,"description":"Create a lightweight tag pointing to a specific commit. Annotated tags are not created through this endpoint.\n#### JWT claims\nRequired scopes: `git:write`  \nRequires per repo scope: Yes\n\nDeprecated: Use `/api/repos/{repo_name}/tags` instead.","operationId":"create_tag_legacy","requestBody":{"content":{"application/json":{"example":{"name":"v1.0.0","ref":"main","target":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"},"schema":{"additionalProperties":false,"description":"Create-tag request body describing the new tag and the commit it points to.","properties":{"name":{"description":"Tag name. Must be a valid Git ref name and must not start with refs/.","examples":["v1.0.0"],"type":"string"},"ref":{"description":"Branch, tag, or commit the tag should point to. Provide ref or the deprecated target.","examples":["main"],"type":"string"},"target":{"deprecated":true,"description":"Deprecated: use ref. Commit the tag should point to.","examples":["a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"],"type":"string"}},"required":["name"],"type":"object"}}},"description":"Create a lightweight tag that points to an exact commit SHA.","required":true},"responses":{"200":{"content":{"application/json":{"example":{"message":"tag created","name":"v1.0.0","sha":"a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"},"schema":{"additionalProperties":false,"description":"Result of creating a tag.","properties":{"message":{"description":"Human-readable result message.","examples":["tag created"],"type":"string"},"name":{"description":"Tag name.","examples":["v1.0.0"],"type":"string"},"sha":{"description":"Commit SHA the tag points to.","examples":["a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2"],"type":"string"}},"required":["name","sha","message"],"type":"object"}}},"description":"Tag creation result."},"400":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Bad Request"},"401":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Conflict"},"429":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Too Many Requests"},"500":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Internal Server Error"},"503":{"content":{"application/json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}},"application/problem+json":{"schema":{"additionalProperties":false,"description":"RFC 9457-compatible problem details payload describing the error response.","properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","type":"string"},"error":{"description":"Legacy compatibility field mirroring `detail` for older clients.","type":"string"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","type":"string"},"status":{"description":"The HTTP status code generated by the origin server for this occurrence of the problem.","format":"int64","type":"integer"},"title":{"description":"A short, human-readable summary of the problem type.","type":"string"},"type":{"description":"A URI reference that identifies the problem type. `about:blank` indicates the generic HTTP status semantics apply.","type":"string"}},"required":["type","title","status"],"type":"object"}}},"description":"Service Unavailable"}},"security":[{"bearerAuth":[]}],"summary":"Create Tag","tags":["Tags"],"x-deprecation-message":"Use `/api/repos/{repo_name}/tags` instead.","x-permission-scopes":["git:write"],"x-request-validation-profile":"create_tag","x-requires-repo-scope":true,"x-stability":"stable"}}},"servers":[{"description":"Code Storage tenant cluster","url":"https://api.{cluster}.code.storage","variables":{"cluster":{"default":"cluster","description":"Tenant cluster identifier (e.g. pierre-dev, pierre-staging, pierre-prod)."}}}],"tags":[{"description":"Create, inspect, update, delete, and synchronise repositories, including upstream pull-sync and generic HTTPS Git credentials for non-GitHub upstreams.","name":"Repositories"},{"description":"Create, delete, list, and compare branches.","name":"Branches"},{"description":"Read commit metadata and diffs, or create commits without a local Git client.","name":"Commits"},{"description":"Read repository trees, file contents, archives, and server-side search results.","name":"Files"},{"description":"List, create, and delete Git tags.","name":"Tags"},{"description":"Attach and retrieve Git notes for commits or other Git objects.","name":"Notes"}]}