Sample - GitHub REST API
GET/orgs/{org}/rulesets/{ruleset_id}/history

List organization ruleset history

Lists historical versions of an organization ruleset. Use org and ruleset_id to identify the ruleset, and use page and per_page to paginate the results.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

4 parameters
orgstringrequired
The organization name; matching is not case sensitive.
ruleset_idintegerrequired
The integer identifier of the organization ruleset.
per_pageintegeroptional
The number of results to return per page, up to 100. Defaults to 30 when omitted.
Default:30
pageintegeroptional
The page number to retrieve. Defaults to 1 when omitted.
Default:1

3 status codes
200Returns an array of historical ruleset versions, including each version's `version_id`, updating `actor`, and `updated_at` timestamp.
version_idintegerrequired
The ID of the previous version of the ruleset
actorobjectrequired
The actor who updated the ruleset
updated_atstringrequired
404Returned when the organization or ruleset cannot be found.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional
500Returned when an internal server error occurs.
messagestringoptional
documentation_urlstringoptional
urlstringoptional
statusstringoptional

Error handling

A 404 is returned when the organization or ruleset cannot be found. A 500 is returned when an internal error occurs. ruleset_id must be an integer, per_page must not exceed 100, and page and per_page control pagination.