# Git LFS 的 REST API 端点

使用 REST API 为存储库启用或禁用 Git 大型文件存储 （LFS）。

## 关于 Git LFS

可用于 Git LFS 在 Git 存储库中存储大型文件。 使用 REST API 可以为单个存储库启用或禁用该功能。 有关 Git LFS 的详细信息，请参阅 [关于 Git 大文件存储系统](/zh/enterprise-server@3.22/repositories/working-with-files/managing-large-files/about-git-large-file-storage)。

对存储库具有管理员权限的人员可以使用这些终结点。

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.

## Enable Git LFS for a repository

```
PUT /repos/{owner}/{repo}/lfs
```

Enables Git LFS for a repository.
OAuth app tokens and personal access tokens (classic) need the site\_admin scope to use this endpoint.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **202** - Accepted

* **403** - We will return a 403 with one of the following messages:

Git LFS support not enabled because Git LFS is globally disabled.
Git LFS support not enabled because Git LFS is disabled for the root repository in the network.
Git LFS support not enabled because Git LFS is disabled for .

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X PUT \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/lfs
```

**Response schema (Status: 202):**

object

## Disable Git LFS for a repository

```
DELETE /repos/{owner}/{repo}/lfs
```

Disables Git LFS for a repository.
OAuth app tokens and personal access tokens (classic) need the site\_admin scope to use this endpoint.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

### HTTP response status codes

* **204** - No Content

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X DELETE \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/lfs
```

**Response schema (Status: 204):**