GET/repos/{owner}/{repo}/rulesets/{ruleset_id}/history

List repository ruleset history

Lists historical versions of a repository ruleset. Use ruleset_id to select the ruleset and page and per_page to navigate its history. Each result identifies the version, the actor who updated it, and the update time.

5 parameters
ownerstringrequired
The account owner of the repository. The name is not case sensitive.
repostringrequired
The repository name without the `.git` extension. The name is not case sensitive.
ruleset_idintegerrequired
The ID of the ruleset whose history to retrieve.
per_pageintegeroptional
The number of results per page, up to 100. Defaults to 30 when omitted.
Default:30
pageintegeroptional
The page number of results to fetch. Defaults to 1 when omitted.
Default:1

3 status codes
200Returns an array of historical ruleset versions, each including its version ID, the actor who updated it, and the update time.
version_idintegerrequired
The ID of the previous version of the ruleset
actorobjectrequired
The actor who updated the ruleset
updated_atstringrequired
404Returned when the repository or ruleset cannot be found.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
500Returned when an internal error occurs.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 404 is returned when the owner path parameter and repo path parameter do not identify a repository, or the ruleset_id path parameter does not identify a ruleset in that repository. A 500 indicates an internal error. per_page accepts at most 100 results; Use page and per_page to paginate the results.