Delete a repository

Deleting a repository requires admin access. If OAuth is used, the `delete_repo` scope is required. If an organization owner has configured the organization to prevent members from deleting organization-owned repositories, you will get a `403 Forbidden` response.

DELETE/repos/{owner}/{repo}

Source: github-v3-rest.json
Revision: f5f067c1e6f6
Active snapshot: 85e53e3d0d65

Request

Path Parameters

owner string required
repo string required

Responses

Response

application/json Basic Error object

Temporary Redirect

documentation_url string

optional

message string

optional

status string

optional

url string

optional

application/json object

If an organization owner has configured the organization to prevent members from deleting organization-owned repositories, a member will get this response:

documentation_url string

optional

message string

optional

Response Example: 403 application/json

{
  "documentation_url": "https://docs.github.com/[email protected]/rest/reference/repos#delete-a-repository",
  "message": "Organization members cannot delete repositories."
}

application/json Basic Error object

Resource not found

documentation_url string

optional

message string

optional

status string

optional

url string

optional

Request configuration

This OpenAPI document does not declare an authentication scheme. Check the API provider's documentation before sending credentials; Manja cannot infer or validate an undocumented scheme.

Common bearer example: Authorization: Bearer YOUR_ACCESS_TOKEN

hostname

Self-hosted Enterprise Server or Enterprise Cloud hostname

protocol

Self-hosted Enterprise Server or Enterprise Cloud protocol

owner *

repo *

Request Sample: Shell / cURL

curl --request DELETE \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}