# Puntos de conexión de la API de REST para reglas

Usa la API REST para administrar conjuntos de reglas para una empresa. Los conjuntos de reglas controlan cómo las personas pueden interactuar con repositorios y código.

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