# Points de terminaison d’API REST pour les règles

Utilisez l’API REST pour gérer les ensembles de règles pour une entreprise. Les ensembles de règles contrôlent la façon dont les utilisateurs peuvent interagir avec les référentiels et le code.

> [!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.

## Get enterprise ruleset history

```
GET /enterprises/{enterprise}/rulesets/{ruleset_id}/history
```

Get the history of an enterprise ruleset.

### Parameters

#### Headers

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

#### Path and query parameters

- **`enterprise`** (string) (required)
  The slug version of the enterprise name.

- **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

- **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

- **`ruleset_id`** (integer) (required)
  The ID of the ruleset.

### HTTP response status codes

- **200** - OK

- **404** - Resource not found

- **500** - Internal Error

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/rulesets/RULESET_ID/history
```

**Response schema (Status: 200):**

Array of `Ruleset version`:
  * `version_id`: required, integer
  * `actor`: required, object:
    * `id`: integer
    * `type`: string
  * `updated_at`: required, string, format: date-time

## Get enterprise ruleset version

```
GET /enterprises/{enterprise}/rulesets/{ruleset_id}/history/{version_id}
```

Get a version of an enterprise ruleset.

### Parameters

#### Headers

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

#### Path and query parameters

- **`enterprise`** (string) (required)
  The slug version of the enterprise name.

- **`ruleset_id`** (integer) (required)
  The ID of the ruleset.

- **`version_id`** (integer) (required)
  The ID of the version

### HTTP response status codes

- **200** - OK

- **404** - Resource not found

- **500** - Internal Error

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/rulesets/RULESET_ID/history/VERSION_ID
```

**Response schema (Status: 200):**

* all of:
  * **Ruleset version**
    * `version_id`: required, integer
    * `actor`: required, object:
      * `id`: integer
      * `type`: string
    * `updated_at`: required, string, format: date-time
  * **object**
    * `state`: required, object