{"meta":{"title":"REST-API-Endpunkte für Überprüfungsausführungen","intro":"Verwende die REST-API, um Testausführungen zu verwalten.","product":"REST-API","breadcrumbs":[{"href":"/de/rest","title":"REST-API"},{"href":"/de/rest/checks","title":"Prüfungen"},{"href":"/de/rest/checks/runs","title":"Prüfläufe"}],"documentType":"article"},"body":"# REST-API-Endpunkte für Überprüfungsausführungen\n\nVerwende die REST-API, um Testausführungen zu verwalten.\n\n> \\[!NOTE]\n> Schreibberechtigungen für die REST-API zur Interaktion mit Überprüfungen sind nur für GitHub Apps verfügbar. OAuth apps und authentifizierte Benutzer können die Überprüfungsausführungen und Überprüfungssammlungen anzeigen, aber nicht erstellen. Wenn Sie keine GitHub App erstellent, könnten Sie die Verwendung der REST-API zur Interaktion mit [Commitstatus](/de/rest/commits#commit-statuses) interessieren.\n\n> \\[!NOTE]\n> 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.\n\n## Create a check run\n\n```\nPOST /repos/{owner}/{repo}/check-runs\n```\n\nCreates a new check run for a specific commit in a repository.\nTo create a check run, you must use a GitHub App. OAuth apps and authenticated users are not able to create a check suite.\nIn a check suite, GitHub limits the number of check runs with the same name to 1000. Once these check runs exceed 1000, GitHub will start to automatically delete older check runs.\nNote\n\nThe Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull\\_requests array.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n#### Body parameters\n\n* **`status`** (string) (required)\n  Can be one of: `completed`\n\n### HTTP response status codes\n\n* **201** - Created\n\n### Code examples\n\n#### Example of an in\\_progress conclusion\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  https://api.github.com/repos/OWNER/REPO/check-runs \\\n  -d '{\n  \"name\": \"mighty_readme\",\n  \"head_sha\": \"ce587453ced02b1526dfb4cb910479d431683101\",\n  \"status\": \"in_progress\",\n  \"external_id\": \"42\",\n  \"started_at\": \"2018-05-04T01:14:52Z\",\n  \"output\": {\n    \"title\": \"Mighty Readme report\",\n    \"summary\": \"\",\n    \"text\": \"\"\n  }\n}'\n```\n\n**Response schema (Status: 201):**\n\n* `id`: required, integer, format: int64\n* `head_sha`: required, string\n* `node_id`: required, string\n* `external_id`: required, string or null\n* `url`: required, string\n* `html_url`: required, string or null\n* `details_url`: required, string or null\n* `status`: required, string, enum: `queued`, `in_progress`, `completed`, `waiting`, `requested`, `pending`\n* `conclusion`: required, string or null, enum: `success`, `failure`, `neutral`, `cancelled`, `skipped`, `timed_out`, `action_required`, `null`\n* `started_at`: required, string or null, format: date-time\n* `completed_at`: required, string or null, format: date-time\n* `output`: required, object:\n  * `title`: required, string or null\n  * `summary`: required, string or null\n  * `text`: required, string or null\n  * `annotations_count`: required, integer\n  * `annotations_url`: required, string, format: uri\n* `name`: required, string\n* `check_suite`: required, object or null:\n  * `id`: required, integer\n* `app`: required, any of:\n  * **null**\n  * **GitHub app**\n    * `id`: required, integer\n    * `slug`: string\n    * `node_id`: required, string\n    * `client_id`: string\n    * `owner`: required, one of:\n      * **Simple User**\n        * `name`: string or null\n        * `email`: string or null\n        * `login`: required, string\n        * `id`: required, integer, format: int64\n        * `node_id`: required, string\n        * `avatar_url`: required, string, format: uri\n        * `gravatar_id`: required, string or null\n        * `url`: required, string, format: uri\n        * `html_url`: required, string, format: uri\n        * `followers_url`: required, string, format: uri\n        * `following_url`: required, string\n        * `gists_url`: required, string\n        * `starred_url`: required, string\n        * `subscriptions_url`: required, string, format: uri\n        * `organizations_url`: required, string, format: uri\n        * `repos_url`: required, string, format: uri\n        * `events_url`: required, string\n        * `received_events_url`: required, string, format: uri\n        * `type`: required, string\n        * `site_admin`: required, boolean\n        * `starred_at`: string\n        * `user_view_type`: string\n      * **Enterprise**\n        * `description`: string or null\n        * `html_url`: required, string, format: uri\n        * `website_url`: string or null, format: uri\n        * `id`: required, integer\n        * `node_id`: required, string\n        * `name`: required, string\n        * `slug`: required, string\n        * `created_at`: required, string or null, format: date-time\n        * `updated_at`: required, string or null, format: date-time\n        * `avatar_url`: required, string, format: uri\n    * `name`: required, string\n    * `description`: required, string or null\n    * `external_url`: required, string, format: uri\n    * `html_url`: required, string, format: uri\n    * `created_at`: required, string, format: date-time\n    * `updated_at`: required, string, format: date-time\n    * `permissions`: required, object, additional properties: string:\n      * `issues`: string\n      * `checks`: string\n      * `metadata`: string\n      * `contents`: string\n      * `deployments`: string\n    * `events`: required, array of string\n    * `installations_count`: integer\n* `pull_requests`: required, array of `Pull Request Minimal`:\n  * `id`: required, integer, format: int64\n  * `number`: required, integer\n  * `url`: required, string\n  * `head`: required, object:\n    * `ref`: required, string\n    * `sha`: required, string\n    * `repo`: required, object:\n      * `id`: required, integer, format: int64\n      * `url`: required, string\n      * `name`: required, string\n  * `base`: required, object:\n    * `ref`: required, string\n    * `sha`: required, string\n    * `repo`: required, object:\n      * `id`: required, integer, format: int64\n      * `url`: required, string\n      * `name`: required, string\n* `deployment`: `Deployment`:\n  * `url`: required, string, format: uri\n  * `id`: required, integer\n  * `node_id`: required, string\n  * `task`: required, string\n  * `original_environment`: string\n  * `environment`: required, string\n  * `description`: required, string or null\n  * `created_at`: required, string, format: date-time\n  * `updated_at`: required, string, format: date-time\n  * `statuses_url`: required, string, format: uri\n  * `repository_url`: required, string, format: uri\n  * `transient_environment`: boolean\n  * `production_environment`: boolean\n  * `performed_via_github_app`: any of:\n    * **null**\n    * **GitHub app**\n      * `id`: required, integer\n      * `slug`: string\n      * `node_id`: required, string\n      * `client_id`: string\n      * `owner`: required, one of:\n        * **Simple User**\n          * `name`: string or null\n          * `email`: string or null\n          * `login`: required, string\n          * `id`: required, integer, format: int64\n          * `node_id`: required, string\n          * `avatar_url`: required, string, format: uri\n          * `gravatar_id`: required, string or null\n          * `url`: required, string, format: uri\n          * `html_url`: required, string, format: uri\n          * `followers_url`: required, string, format: uri\n          * `following_url`: required, string\n          * `gists_url`: required, string\n          * `starred_url`: required, string\n          * `subscriptions_url`: required, string, format: uri\n          * `organizations_url`: required, string, format: uri\n          * `repos_url`: required, string, format: uri\n          * `events_url`: required, string\n          * `received_events_url`: required, string, format: uri\n          * `type`: required, string\n          * `site_admin`: required, boolean\n          * `starred_at`: string\n          * `user_view_type`: string\n        * **Enterprise**\n          * `description`: string or null\n          * `html_url`: required, string, format: uri\n          * `website_url`: string or null, format: uri\n          * `id`: required, integer\n          * `node_id`: required, string\n          * `name`: required, string\n          * `slug`: required, string\n          * `created_at`: required, string or null, format: date-time\n          * `updated_at`: required, string or null, format: date-time\n          * `avatar_url`: required, string, format: uri\n      * `name`: required, string\n      * `description`: required, string or null\n      * `external_url`: required, string, format: uri\n      * `html_url`: required, string, format: uri\n      * `created_at`: required, string, format: date-time\n      * `updated_at`: required, string, format: date-time\n      * `permissions`: required, object, additional properties: string:\n        * `issues`: string\n        * `checks`: string\n        * `metadata`: string\n        * `contents`: string\n        * `deployments`: string\n      * `events`: required, array of string\n      * `installations_count`: integer\n\n#### Example of a completed conclusion\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  https://api.github.com/repos/OWNER/REPO/check-runs \\\n  -d '{\n  \"name\": \"mighty_readme\",\n  \"head_sha\": \"ce587453ced02b1526dfb4cb910479d431683101\",\n  \"status\": \"completed\",\n  \"started_at\": \"2017-11-30T19:39:10Z\",\n  \"conclusion\": \"success\",\n  \"completed_at\": \"2017-11-30T19:49:10Z\",\n  \"output\": {\n    \"title\": \"Mighty Readme report\",\n    \"summary\": \"There are 0 failures, 2 warnings, and 1 notices.\",\n    \"text\": \"You may have some misspelled words on lines 2 and 4. You also may want to add a section in your README about how to install your app.\",\n    \"annotations\": [\n      {\n        \"path\": \"README.md\",\n        \"annotation_level\": \"warning\",\n        \"title\": \"Spell Checker\",\n        \"message\": \"Check your spelling for 'banaas'.\",\n        \"raw_details\": \"Do you mean 'bananas' or 'banana'?\",\n        \"start_line\": 2,\n        \"end_line\": 2\n      },\n      {\n        \"path\": \"README.md\",\n        \"annotation_level\": \"warning\",\n        \"title\": \"Spell Checker\",\n        \"message\": \"Check your spelling for 'aples'\",\n        \"raw_details\": \"Do you mean 'apples' or 'Naples'\",\n        \"start_line\": 4,\n        \"end_line\": 4\n      }\n    ],\n    \"images\": [\n      {\n        \"alt\": \"Super bananas\",\n        \"image_url\": \"http://example.com/images/42\"\n      }\n    ]\n  },\n  \"actions\": [\n    {\n      \"label\": \"Fix\",\n      \"identifier\": \"fix_errors\",\n      \"description\": \"Allow us to fix these errors for you\"\n    }\n  ]\n}'\n```\n\n**Response schema (Status: 201):**\n\n* `id`: required, integer, format: int64\n* `head_sha`: required, string\n* `node_id`: required, string\n* `external_id`: required, string or null\n* `url`: required, string\n* `html_url`: required, string or null\n* `details_url`: required, string or null\n* `status`: required, string, enum: `queued`, `in_progress`, `completed`, `waiting`, `requested`, `pending`\n* `conclusion`: required, string or null, enum: `success`, `failure`, `neutral`, `cancelled`, `skipped`, `timed_out`, `action_required`, `null`\n* `started_at`: required, string or null, format: date-time\n* `completed_at`: required, string or null, format: date-time\n* `output`: required, object:\n  * `title`: required, string or null\n  * `summary`: required, string or null\n  * `text`: required, string or null\n  * `annotations_count`: required, integer\n  * `annotations_url`: required, string, format: uri\n* `name`: required, string\n* `check_suite`: required, object or null:\n  * `id`: required, integer\n* `app`: required, any of:\n  * **null**\n  * **GitHub app**\n    * `id`: required, integer\n    * `slug`: string\n    * `node_id`: required, string\n    * `client_id`: string\n    * `owner`: required, one of:\n      * **Simple User**\n        * `name`: string or null\n        * `email`: string or null\n        * `login`: required, string\n        * `id`: required, integer, format: int64\n        * `node_id`: required, string\n        * `avatar_url`: required, string, format: uri\n        * `gravatar_id`: required, string or null\n        * `url`: required, string, format: uri\n        * `html_url`: required, string, format: uri\n        * `followers_url`: required, string, format: uri\n        * `following_url`: required, string\n        * `gists_url`: required, string\n        * `starred_url`: required, string\n        * `subscriptions_url`: required, string, format: uri\n        * `organizations_url`: required, string, format: uri\n        * `repos_url`: required, string, format: uri\n        * `events_url`: required, string\n        * `received_events_url`: required, string, format: uri\n        * `type`: required, string\n        * `site_admin`: required, boolean\n        * `starred_at`: string\n        * `user_view_type`: string\n      * **Enterprise**\n        * `description`: string or null\n        * `html_url`: required, string, format: uri\n        * `website_url`: string or null, format: uri\n        * `id`: required, integer\n        * `node_id`: required, string\n        * `name`: required, string\n        * `slug`: required, string\n        * `created_at`: required, string or null, format: date-time\n        * `updated_at`: required, string or null, format: date-time\n        * `avatar_url`: required, string, format: uri\n    * `name`: required, string\n    * `description`: required, string or null\n    * `external_url`: required, string, format: uri\n    * `html_url`: required, string, format: uri\n    * `created_at`: required, string, format: date-time\n    * `updated_at`: required, string, format: date-time\n    * `permissions`: required, object, additional properties: string:\n      * `issues`: string\n      * `checks`: string\n      * `metadata`: string\n      * `contents`: string\n      * `deployments`: string\n    * `events`: required, array of string\n    * `installations_count`: integer\n* `pull_requests`: required, array of `Pull Request Minimal`:\n  * `id`: required, integer, format: int64\n  * `number`: required, integer\n  * `url`: required, string\n  * `head`: required, object:\n    * `ref`: required, string\n    * `sha`: required, string\n    * `repo`: required, object:\n      * `id`: required, integer, format: int64\n      * `url`: required, string\n      * `name`: required, string\n  * `base`: required, object:\n    * `ref`: required, string\n    * `sha`: required, string\n    * `repo`: required, object:\n      * `id`: required, integer, format: int64\n      * `url`: required, string\n      * `name`: required, string\n* `deployment`: `Deployment`:\n  * `url`: required, string, format: uri\n  * `id`: required, integer\n  * `node_id`: required, string\n  * `task`: required, string\n  * `original_environment`: string\n  * `environment`: required, string\n  * `description`: required, string or null\n  * `created_at`: required, string, format: date-time\n  * `updated_at`: required, string, format: date-time\n  * `statuses_url`: required, string, format: uri\n  * `repository_url`: required, string, format: uri\n  * `transient_environment`: boolean\n  * `production_environment`: boolean\n  * `performed_via_github_app`: any of:\n    * **null**\n    * **GitHub app**\n      * `id`: required, integer\n      * `slug`: string\n      * `node_id`: required, string\n      * `client_id`: string\n      * `owner`: required, one of:\n        * **Simple User**\n          * `name`: string or null\n          * `email`: string or null\n          * `login`: required, string\n          * `id`: required, integer, format: int64\n          * `node_id`: required, string\n          * `avatar_url`: required, string, format: uri\n          * `gravatar_id`: required, string or null\n          * `url`: required, string, format: uri\n          * `html_url`: required, string, format: uri\n          * `followers_url`: required, string, format: uri\n          * `following_url`: required, string\n          * `gists_url`: required, string\n          * `starred_url`: required, string\n          * `subscriptions_url`: required, string, format: uri\n          * `organizations_url`: required, string, format: uri\n          * `repos_url`: required, string, format: uri\n          * `events_url`: required, string\n          * `received_events_url`: required, string, format: uri\n          * `type`: required, string\n          * `site_admin`: required, boolean\n          * `starred_at`: string\n          * `user_view_type`: string\n        * **Enterprise**\n          * `description`: string or null\n          * `html_url`: required, string, format: uri\n          * `website_url`: string or null, format: uri\n          * `id`: required, integer\n          * `node_id`: required, string\n          * `name`: required, string\n          * `slug`: required, string\n          * `created_at`: required, string or null, format: date-time\n          * `updated_at`: required, string or null, format: date-time\n          * `avatar_url`: required, string, format: uri\n      * `name`: required, string\n      * `description`: required, string or null\n      * `external_url`: required, string, format: uri\n      * `html_url`: required, string, format: uri\n      * `created_at`: required, string, format: date-time\n      * `updated_at`: required, string, format: date-time\n      * `permissions`: required, object, additional properties: string:\n        * `issues`: string\n        * `checks`: string\n        * `metadata`: string\n        * `contents`: string\n        * `deployments`: string\n      * `events`: required, array of string\n      * `installations_count`: integer\n\n## Get a check run\n\n```\nGET /repos/{owner}/{repo}/check-runs/{check_run_id}\n```\n\nGets a single check run using its id.\nNote\n\nThe Checks API only looks for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull\\_requests array.\n\nOAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint on a private repository.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`check_run_id`** (integer) (required)\n  The unique identifier of the check run.\n\n### HTTP response status codes\n\n* **200** - OK\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/check-runs/CHECK_RUN_ID\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Create a check run](#create-a-check-run).\n\n## Update a check run\n\n```\nPATCH /repos/{owner}/{repo}/check-runs/{check_run_id}\n```\n\nUpdates a check run for a specific commit in a repository.\nNote\n\nThe endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull\\_requests array.\n\nOAuth apps and personal access tokens (classic) cannot use this endpoint.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`check_run_id`** (integer) (required)\n  The unique identifier of the check run.\n\n#### Body parameters\n\n* **`name`** (string)\n  The name of the check. For example, \"code-coverage\".\n\n* **`details_url`** (string)\n  The URL of the integrator's site that has the full details of the check.\n\n* **`external_id`** (string)\n  A reference for the run on the integrator's system.\n\n* **`started_at`** (string)\n  This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\n\n* **`status`** (string)\n  The current status of the check run. Only GitHub Actions can set a status of waiting, pending, or requested.\n  Can be one of: `queued`, `in_progress`, `completed`, `waiting`, `requested`, `pending`\n\n* **`conclusion`** (string)\n  Required if you provide completed\\_at or a status of completed. The final conclusion of the check.\n  Note: Providing conclusion will automatically set the status parameter to completed. You cannot change a check run conclusion to stale, only GitHub can set this.\n  Can be one of: `action_required`, `cancelled`, `failure`, `neutral`, `success`, `skipped`, `stale`, `timed_out`\n\n* **`completed_at`** (string)\n  The time the check completed. This is a timestamp in ISO 8601 format: YYYY-MM-DDTHH:MM:SSZ.\n\n* **`output`** (object)\n  Check runs can accept a variety of data in the output object, including a title and summary and can optionally provide descriptive details about the run.\n  * **`title`** (string)\n    Required.\n  * **`summary`** (string) (required)\n    Can contain Markdown.\n  * **`text`** (string)\n    Can contain Markdown.\n  * **`annotations`** (array of objects)\n    Adds information from your analysis to specific lines of code. Annotations are visible in GitHub's pull request UI. Annotations are visible in GitHub's pull request UI. The Checks API limits the number of annotations to a maximum of 50 per API request. To create more than 50 annotations, you have to make multiple requests to the Update a check run endpoint. Each time you update the check run, annotations are appended to the list of annotations that already exist for the check run. GitHub Actions are limited to 10 warning annotations and 10 error annotations per step. For details about annotations in the UI, see \"About status checks\".\n    * **`path`** (string) (required)\n      The path of the file to add an annotation to. For example, assets/css/main.css.\n    * **`start_line`** (integer) (required)\n      The start line of the annotation. Line numbers start at 1.\n    * **`end_line`** (integer) (required)\n      The end line of the annotation.\n    * **`start_column`** (integer)\n      The start column of the annotation. Annotations only support start\\_column and end\\_column on the same line. Omit this parameter if start\\_line and end\\_line have different values. Column numbers start at 1.\n    * **`end_column`** (integer)\n      The end column of the annotation. Annotations only support start\\_column and end\\_column on the same line. Omit this parameter if start\\_line and end\\_line have different values.\n    * **`annotation_level`** (string) (required)\n      The level of the annotation.\n      Can be one of: `notice`, `warning`, `failure`\n    * **`message`** (string) (required)\n      A short description of the feedback for these lines of code. The maximum size is 64 KB.\n    * **`title`** (string)\n      The title that represents the annotation. The maximum size is 255 characters.\n    * **`raw_details`** (string)\n      Details about this annotation. The maximum size is 64 KB.\n  * **`images`** (array of objects)\n    Adds images to the output displayed in the GitHub pull request UI.\n    * **`alt`** (string) (required)\n      The alternative text for the image.\n    * **`image_url`** (string) (required)\n      The full URL of the image.\n    * **`caption`** (string)\n      A short image description.\n\n* **`actions`** (array of objects)\n  Possible further actions the integrator can perform, which a user may trigger. Each action includes a label, identifier and description. A maximum of three actions are accepted. To learn more about check runs and requested actions, see \"Check runs and requested actions.\"\n  * **`label`** (string) (required)\n    The text to be displayed on a button in the web UI. The maximum size is 20 characters.\n  * **`description`** (string) (required)\n    A short explanation of what this action would do. The maximum size is 40 characters.\n  * **`identifier`** (string) (required)\n    A reference for the action on the integrator's system. The maximum size is 20 characters.\n\n### HTTP response status codes\n\n* **200** - OK\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X PATCH \\\n  https://api.github.com/repos/OWNER/REPO/check-runs/CHECK_RUN_ID \\\n  -d '{\n  \"name\": \"mighty_readme\",\n  \"started_at\": \"2018-05-04T01:14:52Z\",\n  \"status\": \"completed\",\n  \"conclusion\": \"success\",\n  \"completed_at\": \"2018-05-04T01:14:52Z\",\n  \"output\": {\n    \"title\": \"Mighty Readme report\",\n    \"summary\": \"There are 0 failures, 2 warnings, and 1 notices.\",\n    \"text\": \"You may have some misspelled words on lines 2 and 4. You also may want to add a section in your README about how to install your app.\",\n    \"annotations\": [\n      {\n        \"path\": \"README.md\",\n        \"annotation_level\": \"warning\",\n        \"title\": \"Spell Checker\",\n        \"message\": \"Check your spelling for 'banaas'.\",\n        \"raw_details\": \"Do you mean 'bananas' or 'banana'?\",\n        \"start_line\": 2,\n        \"end_line\": 2\n      },\n      {\n        \"path\": \"README.md\",\n        \"annotation_level\": \"warning\",\n        \"title\": \"Spell Checker\",\n        \"message\": \"Check your spelling for 'aples'\",\n        \"raw_details\": \"Do you mean 'apples' or 'Naples'\",\n        \"start_line\": 4,\n        \"end_line\": 4\n      }\n    ],\n    \"images\": [\n      {\n        \"alt\": \"Super bananas\",\n        \"image_url\": \"http://example.com/images/42\"\n      }\n    ]\n  }\n}'\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Create a check run](#create-a-check-run).\n\n## List check run annotations\n\n```\nGET /repos/{owner}/{repo}/check-runs/{check_run_id}/annotations\n```\n\nLists annotations for a check run using the annotation id.\nOAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint on a private repository.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`check_run_id`** (integer) (required)\n  The unique identifier of the check run.\n\n* **`per_page`** (integer)\n  The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"\n  Default: `30`\n\n* **`page`** (integer)\n  The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"\n  Default: `1`\n\n### HTTP response status codes\n\n* **200** - OK\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/check-runs/CHECK_RUN_ID/annotations\n```\n\n**Response schema (Status: 200):**\n\nArray of `Check Annotation`:\n\n* `path`: required, string\n* `start_line`: required, integer\n* `end_line`: required, integer\n* `start_column`: required, integer or null\n* `end_column`: required, integer or null\n* `annotation_level`: required, string or null\n* `title`: required, string or null\n* `message`: required, string or null\n* `raw_details`: required, string or null\n* `blob_href`: required, string\n\n## Rerequest a check run\n\n```\nPOST /repos/{owner}/{repo}/check-runs/{check_run_id}/rerequest\n```\n\nTriggers GitHub to rerequest an existing check run, without pushing new code to a repository. This endpoint will trigger the check\\_run webhook event with the action rerequested. When a check run is rerequested, the status of the check suite it belongs to is reset to queued and the conclusion is cleared. The check run itself is not updated. GitHub apps recieving the check\\_run webhook with the rerequested action should then decide if the check run should be reset or updated and call the update check\\_run endpoint to update the check\\_run if desired.\nFor more information about how to re-run GitHub Actions jobs, see \"Re-run a job from a workflow run\".\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`check_run_id`** (integer) (required)\n  The unique identifier of the check run.\n\n### HTTP response status codes\n\n* **201** - Created\n\n* **403** - Forbidden if the check run is not rerequestable or doesn't belong to the authenticated GitHub App\n\n* **404** - Resource not found\n\n* **422** - Validation error if the check run is not rerequestable\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  https://api.github.com/repos/OWNER/REPO/check-runs/CHECK_RUN_ID/rerequest\n```\n\n**Response schema (Status: 201):**\n\n## List check runs in a check suite\n\n```\nGET /repos/{owner}/{repo}/check-suites/{check_suite_id}/check-runs\n```\n\nLists check runs for a check suite using its id.\nNote\n\nThe endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull\\_requests array.\n\nOAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint on a private repository.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`check_suite_id`** (integer) (required)\n  The unique identifier of the check suite.\n\n* **`check_name`** (string)\n  Returns check runs with the specified name.\n\n* **`status`** (string)\n  Returns check runs with the specified status.\n  Can be one of: `queued`, `in_progress`, `completed`\n\n* **`filter`** (string)\n  Filters check runs by their completed\\_at timestamp. latest returns the most recent check runs.\n  Default: `latest`\n  Can be one of: `latest`, `all`\n\n* **`per_page`** (integer)\n  The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"\n  Default: `30`\n\n* **`page`** (integer)\n  The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"\n  Default: `1`\n\n### HTTP response status codes\n\n* **200** - OK\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/check-suites/CHECK_SUITE_ID/check-runs\n```\n\n**Response schema (Status: 200):**\n\n* `total_count`: required, integer\n* `check_runs`: required, array of `CheckRun`:\n  * `id`: required, integer, format: int64\n  * `head_sha`: required, string\n  * `node_id`: required, string\n  * `external_id`: required, string or null\n  * `url`: required, string\n  * `html_url`: required, string or null\n  * `details_url`: required, string or null\n  * `status`: required, string, enum: `queued`, `in_progress`, `completed`, `waiting`, `requested`, `pending`\n  * `conclusion`: required, string or null, enum: `success`, `failure`, `neutral`, `cancelled`, `skipped`, `timed_out`, `action_required`, `null`\n  * `started_at`: required, string or null, format: date-time\n  * `completed_at`: required, string or null, format: date-time\n  * `output`: required, object:\n    * `title`: required, string or null\n    * `summary`: required, string or null\n    * `text`: required, string or null\n    * `annotations_count`: required, integer\n    * `annotations_url`: required, string, format: uri\n  * `name`: required, string\n  * `check_suite`: required, object or null:\n    * `id`: required, integer\n  * `app`: required, any of:\n    * **null**\n    * **GitHub app**\n      * `id`: required, integer\n      * `slug`: string\n      * `node_id`: required, string\n      * `client_id`: string\n      * `owner`: required, one of:\n        * **Simple User**\n          * `name`: string or null\n          * `email`: string or null\n          * `login`: required, string\n          * `id`: required, integer, format: int64\n          * `node_id`: required, string\n          * `avatar_url`: required, string, format: uri\n          * `gravatar_id`: required, string or null\n          * `url`: required, string, format: uri\n          * `html_url`: required, string, format: uri\n          * `followers_url`: required, string, format: uri\n          * `following_url`: required, string\n          * `gists_url`: required, string\n          * `starred_url`: required, string\n          * `subscriptions_url`: required, string, format: uri\n          * `organizations_url`: required, string, format: uri\n          * `repos_url`: required, string, format: uri\n          * `events_url`: required, string\n          * `received_events_url`: required, string, format: uri\n          * `type`: required, string\n          * `site_admin`: required, boolean\n          * `starred_at`: string\n          * `user_view_type`: string\n        * **Enterprise**\n          * `description`: string or null\n          * `html_url`: required, string, format: uri\n          * `website_url`: string or null, format: uri\n          * `id`: required, integer\n          * `node_id`: required, string\n          * `name`: required, string\n          * `slug`: required, string\n          * `created_at`: required, string or null, format: date-time\n          * `updated_at`: required, string or null, format: date-time\n          * `avatar_url`: required, string, format: uri\n      * `name`: required, string\n      * `description`: required, string or null\n      * `external_url`: required, string, format: uri\n      * `html_url`: required, string, format: uri\n      * `created_at`: required, string, format: date-time\n      * `updated_at`: required, string, format: date-time\n      * `permissions`: required, object, additional properties: string:\n        * `issues`: string\n        * `checks`: string\n        * `metadata`: string\n        * `contents`: string\n        * `deployments`: string\n      * `events`: required, array of string\n      * `installations_count`: integer\n  * `pull_requests`: required, array of `Pull Request Minimal`:\n    * `id`: required, integer, format: int64\n    * `number`: required, integer\n    * `url`: required, string\n    * `head`: required, object:\n      * `ref`: required, string\n      * `sha`: required, string\n      * `repo`: required, object:\n        * `id`: required, integer, format: int64\n        * `url`: required, string\n        * `name`: required, string\n    * `base`: required, object:\n      * `ref`: required, string\n      * `sha`: required, string\n      * `repo`: required, object:\n        * `id`: required, integer, format: int64\n        * `url`: required, string\n        * `name`: required, string\n  * `deployment`: `Deployment`:\n    * `url`: required, string, format: uri\n    * `id`: required, integer\n    * `node_id`: required, string\n    * `task`: required, string\n    * `original_environment`: string\n    * `environment`: required, string\n    * `description`: required, string or null\n    * `created_at`: required, string, format: date-time\n    * `updated_at`: required, string, format: date-time\n    * `statuses_url`: required, string, format: uri\n    * `repository_url`: required, string, format: uri\n    * `transient_environment`: boolean\n    * `production_environment`: boolean\n    * `performed_via_github_app`: any of:\n      * **null**\n      * **GitHub app**\n        * `id`: required, integer\n        * `slug`: string\n        * `node_id`: required, string\n        * `client_id`: string\n        * `owner`: required, one of:\n          * **Simple User**\n            * `name`: string or null\n            * `email`: string or null\n            * `login`: required, string\n            * `id`: required, integer, format: int64\n            * `node_id`: required, string\n            * `avatar_url`: required, string, format: uri\n            * `gravatar_id`: required, string or null\n            * `url`: required, string, format: uri\n            * `html_url`: required, string, format: uri\n            * `followers_url`: required, string, format: uri\n            * `following_url`: required, string\n            * `gists_url`: required, string\n            * `starred_url`: required, string\n            * `subscriptions_url`: required, string, format: uri\n            * `organizations_url`: required, string, format: uri\n            * `repos_url`: required, string, format: uri\n            * `events_url`: required, string\n            * `received_events_url`: required, string, format: uri\n            * `type`: required, string\n            * `site_admin`: required, boolean\n            * `starred_at`: string\n            * `user_view_type`: string\n          * **Enterprise**\n            * `description`: string or null\n            * `html_url`: required, string, format: uri\n            * `website_url`: string or null, format: uri\n            * `id`: required, integer\n            * `node_id`: required, string\n            * `name`: required, string\n            * `slug`: required, string\n            * `created_at`: required, string or null, format: date-time\n            * `updated_at`: required, string or null, format: date-time\n            * `avatar_url`: required, string, format: uri\n        * `name`: required, string\n        * `description`: required, string or null\n        * `external_url`: required, string, format: uri\n        * `html_url`: required, string, format: uri\n        * `created_at`: required, string, format: date-time\n        * `updated_at`: required, string, format: date-time\n        * `permissions`: required, object, additional properties: string:\n          * `issues`: string\n          * `checks`: string\n          * `metadata`: string\n          * `contents`: string\n          * `deployments`: string\n        * `events`: required, array of string\n        * `installations_count`: integer\n\n## List check runs for a Git reference\n\n```\nGET /repos/{owner}/{repo}/commits/{ref}/check-runs\n```\n\nLists check runs for a commit ref. The ref can be a SHA, branch name, or a tag name.\nNote\n\nThe endpoints to manage checks only look for pushes in the repository where the check suite or check run were created. Pushes to a branch in a forked repository are not detected and return an empty pull\\_requests array.\n\nIf there are more than 1000 check suites on a single git reference, this endpoint will limit check runs to the 1000 most recent check suites. To iterate over all possible check runs, use the List check suites for a Git reference endpoint and provide the check\\_suite\\_id parameter to the List check runs in a check suite endpoint.\nOAuth app tokens and personal access tokens (classic) need the repo scope to use this endpoint on a private repository.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`owner`** (string) (required)\n  The account owner of the repository. The name is not case sensitive.\n\n* **`repo`** (string) (required)\n  The name of the repository without the .git extension. The name is not case sensitive.\n\n* **`ref`** (string) (required)\n  The commit reference. Can be a commit SHA, branch name (heads/BRANCH\\_NAME), or tag name (tags/TAG\\_NAME). For more information, see \"Git References\" in the Git documentation.\n\n* **`check_name`** (string)\n  Returns check runs with the specified name.\n\n* **`status`** (string)\n  Returns check runs with the specified status.\n  Can be one of: `queued`, `in_progress`, `completed`\n\n* **`filter`** (string)\n  Filters check runs by their completed\\_at timestamp. latest returns the most recent check runs.\n  Default: `latest`\n  Can be one of: `latest`, `all`\n\n* **`per_page`** (integer)\n  The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"\n  Default: `30`\n\n* **`page`** (integer)\n  The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"\n  Default: `1`\n\n* **`app_id`** (integer)\n\n### HTTP response status codes\n\n* **200** - OK\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/repos/OWNER/REPO/commits/REF/check-runs\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [List check runs in a check suite](#list-check-runs-in-a-check-suite)."}