# Pontos de extremidade da API REST para regras

Use a API REST para gerenciar conjuntos de regras para uma empresa. Os conjuntos de regras controlam como as pessoas podem interagir com repositórios e 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