Delete a file

Deletes a file in a repository. You can provide an additional `committer` parameter, which is an object containing information about the committer. Or, you can provide an `author` parameter, which is an object containing information about the author. The `author` section is optional and is filled in with the `committer` information if omitted. If the `committer` information is omitted, the authenticated user's information is used. You must provide values for both `name` and `email`, whether you choose to use `author` or `committer`. Otherwise, you'll receive a `422` status code.

DELETE/repos/{owner}/{repo}/contents/{path}

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

Request

Path Parameters

owner string required
repo string required
path string required: path parameter

Body Params

required

application/jsonobject

author object

optional

object containing information about the author.

email string

optional

The email of the author (or committer) of the commit

name string

optional

The name of the author (or committer) of the commit

branch string

optional

The branch name. Default: the repository’s default branch (usually `master`)

committer object

optional

object containing information about the committer.

email string

optional

The email of the author (or committer) of the commit

name string

optional

The name of the author (or committer) of the commit

message string

required

The commit message.

sha string

required

The blob SHA of the file being replaced.

Responses

application/json File Commit object

Response

commit object

required

author object

optional

date string

optional

email string

optional

name string

optional

committer object

optional

date string

optional

email string

optional

name string

optional

html_url string

optional

message string

optional

node_id string

optional

parents array[object]

optional

items object

html_url string

optional

sha string

optional

url string

optional

sha string

optional

tree object

optional

sha string

optional

url string

optional

url string

optional

verification object

optional

payload string

optionalnullable

reason string

optional

signature string

optionalnullable

verified boolean

optional

content object

requirednullable

_links object

optional

git string

optional

html string

optional

self string

optional

download_url string

optional

git_url string

optional

html_url string

optional

name string

optional

path string

optional

sha string

optional

size integer

optional

type string

optional

url string

optional

Response Example: 200 application/json

{
  "commit": {
    "author": {
      "date": "2014-11-07T22:01:45Z",
      "email": "[email protected]",
      "name": "Monalisa Octocat"
    },
    "committer": {
      "date": "2014-11-07T22:01:45Z",
      "email": "[email protected]",
      "name": "Monalisa Octocat"
    },
    "html_url": "https://github.com/octocat/Hello-World/git/commit/7638417db6d59f3c431d3e1f261cc637155684cd",
    "message": "my commit message",
    "node_id": "MDY6Q29tbWl0NzYzODQxN2RiNmQ1OWYzYzQzMWQzZTFmMjYxY2M2MzcxNTU2ODRjZA==",
    "parents": [
      {
        "html_url": "https://github.com/octocat/Hello-World/git/commit/1acc419d4d6a9ce985db7be48c6349a0475975b5",
        "sha": "1acc419d4d6a9ce985db7be48c6349a0475975b5",
        "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/1acc419d4d6a9ce985db7be48c6349a0475975b5"
      }
    ],
    "sha": "7638417db6d59f3c431d3e1f261cc637155684cd",
    "tree": {
      "sha": "691272480426f78a0138979dd3ce63b77f706feb",
      "url": "https://api.github.com/repos/octocat/Hello-World/git/trees/691272480426f78a0138979dd3ce63b77f706feb"
    },
    "url": "https://api.github.com/repos/octocat/Hello-World/git/commits/7638417db6d59f3c431d3e1f261cc637155684cd",
    "verification": {
      "payload": null,
      "reason": "unsigned",
      "signature": null,
      "verified": false
    }
  },
  "content": null
}

application/json Basic Error object

Resource not found

documentation_url string

optional

message string

optional

status string

optional

url string

optional

application/json Basic Error object

Conflict

documentation_url string

optional

message string

optional

status string

optional

url string

optional

application/json Validation Error object

Validation failed

documentation_url string

required

errors array[object]

optional

items object

code string

required

field string

optional

index integer

optional

message string

optional

resource string

optional

value

optional

message string

required

application/json object

Service unavailable

code string

optional

documentation_url string

optional

message 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 *

path *

path parameter

Request Sample: Shell / cURL

curl --request DELETE \
  --url {protocol}://{hostname}/api/v3/repos/{owner}/{repo}/contents/{path} \
  --header 'content-type: application/json' \
  --data '{
  "committer": {
    "email": "[email protected]",
    "name": "Monalisa Octocat"
  },
  "message": "my commit message",
  "sha": "329688480d39049927147c162b9d2deaf885005f"
}'