diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.json b/descriptions-next/api.github.com/api.github.com.2022-11-28.json index 9d1f815fbf..d4bba5c457 100644 --- a/descriptions-next/api.github.com/api.github.com.2022-11-28.json +++ b/descriptions-next/api.github.com/api.github.com.2022-11-28.json @@ -195,6 +195,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -221,300 +225,3592 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/root" - }, - "examples": { - "default": { - "$ref": "#/components/examples/root" + "$ref": "#/components/schemas/root" + }, + "examples": { + "default": { + "$ref": "#/components/examples/root" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "meta", + "subcategory": "meta" + }, + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/meta/meta#github-api-root" + } + } + }, + "/advisories": { + "get": { + "summary": "List global security advisories", + "description": "Lists all global security advisories that match the specified parameters. If no other parameters are defined, the request will return only GitHub-reviewed advisories that are not malware.\n\nBy default, all responses will exclude advisories for malware, because malware are not standard vulnerabilities. To list advisories for malware, you must include the `type` parameter in your request, with the value `malware`. For more information about the different types of security advisories, see \"[About the GitHub Advisory database](https://docs.github.com/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database#about-types-of-security-advisories).\"", + "tags": [ + "security-advisories" + ], + "operationId": "security-advisories/list-global-advisories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/security-advisories/global-advisories#list-global-security-advisories" + }, + "parameters": [ + { + "name": "ghsa_id", + "in": "query", + "description": "If specified, only advisories with this GHSA (GitHub Security Advisory) identifier will be returned.", + "schema": { + "type": "string" + } + }, + { + "name": "type", + "in": "query", + "description": "If specified, only advisories of this type will be returned. By default, a request with no other parameters defined will only return reviewed advisories that are not malware.", + "schema": { + "type": "string", + "enum": [ + "reviewed", + "malware", + "unreviewed" + ], + "default": "reviewed" + } + }, + { + "name": "cve_id", + "description": "If specified, only advisories with this CVE (Common Vulnerabilities and Exposures) identifier will be returned.", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "ecosystem", + "in": "query", + "description": "If specified, only advisories for these ecosystems will be returned.", + "schema": { + "$ref": "#/components/schemas/security-advisory-ecosystems" + } + }, + { + "name": "severity", + "in": "query", + "description": "If specified, only advisories with these severities will be returned.", + "schema": { + "type": "string", + "enum": [ + "unknown", + "low", + "medium", + "high", + "critical" + ] + } + }, + { + "name": "cwes", + "in": "query", + "description": "If specified, only advisories with these Common Weakness Enumerations (CWEs) will be returned.\n\nExample: `cwes=79,284,22` or `cwes[]=79&cwes[]=284&cwes[]=22`", + "schema": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string" + } + } + ] + } + }, + { + "name": "is_withdrawn", + "in": "query", + "description": "Whether to only return advisories that have been withdrawn.", + "schema": { + "type": "boolean" + } + }, + { + "name": "affects", + "in": "query", + "description": "If specified, only return advisories that affect any of `package` or `package@version`. A maximum of 1000 packages can be specified.\nIf the query parameter causes the URL to exceed the maximum URL length supported by your client, you must specify fewer packages.\n\nExample: `affects=package1,package2@1.0.0,package3@2.0.0` or `affects[]=package1&affects[]=package2@1.0.0`", + "schema": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "array", + "maxItems": 1000, + "items": { + "type": "string" + } + } + ] + } + }, + { + "name": "published", + "in": "query", + "description": "If specified, only return advisories that were published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", + "schema": { + "type": "string" + } + }, + { + "name": "updated", + "in": "query", + "description": "If specified, only return advisories that were updated on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", + "schema": { + "type": "string" + } + }, + { + "name": "modified", + "description": "If specified, only show advisories that were updated or published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "epss_percentage", + "in": "query", + "description": "If specified, only return advisories that have an EPSS percentage score that matches the provided value.\nThe EPSS percentage represents the likelihood of a CVE being exploited.", + "schema": { + "type": "string" + } + }, + { + "name": "epss_percentile", + "in": "query", + "description": "If specified, only return advisories that have an EPSS percentile score that matches the provided value.\nThe EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs.", + "schema": { + "type": "string" + } + }, + { + "$ref": "#/components/parameters/pagination-before" + }, + { + "$ref": "#/components/parameters/pagination-after" + }, + { + "$ref": "#/components/parameters/direction" + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "default": 30 + } + }, + { + "name": "sort", + "description": "The property to sort the results by.", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": [ + "updated", + "published", + "epss_percentage", + "epss_percentile" + ], + "default": "published" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/global-advisory" + } + }, + "examples": { + "default": { + "$ref": "#/components/examples/global-advisory-items" + } + } + } + } + }, + "429": { + "description": "Too many requests", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + } + } + } + }, + "422": { + "$ref": "#/components/responses/validation_failed_simple" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "security-advisories", + "subcategory": "global-advisories" + } + } + }, + "/advisories/{ghsa_id}": { + "get": { + "summary": "Get a global security advisory", + "description": "Gets a global security advisory using its GitHub Security Advisory (GHSA) identifier.", + "tags": [ + "security-advisories" + ], + "operationId": "security-advisories/get-global-advisory", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory" + }, + "parameters": [ + { + "$ref": "#/components/parameters/ghsa_id" + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/global-advisory" + }, + "examples": { + "default": { + "$ref": "#/components/examples/global-advisory" + } + } + } + } + }, + "404": { + "$ref": "#/components/responses/not_found" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "security-advisories", + "subcategory": "global-advisories" + } + } + }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } } } } } } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "meta", - "subcategory": "meta" - }, - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/meta/meta#github-api-root" } } }, - "/advisories": { + "/agents/tasks": { "get": { - "summary": "List global security advisories", - "description": "Lists all global security advisories that match the specified parameters. If no other parameters are defined, the request will return only GitHub-reviewed advisories that are not malware.\n\nBy default, all responses will exclude advisories for malware, because malware are not standard vulnerabilities. To list advisories for malware, you must include the `type` parameter in your request, with the value `malware`. For more information about the different types of security advisories, see \"[About the GitHub Advisory database](https://docs.github.com/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database#about-types-of-security-advisories).\"", + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", "tags": [ - "security-advisories" + "agent-tasks" ], - "operationId": "security-advisories/list-global-advisories", + "operationId": "agent-tasks/list-tasks", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/security-advisories/global-advisories#list-global-security-advisories" + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" }, "parameters": [ { - "name": "ghsa_id", - "in": "query", - "description": "If specified, only advisories with this GHSA (GitHub Security Advisory) identifier will be returned.", - "schema": { - "type": "string" - } - }, - { - "name": "type", - "in": "query", - "description": "If specified, only advisories of this type will be returned. By default, a request with no other parameters defined will only return reviewed advisories that are not malware.", - "schema": { - "type": "string", - "enum": [ - "reviewed", - "malware", - "unreviewed" - ], - "default": "reviewed" - } - }, - { - "name": "cve_id", - "description": "If specified, only advisories with this CVE (Common Vulnerabilities and Exposures) identifier will be returned.", + "name": "per_page", "in": "query", "schema": { - "type": "string" - } + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." }, { - "name": "ecosystem", + "name": "page", "in": "query", - "description": "If specified, only advisories for these ecosystems will be returned.", "schema": { - "$ref": "#/components/schemas/security-advisory-ecosystems" - } + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." }, { - "name": "severity", + "name": "sort", "in": "query", - "description": "If specified, only advisories with these severities will be returned.", "schema": { "type": "string", + "default": "updated_at", "enum": [ - "unknown", - "low", - "medium", - "high", - "critical" - ] - } - }, - { - "name": "cwes", - "in": "query", - "description": "If specified, only advisories with these Common Weakness Enumerations (CWEs) will be returned.\n\nExample: `cwes=79,284,22` or `cwes[]=79&cwes[]=284&cwes[]=22`", - "schema": { - "oneOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string" - } - } + "updated_at", + "created_at" ] - } - }, - { - "name": "is_withdrawn", - "in": "query", - "description": "Whether to only return advisories that have been withdrawn.", - "schema": { - "type": "boolean" - } + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." }, { - "name": "affects", + "name": "direction", "in": "query", - "description": "If specified, only return advisories that affect any of `package` or `package@version`. A maximum of 1000 packages can be specified.\nIf the query parameter causes the URL to exceed the maximum URL length supported by your client, you must specify fewer packages.\n\nExample: `affects=package1,package2@1.0.0,package3@2.0.0` or `affects[]=package1&affects[]=package2@1.0.0`", "schema": { - "oneOf": [ - { - "type": "string" - }, - { - "type": "array", - "maxItems": 1000, - "items": { - "type": "string" - } - } + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" ] - } - }, - { - "name": "published", - "in": "query", - "description": "If specified, only return advisories that were published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", - "schema": { - "type": "string" - } - }, - { - "name": "updated", - "in": "query", - "description": "If specified, only return advisories that were updated on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", - "schema": { - "type": "string" - } - }, - { - "name": "modified", - "description": "If specified, only show advisories that were updated or published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", - "in": "query", - "schema": { - "type": "string" - } - }, - { - "name": "epss_percentage", - "in": "query", - "description": "If specified, only return advisories that have an EPSS percentage score that matches the provided value.\nThe EPSS percentage represents the likelihood of a CVE being exploited.", - "schema": { - "type": "string" - } + }, + "description": "The direction to sort results. Can be `asc` or `desc`." }, { - "name": "epss_percentile", + "name": "state", "in": "query", - "description": "If specified, only return advisories that have an EPSS percentile score that matches the provided value.\nThe EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs.", "schema": { "type": "string" - } - }, - { - "$ref": "#/components/parameters/pagination-before" - }, - { - "$ref": "#/components/parameters/pagination-after" - }, - { - "$ref": "#/components/parameters/direction" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." }, { - "name": "per_page", - "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "name": "is_archived", "in": "query", "schema": { - "type": "integer", - "minimum": 1, - "maximum": 100, - "default": 30 - } + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." }, { - "name": "sort", - "description": "The property to sort the results by.", + "name": "since", "in": "query", - "required": false, "schema": { "type": "string", - "enum": [ - "updated", - "published", - "epss_percentage", - "epss_percentile" - ], - "default": "published" - } + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" } ], "responses": { "200": { - "description": "Response", + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, "content": { "application/json": { "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/global-advisory" + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } } }, "examples": { "default": { - "$ref": "#/components/examples/global-advisory-items" + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } } } } } }, - "429": { - "description": "Too many requests", + "400": { + "description": "Bad request", "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/basic-error" + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } } } } }, "422": { - "$ref": "#/components/responses/validation_failed_simple" + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "security-advisories", - "subcategory": "global-advisories" } } }, - "/advisories/{ghsa_id}": { + "/agents/tasks/{task_id}": { "get": { - "summary": "Get a global security advisory", - "description": "Gets a global security advisory using its GitHub Security Advisory (GHSA) identifier.", + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", "tags": [ - "security-advisories" + "agent-tasks" ], - "operationId": "security-advisories/get-global-advisory", + "operationId": "agent-tasks/get-task-by-id", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory" + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" }, "parameters": [ { - "$ref": "#/components/parameters/ghsa_id" + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." } ], "responses": { "200": { - "description": "Response", + "description": "Task retrieved successfully", "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/global-advisory" + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] }, "examples": { "default": { - "$ref": "#/components/examples/global-advisory" + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } } } } } }, "404": { - "$ref": "#/components/responses/not_found" + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "security-advisories", - "subcategory": "global-advisories" } } }, @@ -10563,7 +13859,18 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/oidc-custom-sub" + "title": "Actions OIDC Subject customization", + "description": "Actions OIDC Subject customization", + "type": "object", + "properties": { + "include_claim_keys": { + "description": "Array of unique strings. Each claim key can only contain alphanumeric characters and underscores.", + "type": "array", + "items": { + "type": "string" + } + } + } }, "examples": { "default": { @@ -14344,6 +17651,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -14391,7 +17703,10 @@ "$ref": "#/components/schemas/artifact-deployment-record" } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -14545,6 +17860,11 @@ "digest" ] } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, "required": [ @@ -14593,7 +17913,10 @@ "$ref": "#/components/schemas/artifact-deployment-record" } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -14604,7 +17927,27 @@ } }, "403": { - "$ref": "#/components/responses/forbidden" + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + }, + "examples": { + "insufficient_repo_permissions": { + "value": { + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } + } + } + } + } + } }, "404": { "$ref": "#/components/responses/not_found" @@ -14727,6 +18070,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -14806,7 +18154,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -24055,7 +27406,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -24334,7 +27685,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -30462,6 +33813,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } }, "required": [ @@ -30603,6 +33967,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -108213,6 +111590,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -123305,6 +126683,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -123398,6 +126784,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -123415,6 +126809,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -123432,6 +126834,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -123500,6 +126910,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -123517,6 +126935,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -123534,6 +126960,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -123551,6 +126985,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -123568,6 +127010,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -132872,6 +136322,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -293405,12 +296856,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -296560,12 +300009,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -313283,12 +316730,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -313576,12 +317021,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", diff --git a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml index b0b057f861..0942140c53 100644 --- a/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml +++ b/descriptions-next/api.github.com/api.github.com.2022-11-28.yaml @@ -103,6 +103,8 @@ tags: description: Endpoints to manage campaigns via the REST API. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -336,6 +338,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -7551,7 +10068,16 @@ paths: content: application/json: schema: - "$ref": "#/components/schemas/oidc-custom-sub" + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: default: "$ref": "#/components/examples/oidc-custom-sub" @@ -10355,6 +12881,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -10388,6 +12921,8 @@ paths: type: array items: "$ref": "#/components/schemas/artifact-deployment-record" + required: + - total_count examples: default: "$ref": "#/components/examples/artifact-deployment-record-list" @@ -10522,6 +13057,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -10555,11 +13097,26 @@ paths: type: array items: "$ref": "#/components/schemas/artifact-deployment-record" + required: + - total_count examples: default: "$ref": "#/components/examples/artifact-deployment-record-list" '403': - "$ref": "#/components/responses/forbidden" + description: Forbidden + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': "$ref": "#/components/responses/not_found" x-github: @@ -10662,6 +13219,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -10715,6 +13279,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -17482,7 +20048,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -17700,7 +20266,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -22068,6 +24634,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -22169,6 +24748,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -78313,6 +80905,7 @@ components: - unknown - direct - transitive + - inconclusive - security_advisory: "$ref": "#/components/schemas/dependabot-alert-security-advisory" @@ -89499,6 +92092,12 @@ components: commit_url: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -89575,6 +92174,12 @@ components: description: The API URL to get the issue where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url secret-scanning-location-issue-body: @@ -89588,6 +92193,12 @@ components: description: The API URL to get the issue where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url secret-scanning-location-issue-comment: @@ -89601,6 +92212,12 @@ components: description: The API URL to get the issue comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url secret-scanning-location-discussion-title: @@ -89655,6 +92272,12 @@ components: description: The API URL to get the pull request where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url secret-scanning-location-pull-request-body: @@ -89669,6 +92292,12 @@ components: description: The API URL to get the pull request where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url secret-scanning-location-pull-request-comment: @@ -89684,6 +92313,13 @@ components: was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment where the secret + was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url secret-scanning-location-pull-request-review: @@ -89699,6 +92335,13 @@ components: was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review where the secret + was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url secret-scanning-location-pull-request-review-comment: @@ -89714,6 +92357,13 @@ components: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review comment where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url secret-scanning-first-detected-location: @@ -96437,6 +99087,7 @@ components: - unknown - direct - transitive + - inconclusive - security_advisory: "$ref": "#/components/schemas/dependabot-alert-security-advisory" @@ -215290,7 +217941,7 @@ components: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -218320,7 +220971,7 @@ components: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -232596,7 +235247,7 @@ components: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -232805,7 +235456,7 @@ components: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 diff --git a/descriptions-next/api.github.com/api.github.com.2026-03-10.json b/descriptions-next/api.github.com/api.github.com.2026-03-10.json index 2e68fa0fd1..0ab26c7a97 100644 --- a/descriptions-next/api.github.com/api.github.com.2026-03-10.json +++ b/descriptions-next/api.github.com/api.github.com.2026-03-10.json @@ -195,6 +195,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -518,6 +522,3298 @@ } } }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks": { + "get": { + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks/{task_id}": { + "get": { + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, "/app": { "get": { "summary": "Get the authenticated app", @@ -10562,7 +13858,18 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/oidc-custom-sub" + "title": "Actions OIDC Subject customization", + "description": "Actions OIDC Subject customization", + "type": "object", + "properties": { + "include_claim_keys": { + "description": "Array of unique strings. Each claim key can only contain alphanumeric characters and underscores.", + "type": "array", + "items": { + "type": "string" + } + } + } }, "examples": { "default": { @@ -14343,6 +17650,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -14390,7 +17702,10 @@ "$ref": "#/components/schemas/artifact-deployment-record" } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -14544,6 +17859,11 @@ "digest" ] } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, "required": [ @@ -14592,7 +17912,10 @@ "$ref": "#/components/schemas/artifact-deployment-record" } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -14603,7 +17926,27 @@ } }, "403": { - "$ref": "#/components/responses/forbidden" + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + }, + "examples": { + "insufficient_repo_permissions": { + "value": { + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } + } + } + } + } + } }, "404": { "$ref": "#/components/responses/not_found" @@ -14726,6 +18069,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -14805,7 +18153,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -24007,7 +27358,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -24286,7 +27637,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -30417,6 +33768,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } }, "required": [ @@ -30558,6 +33922,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -107995,6 +111372,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -122698,6 +126076,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -122791,6 +126177,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -122808,6 +126202,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -122825,6 +126227,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -122893,6 +126303,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -122910,6 +126328,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -122927,6 +126353,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -122944,6 +126378,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -122961,6 +126403,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -132220,6 +135670,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -292560,12 +296011,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -295715,12 +299164,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -312437,12 +315884,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -312730,12 +316175,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", diff --git a/descriptions-next/api.github.com/api.github.com.2026-03-10.yaml b/descriptions-next/api.github.com/api.github.com.2026-03-10.yaml index a17c8a171d..1c944b96d0 100644 --- a/descriptions-next/api.github.com/api.github.com.2026-03-10.yaml +++ b/descriptions-next/api.github.com/api.github.com.2026-03-10.yaml @@ -103,6 +103,8 @@ tags: description: Endpoints to manage campaigns via the REST API. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -336,6 +338,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -7549,7 +10066,16 @@ paths: content: application/json: schema: - "$ref": "#/components/schemas/oidc-custom-sub" + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: default: "$ref": "#/components/examples/oidc-custom-sub" @@ -10353,6 +12879,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -10386,6 +12919,8 @@ paths: type: array items: "$ref": "#/components/schemas/artifact-deployment-record" + required: + - total_count examples: default: "$ref": "#/components/examples/artifact-deployment-record-list" @@ -10520,6 +13055,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -10553,11 +13095,26 @@ paths: type: array items: "$ref": "#/components/schemas/artifact-deployment-record" + required: + - total_count examples: default: "$ref": "#/components/examples/artifact-deployment-record-list" '403': - "$ref": "#/components/responses/forbidden" + description: Forbidden + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': "$ref": "#/components/responses/not_found" x-github: @@ -10660,6 +13217,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -10713,6 +13277,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -17447,7 +20013,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -17665,7 +20231,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -22035,6 +24601,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -22136,6 +24715,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -78137,6 +80729,7 @@ components: - unknown - direct - transitive + - inconclusive - security_advisory: "$ref": "#/components/schemas/dependabot-alert-security-advisory" @@ -89055,6 +91648,12 @@ components: commit_url: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -89131,6 +91730,12 @@ components: description: The API URL to get the issue where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url secret-scanning-location-issue-body: @@ -89144,6 +91749,12 @@ components: description: The API URL to get the issue where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url secret-scanning-location-issue-comment: @@ -89157,6 +91768,12 @@ components: description: The API URL to get the issue comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url secret-scanning-location-discussion-title: @@ -89211,6 +91828,12 @@ components: description: The API URL to get the pull request where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url secret-scanning-location-pull-request-body: @@ -89225,6 +91848,12 @@ components: description: The API URL to get the pull request where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url secret-scanning-location-pull-request-comment: @@ -89240,6 +91869,13 @@ components: was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment where the secret + was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url secret-scanning-location-pull-request-review: @@ -89255,6 +91891,13 @@ components: was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review where the secret + was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url secret-scanning-location-pull-request-review-comment: @@ -89270,6 +91913,13 @@ components: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review comment where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url secret-scanning-first-detected-location: @@ -95959,6 +98609,7 @@ components: - unknown - direct - transitive + - inconclusive - security_advisory: "$ref": "#/components/schemas/dependabot-alert-security-advisory" @@ -214595,7 +217246,7 @@ components: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -217625,7 +220276,7 @@ components: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -231900,7 +234551,7 @@ components: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -232109,7 +234760,7 @@ components: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 diff --git a/descriptions-next/api.github.com/api.github.com.json b/descriptions-next/api.github.com/api.github.com.json index 163d1d8180..7545ccd57f 100644 --- a/descriptions-next/api.github.com/api.github.com.json +++ b/descriptions-next/api.github.com/api.github.com.json @@ -195,6 +195,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -221,300 +225,3592 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/root" - }, - "examples": { - "default": { - "$ref": "#/components/examples/root" + "$ref": "#/components/schemas/root" + }, + "examples": { + "default": { + "$ref": "#/components/examples/root" + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "meta", + "subcategory": "meta" + }, + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/meta/meta#github-api-root" + } + } + }, + "/advisories": { + "get": { + "summary": "List global security advisories", + "description": "Lists all global security advisories that match the specified parameters. If no other parameters are defined, the request will return only GitHub-reviewed advisories that are not malware.\n\nBy default, all responses will exclude advisories for malware, because malware are not standard vulnerabilities. To list advisories for malware, you must include the `type` parameter in your request, with the value `malware`. For more information about the different types of security advisories, see \"[About the GitHub Advisory database](https://docs.github.com/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database#about-types-of-security-advisories).\"", + "tags": [ + "security-advisories" + ], + "operationId": "security-advisories/list-global-advisories", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/security-advisories/global-advisories#list-global-security-advisories" + }, + "parameters": [ + { + "name": "ghsa_id", + "in": "query", + "description": "If specified, only advisories with this GHSA (GitHub Security Advisory) identifier will be returned.", + "schema": { + "type": "string" + } + }, + { + "name": "type", + "in": "query", + "description": "If specified, only advisories of this type will be returned. By default, a request with no other parameters defined will only return reviewed advisories that are not malware.", + "schema": { + "type": "string", + "enum": [ + "reviewed", + "malware", + "unreviewed" + ], + "default": "reviewed" + } + }, + { + "name": "cve_id", + "description": "If specified, only advisories with this CVE (Common Vulnerabilities and Exposures) identifier will be returned.", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "ecosystem", + "in": "query", + "description": "If specified, only advisories for these ecosystems will be returned.", + "schema": { + "$ref": "#/components/schemas/security-advisory-ecosystems" + } + }, + { + "name": "severity", + "in": "query", + "description": "If specified, only advisories with these severities will be returned.", + "schema": { + "type": "string", + "enum": [ + "unknown", + "low", + "medium", + "high", + "critical" + ] + } + }, + { + "name": "cwes", + "in": "query", + "description": "If specified, only advisories with these Common Weakness Enumerations (CWEs) will be returned.\n\nExample: `cwes=79,284,22` or `cwes[]=79&cwes[]=284&cwes[]=22`", + "schema": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "array", + "items": { + "type": "string" + } + } + ] + } + }, + { + "name": "is_withdrawn", + "in": "query", + "description": "Whether to only return advisories that have been withdrawn.", + "schema": { + "type": "boolean" + } + }, + { + "name": "affects", + "in": "query", + "description": "If specified, only return advisories that affect any of `package` or `package@version`. A maximum of 1000 packages can be specified.\nIf the query parameter causes the URL to exceed the maximum URL length supported by your client, you must specify fewer packages.\n\nExample: `affects=package1,package2@1.0.0,package3@2.0.0` or `affects[]=package1&affects[]=package2@1.0.0`", + "schema": { + "oneOf": [ + { + "type": "string" + }, + { + "type": "array", + "maxItems": 1000, + "items": { + "type": "string" + } + } + ] + } + }, + { + "name": "published", + "in": "query", + "description": "If specified, only return advisories that were published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", + "schema": { + "type": "string" + } + }, + { + "name": "updated", + "in": "query", + "description": "If specified, only return advisories that were updated on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", + "schema": { + "type": "string" + } + }, + { + "name": "modified", + "description": "If specified, only show advisories that were updated or published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", + "in": "query", + "schema": { + "type": "string" + } + }, + { + "name": "epss_percentage", + "in": "query", + "description": "If specified, only return advisories that have an EPSS percentage score that matches the provided value.\nThe EPSS percentage represents the likelihood of a CVE being exploited.", + "schema": { + "type": "string" + } + }, + { + "name": "epss_percentile", + "in": "query", + "description": "If specified, only return advisories that have an EPSS percentile score that matches the provided value.\nThe EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs.", + "schema": { + "type": "string" + } + }, + { + "$ref": "#/components/parameters/pagination-before" + }, + { + "$ref": "#/components/parameters/pagination-after" + }, + { + "$ref": "#/components/parameters/direction" + }, + { + "name": "per_page", + "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "in": "query", + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "default": 30 + } + }, + { + "name": "sort", + "description": "The property to sort the results by.", + "in": "query", + "required": false, + "schema": { + "type": "string", + "enum": [ + "updated", + "published", + "epss_percentage", + "epss_percentile" + ], + "default": "published" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "type": "array", + "items": { + "$ref": "#/components/schemas/global-advisory" + } + }, + "examples": { + "default": { + "$ref": "#/components/examples/global-advisory-items" + } + } + } + } + }, + "429": { + "description": "Too many requests", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + } + } + } + }, + "422": { + "$ref": "#/components/responses/validation_failed_simple" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "security-advisories", + "subcategory": "global-advisories" + } + } + }, + "/advisories/{ghsa_id}": { + "get": { + "summary": "Get a global security advisory", + "description": "Gets a global security advisory using its GitHub Security Advisory (GHSA) identifier.", + "tags": [ + "security-advisories" + ], + "operationId": "security-advisories/get-global-advisory", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory" + }, + "parameters": [ + { + "$ref": "#/components/parameters/ghsa_id" + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/global-advisory" + }, + "examples": { + "default": { + "$ref": "#/components/examples/global-advisory" + } + } + } + } + }, + "404": { + "$ref": "#/components/responses/not_found" + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "security-advisories", + "subcategory": "global-advisories" + } + } + }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } } } } } } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "meta", - "subcategory": "meta" - }, - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/meta/meta#github-api-root" } } }, - "/advisories": { + "/agents/tasks": { "get": { - "summary": "List global security advisories", - "description": "Lists all global security advisories that match the specified parameters. If no other parameters are defined, the request will return only GitHub-reviewed advisories that are not malware.\n\nBy default, all responses will exclude advisories for malware, because malware are not standard vulnerabilities. To list advisories for malware, you must include the `type` parameter in your request, with the value `malware`. For more information about the different types of security advisories, see \"[About the GitHub Advisory database](https://docs.github.com/code-security/security-advisories/global-security-advisories/about-the-github-advisory-database#about-types-of-security-advisories).\"", + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", "tags": [ - "security-advisories" + "agent-tasks" ], - "operationId": "security-advisories/list-global-advisories", + "operationId": "agent-tasks/list-tasks", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/security-advisories/global-advisories#list-global-security-advisories" + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" }, "parameters": [ { - "name": "ghsa_id", - "in": "query", - "description": "If specified, only advisories with this GHSA (GitHub Security Advisory) identifier will be returned.", - "schema": { - "type": "string" - } - }, - { - "name": "type", - "in": "query", - "description": "If specified, only advisories of this type will be returned. By default, a request with no other parameters defined will only return reviewed advisories that are not malware.", - "schema": { - "type": "string", - "enum": [ - "reviewed", - "malware", - "unreviewed" - ], - "default": "reviewed" - } - }, - { - "name": "cve_id", - "description": "If specified, only advisories with this CVE (Common Vulnerabilities and Exposures) identifier will be returned.", + "name": "per_page", "in": "query", "schema": { - "type": "string" - } + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." }, { - "name": "ecosystem", + "name": "page", "in": "query", - "description": "If specified, only advisories for these ecosystems will be returned.", "schema": { - "$ref": "#/components/schemas/security-advisory-ecosystems" - } + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." }, { - "name": "severity", + "name": "sort", "in": "query", - "description": "If specified, only advisories with these severities will be returned.", "schema": { "type": "string", + "default": "updated_at", "enum": [ - "unknown", - "low", - "medium", - "high", - "critical" - ] - } - }, - { - "name": "cwes", - "in": "query", - "description": "If specified, only advisories with these Common Weakness Enumerations (CWEs) will be returned.\n\nExample: `cwes=79,284,22` or `cwes[]=79&cwes[]=284&cwes[]=22`", - "schema": { - "oneOf": [ - { - "type": "string" - }, - { - "type": "array", - "items": { - "type": "string" - } - } + "updated_at", + "created_at" ] - } - }, - { - "name": "is_withdrawn", - "in": "query", - "description": "Whether to only return advisories that have been withdrawn.", - "schema": { - "type": "boolean" - } + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." }, { - "name": "affects", + "name": "direction", "in": "query", - "description": "If specified, only return advisories that affect any of `package` or `package@version`. A maximum of 1000 packages can be specified.\nIf the query parameter causes the URL to exceed the maximum URL length supported by your client, you must specify fewer packages.\n\nExample: `affects=package1,package2@1.0.0,package3@2.0.0` or `affects[]=package1&affects[]=package2@1.0.0`", "schema": { - "oneOf": [ - { - "type": "string" - }, - { - "type": "array", - "maxItems": 1000, - "items": { - "type": "string" - } - } + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" ] - } - }, - { - "name": "published", - "in": "query", - "description": "If specified, only return advisories that were published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", - "schema": { - "type": "string" - } - }, - { - "name": "updated", - "in": "query", - "description": "If specified, only return advisories that were updated on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", - "schema": { - "type": "string" - } - }, - { - "name": "modified", - "description": "If specified, only show advisories that were updated or published on a date or date range.\n\nFor more information on the syntax of the date range, see \"[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates).\"", - "in": "query", - "schema": { - "type": "string" - } - }, - { - "name": "epss_percentage", - "in": "query", - "description": "If specified, only return advisories that have an EPSS percentage score that matches the provided value.\nThe EPSS percentage represents the likelihood of a CVE being exploited.", - "schema": { - "type": "string" - } + }, + "description": "The direction to sort results. Can be `asc` or `desc`." }, { - "name": "epss_percentile", + "name": "state", "in": "query", - "description": "If specified, only return advisories that have an EPSS percentile score that matches the provided value.\nThe EPSS percentile represents the relative rank of the CVE's likelihood of being exploited compared to other CVEs.", "schema": { "type": "string" - } - }, - { - "$ref": "#/components/parameters/pagination-before" - }, - { - "$ref": "#/components/parameters/pagination-after" - }, - { - "$ref": "#/components/parameters/direction" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." }, { - "name": "per_page", - "description": "The number of results per page (max 100). For more information, see \"[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api).\"", + "name": "is_archived", "in": "query", "schema": { - "type": "integer", - "minimum": 1, - "maximum": 100, - "default": 30 - } + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." }, { - "name": "sort", - "description": "The property to sort the results by.", + "name": "since", "in": "query", - "required": false, "schema": { "type": "string", - "enum": [ - "updated", - "published", - "epss_percentage", - "epss_percentile" - ], - "default": "published" - } + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" } ], "responses": { "200": { - "description": "Response", + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, "content": { "application/json": { "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/global-advisory" + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } } }, "examples": { "default": { - "$ref": "#/components/examples/global-advisory-items" + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } } } } } }, - "429": { - "description": "Too many requests", + "400": { + "description": "Bad request", "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/basic-error" + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } } } } }, "422": { - "$ref": "#/components/responses/validation_failed_simple" + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "security-advisories", - "subcategory": "global-advisories" } } }, - "/advisories/{ghsa_id}": { + "/agents/tasks/{task_id}": { "get": { - "summary": "Get a global security advisory", - "description": "Gets a global security advisory using its GitHub Security Advisory (GHSA) identifier.", + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", "tags": [ - "security-advisories" + "agent-tasks" ], - "operationId": "security-advisories/get-global-advisory", + "operationId": "agent-tasks/get-task-by-id", "externalDocs": { "description": "API method documentation", - "url": "https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory" + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" }, "parameters": [ { - "$ref": "#/components/parameters/ghsa_id" + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." } ], "responses": { "200": { - "description": "Response", + "description": "Task retrieved successfully", "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/global-advisory" + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] }, "examples": { "default": { - "$ref": "#/components/examples/global-advisory" + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } } } } } }, "404": { - "$ref": "#/components/responses/not_found" + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "security-advisories", - "subcategory": "global-advisories" } } }, @@ -10609,7 +13905,18 @@ "content": { "application/json": { "schema": { - "$ref": "#/components/schemas/oidc-custom-sub" + "title": "Actions OIDC Subject customization", + "description": "Actions OIDC Subject customization", + "type": "object", + "properties": { + "include_claim_keys": { + "description": "Array of unique strings. Each claim key can only contain alphanumeric characters and underscores.", + "type": "array", + "items": { + "type": "string" + } + } + } }, "examples": { "default": { @@ -14390,6 +17697,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -14437,7 +17749,10 @@ "$ref": "#/components/schemas/artifact-deployment-record" } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -14591,6 +17906,11 @@ "digest" ] } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, "required": [ @@ -14639,7 +17959,10 @@ "$ref": "#/components/schemas/artifact-deployment-record" } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -14650,7 +17973,27 @@ } }, "403": { - "$ref": "#/components/responses/forbidden" + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + }, + "examples": { + "insufficient_repo_permissions": { + "value": { + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } + } + } + } + } + } }, "404": { "$ref": "#/components/responses/not_found" @@ -14773,6 +18116,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -14852,7 +18200,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -24234,7 +27585,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -24513,7 +27864,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -30654,6 +34005,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } }, "required": [ @@ -30795,6 +34159,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -108819,6 +112196,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -124174,6 +127552,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -124267,6 +127653,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -124284,6 +127678,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -124301,6 +127703,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -124369,6 +127779,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -124386,6 +127804,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -124403,6 +127829,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -124420,6 +127854,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -124437,6 +127879,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -133903,6 +137353,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -295301,12 +298752,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -298456,12 +301905,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -315191,12 +318638,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -315484,12 +318929,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", diff --git a/descriptions-next/api.github.com/api.github.com.yaml b/descriptions-next/api.github.com/api.github.com.yaml index 911f57a147..0b25177eff 100644 --- a/descriptions-next/api.github.com/api.github.com.yaml +++ b/descriptions-next/api.github.com/api.github.com.yaml @@ -103,6 +103,8 @@ tags: description: Endpoints to manage campaigns via the REST API. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -336,6 +338,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -7576,7 +10093,16 @@ paths: content: application/json: schema: - "$ref": "#/components/schemas/oidc-custom-sub" + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: default: "$ref": "#/components/examples/oidc-custom-sub" @@ -10380,6 +12906,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -10413,6 +12946,8 @@ paths: type: array items: "$ref": "#/components/schemas/artifact-deployment-record" + required: + - total_count examples: default: "$ref": "#/components/examples/artifact-deployment-record-list" @@ -10547,6 +13082,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -10580,11 +13122,26 @@ paths: type: array items: "$ref": "#/components/schemas/artifact-deployment-record" + required: + - total_count examples: default: "$ref": "#/components/examples/artifact-deployment-record-list" '403': - "$ref": "#/components/responses/forbidden" + description: Forbidden + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': "$ref": "#/components/responses/not_found" x-github: @@ -10687,6 +13244,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -10740,6 +13304,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -17577,7 +20143,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -17795,7 +20361,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -22170,6 +24736,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -22271,6 +24850,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -78708,6 +81300,7 @@ components: - unknown - direct - transitive + - inconclusive - security_advisory: "$ref": "#/components/schemas/dependabot-alert-security-advisory" @@ -90081,6 +92674,12 @@ components: commit_url: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -90157,6 +92756,12 @@ components: description: The API URL to get the issue where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url secret-scanning-location-issue-body: @@ -90170,6 +92775,12 @@ components: description: The API URL to get the issue where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url secret-scanning-location-issue-comment: @@ -90183,6 +92794,12 @@ components: description: The API URL to get the issue comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url secret-scanning-location-discussion-title: @@ -90237,6 +92854,12 @@ components: description: The API URL to get the pull request where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url secret-scanning-location-pull-request-body: @@ -90251,6 +92874,12 @@ components: description: The API URL to get the pull request where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url secret-scanning-location-pull-request-comment: @@ -90266,6 +92895,13 @@ components: was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment where the secret + was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url secret-scanning-location-pull-request-review: @@ -90281,6 +92917,13 @@ components: was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review where the secret + was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url secret-scanning-location-pull-request-review-comment: @@ -90296,6 +92939,13 @@ components: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review comment where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url secret-scanning-first-detected-location: @@ -97155,6 +99805,7 @@ components: - unknown - direct - transitive + - inconclusive - security_advisory: "$ref": "#/components/schemas/dependabot-alert-security-advisory" @@ -216519,7 +219170,7 @@ components: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -219549,7 +222200,7 @@ components: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -233831,7 +236482,7 @@ components: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -234040,7 +236691,7 @@ components: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json index 511d3240c8..ec517cd96f 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json @@ -195,6 +195,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -1352,12 +1356,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -2218,6 +2220,3298 @@ } } }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks": { + "get": { + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks/{task_id}": { + "get": { + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, "/app": { "get": { "summary": "Get the authenticated app", @@ -24921,6 +28215,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -26445,12 +29740,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -91009,10 +94302,7 @@ "type": "string" } } - }, - "required": [ - "include_claim_keys" - ] + } }, "examples": { "default": { @@ -106592,6 +109882,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -106695,8 +109990,347 @@ } } } + }, + "required": [ + "total_count" + ] + }, + "examples": { + "default": { + "value": { + "total_count": 1, + "deployment_records": [ + { + "id": 123, + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "logical_environment": "prod", + "physical_environment": "pacific-east", + "cluster": "moda-1", + "deployment_name": "prod-deployment", + "tags": { + "data": "sensitive" + }, + "created": "2011-01-26T19:14:43Z", + "updated_at": "2011-01-26T19:14:43Z", + "attestation_id": 456 + } + ] + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "artifact-metadata" + } + } + }, + "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { + "post": { + "summary": "Set cluster deployment records", + "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", + "tags": [ + "orgs" + ], + "operationId": "orgs/set-cluster-deployment-records", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "cluster", + "in": "path", + "description": "The cluster name.", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 128, + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "logical_environment": { + "type": "string", + "description": "The stage of the deployment.", + "minLength": 1, + "maxLength": 128 + }, + "physical_environment": { + "type": "string", + "description": "The physical region of the deployment.", + "maxLength": 128 + }, + "deployments": { + "type": "array", + "description": "The list of deployments to record.", + "maxItems": 1000, + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", + "minLength": 1, + "maxLength": 256 + }, + "digest": { + "type": "string", + "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", + "minLength": 71, + "maxLength": 71, + "pattern": "^sha256:[a-f0-9]{64}$" + }, + "version": { + "type": "string", + "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", + "maxLength": 100, + "x-multi-segment": true, + "examples": [ + "1.2.3" + ] + }, + "status": { + "type": "string", + "description": "The deployment status of the artifact.", + "default": "deployed", + "enum": [ + "deployed", + "decommissioned" + ] + }, + "deployment_name": { + "type": "string", + "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", + "minLength": 1, + "maxLength": 256 + }, + "github_repository": { + "type": "string", + "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", + "maxLength": 100, + "pattern": "^[A-Za-z0-9.\\-_]+$", + "examples": [ + "my-github-repo" + ] + }, + "tags": { + "type": "object", + "description": "Key-value pairs to tag the deployment record.", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + } + }, + "required": [ + "name", + "deployment_name", + "digest" + ] + } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, + "required": [ + "logical_environment", + "deployments" + ] + }, + "examples": { + "default": { + "value": { + "logical_environment": "prod", + "physical_environment": "pacific-east", + "deployments": [ + { + "name": "awesome-image", + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "version": "2.1.0", + "status": "deployed", + "deployment_name": "deployment-pod", + "tags": { + "runtime-risk": "sensitive-data" + } + } + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Deployment records created or updated successfully.\n", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "total_count": { + "description": "The number of deployment records created", + "type": "integer" + }, + "deployment_records": { + "type": "array", + "items": { + "title": "Artifact Deployment Record", + "description": "Artifact Metadata Deployment Record", + "type": "object", + "properties": { + "id": { + "type": "integer" + }, + "digest": { + "type": "string" + }, + "logical_environment": { + "type": "string" + }, + "physical_environment": { + "type": "string" + }, + "cluster": { + "type": "string" + }, + "deployment_name": { + "type": "string" + }, + "tags": { + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + }, + "created_at": { + "type": "string" + }, + "updated_at": { + "type": "string" + }, + "attestation_id": { + "type": [ + "integer", + "null" + ], + "description": "The ID of the provenance attestation associated with the deployment record." + } + } + } + } + }, + "required": [ + "total_count" + ] + }, "examples": { "default": { "value": { @@ -106745,332 +110379,17 @@ "type": "string" } } - } - } - } - }, - "404": { - "description": "Resource not found", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "artifact-metadata" - } - } - }, - "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { - "post": { - "summary": "Set cluster deployment records", - "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", - "tags": [ - "orgs" - ], - "operationId": "orgs/set-cluster-deployment-records", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "cluster", - "in": "path", - "description": "The cluster name.", - "required": true, - "schema": { - "type": "string", - "minLength": 1, - "maxLength": 128, - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "logical_environment": { - "type": "string", - "description": "The stage of the deployment.", - "minLength": 1, - "maxLength": 128 - }, - "physical_environment": { - "type": "string", - "description": "The physical region of the deployment.", - "maxLength": 128 - }, - "deployments": { - "type": "array", - "description": "The list of deployments to record.", - "maxItems": 1000, - "items": { - "type": "object", - "properties": { - "name": { - "type": "string", - "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", - "minLength": 1, - "maxLength": 256 - }, - "digest": { - "type": "string", - "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", - "minLength": 71, - "maxLength": 71, - "pattern": "^sha256:[a-f0-9]{64}$" - }, - "version": { - "type": "string", - "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", - "maxLength": 100, - "x-multi-segment": true, - "examples": [ - "1.2.3" - ] - }, - "status": { - "type": "string", - "description": "The deployment status of the artifact.", - "default": "deployed", - "enum": [ - "deployed", - "decommissioned" - ] - }, - "deployment_name": { - "type": "string", - "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", - "minLength": 1, - "maxLength": 256 - }, - "github_repository": { - "type": "string", - "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", - "maxLength": 100, - "pattern": "^[A-Za-z0-9.\\-_]+$", - "examples": [ - "my-github-repo" - ] - }, - "tags": { - "type": "object", - "description": "Key-value pairs to tag the deployment record.", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - } - }, - "required": [ - "name", - "deployment_name", - "digest" - ] - } - } - }, - "required": [ - "logical_environment", - "deployments" - ] - }, - "examples": { - "default": { - "value": { - "logical_environment": "prod", - "physical_environment": "pacific-east", - "deployments": [ - { - "name": "awesome-image", - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "version": "2.1.0", - "status": "deployed", - "deployment_name": "deployment-pod", - "tags": { - "runtime-risk": "sensitive-data" - } - } - ] - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Deployment records created or updated successfully.\n", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "total_count": { - "description": "The number of deployment records created", - "type": "integer" - }, - "deployment_records": { - "type": "array", - "items": { - "title": "Artifact Deployment Record", - "description": "Artifact Metadata Deployment Record", - "type": "object", - "properties": { - "id": { - "type": "integer" - }, - "digest": { - "type": "string" - }, - "logical_environment": { - "type": "string" - }, - "physical_environment": { - "type": "string" - }, - "cluster": { - "type": "string" - }, - "deployment_name": { - "type": "string" - }, - "tags": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - }, - "created_at": { - "type": "string" - }, - "updated_at": { - "type": "string" - }, - "attestation_id": { - "type": [ - "integer", - "null" - ], - "description": "The ID of the provenance attestation associated with the deployment record." - } - } - } - } - } }, "examples": { - "default": { + "insufficient_repo_permissions": { "value": { - "total_count": 1, - "deployment_records": [ - { - "id": 123, - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "logical_environment": "prod", - "physical_environment": "pacific-east", - "cluster": "moda-1", - "deployment_name": "prod-deployment", - "tags": { - "data": "sensitive" - }, - "created": "2011-01-26T19:14:43Z", - "updated_at": "2011-01-26T19:14:43Z", - "attestation_id": 456 - } - ] - } - } - } - } - } - }, - "403": { - "description": "Forbidden", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } } } } @@ -107227,6 +110546,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -107306,7 +110630,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -130366,6 +133693,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -131890,12 +135218,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -175993,7 +179319,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -176784,7 +180110,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -238146,6 +241472,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -238239,6 +241573,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -238256,6 +241598,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -238273,6 +241623,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -238341,6 +241699,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -238358,6 +241724,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -238375,6 +241749,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -238392,6 +241774,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -238409,6 +241799,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -244063,338 +247461,364 @@ }, "network_settings_ids": { "type": "array", - "minItems": 1, + "minItems": 1, + "maxItems": 1, + "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." + } + }, + "required": [ + "name", + "network_settings_ids" + ] + }, + "examples": { + "default": { + "value": { + "name": "my-network-configuration", + "network_settings_ids": [ + "23456789ABDCEF1" + ], + "compute_service": "actions" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "network-configurations" + } + } + }, + "/orgs/{org}/settings/network-configurations/{network_configuration_id}": { + "get": { + "summary": "Get a hosted compute network configuration for an organization", + "description": "Gets a hosted compute network configuration configured in an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `read:network_configurations` scope to use this endpoint.", + "tags": [ + "hosted-compute" + ], + "operationId": "hosted-compute/get-network-configuration-for-org", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + }, + "headers": { + "Link": { + "example": "; rel=\"next\", ; rel=\"last\"", + "schema": { + "type": "string" + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "network-configurations" + } + }, + "patch": { + "summary": "Update a hosted compute network configuration for an organization", + "description": "Updates a hosted compute network configuration for an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `write:network_configurations` scope to use this endpoint.", + "tags": [ + "hosted-compute" + ], + "operationId": "hosted-compute/update-network-configuration-for-org", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.", + "type": "string" + }, + "compute_service": { + "description": "The hosted compute service to use for the network configuration.", + "type": "string", + "enum": [ + "none", + "actions" + ] + }, + "network_settings_ids": { + "type": "array", + "minItems": 0, "maxItems": 1, "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } - } - }, - "required": [ - "name", - "network_settings_ids" - ] - }, - "examples": { - "default": { - "value": { - "name": "my-network-configuration", - "network_settings_ids": [ - "23456789ABDCEF1" - ], - "compute_service": "actions" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "network-configurations" - } - } - }, - "/orgs/{org}/settings/network-configurations/{network_configuration_id}": { - "get": { - "summary": "Get a hosted compute network configuration for an organization", - "description": "Gets a hosted compute network configuration configured in an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `read:network_configurations` scope to use this endpoint.", - "tags": [ - "hosted-compute" - ], - "operationId": "hosted-compute/get-network-configuration-for-org", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } - }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - }, - "headers": { - "Link": { - "example": "; rel=\"next\", ; rel=\"last\"", - "schema": { - "type": "string" - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "network-configurations" - } - }, - "patch": { - "summary": "Update a hosted compute network configuration for an organization", - "description": "Updates a hosted compute network configuration for an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `write:network_configurations` scope to use this endpoint.", - "tags": [ - "hosted-compute" - ], - "operationId": "hosted-compute/update-network-configuration-for-org", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "name": { - "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.", - "type": "string" - }, - "compute_service": { - "description": "The hosted compute service to use for the network configuration.", - "type": "string", - "enum": [ - "none", - "actions" - ] - }, - "network_settings_ids": { + "failover_network_settings_ids": { "type": "array", "minItems": 0, "maxItems": 1, - "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -378414,6 +381838,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -379386,12 +382811,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -379903,6 +383326,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -380884,12 +384308,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", @@ -381221,6 +384643,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -621194,6 +624617,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -621287,6 +624718,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -621304,6 +624743,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -621321,6 +624768,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -621389,6 +624844,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -621406,6 +624869,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -621423,6 +624894,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -621440,6 +624919,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -621457,6 +624944,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -622605,6 +626100,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -622698,6 +626201,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -622715,6 +626226,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -622732,6 +626251,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -622800,6 +626327,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -622817,6 +626352,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -622834,6 +626377,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -622851,6 +626402,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -622868,6 +626427,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -623999,6 +627566,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -624092,6 +627667,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -624109,6 +627692,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -624126,6 +627717,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -624194,6 +627793,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -624211,6 +627818,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -624228,6 +627843,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -624245,6 +627868,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -624262,6 +627893,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -624707,6 +628346,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -624800,6 +628447,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -624817,6 +628472,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -624834,6 +628497,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -624902,6 +628573,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -624919,6 +628598,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -624936,6 +628623,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -624953,6 +628648,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -624970,6 +628673,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -917763,6 +921474,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -920747,6 +924459,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -923731,6 +927444,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -926715,6 +930429,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -929699,6 +933414,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -932683,6 +936399,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -935667,6 +939384,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -938651,6 +942369,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1567377,6 +1571096,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -1567470,6 +1571197,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1567487,6 +1571222,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1567504,6 +1571247,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -1567572,6 +1571323,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1567589,6 +1571348,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1567606,6 +1571373,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -1567623,6 +1571398,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -1567640,6 +1571423,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml index 99aa116b3a..933564beac 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml @@ -103,6 +103,8 @@ tags: description: Endpoints to manage campaigns via the REST API. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -905,7 +907,7 @@ paths: - subscriptions_url - type - url - type: &314 + type: &313 type: string description: The type of credit the user is receiving. enum: @@ -994,7 +996,7 @@ paths: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -1071,7 +1073,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory parameters: - - &631 + - &630 name: ghsa_id description: The GHSA (GitHub Security Advisory) identifier of the advisory. in: path @@ -1161,6 +1163,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -1656,7 +4173,7 @@ paths: schema: type: integer default: 30 - - &204 + - &203 name: cursor description: 'Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the `link` header for the next and previous @@ -1665,7 +4182,7 @@ paths: required: false schema: type: string - - &205 + - &204 name: status description: Returns webhook deliveries filtered by delivery outcome classification based on `status_code` range. A `status` of `success` returns deliveries @@ -1685,7 +4202,7 @@ paths: application/json: schema: type: array - items: &206 + items: &205 title: Simple webhook delivery description: Delivery made by a webhook, without request and response information. @@ -1781,7 +4298,7 @@ paths: - installation_id - repository_id examples: - default: &207 + default: &206 value: - id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -1916,7 +4433,7 @@ paths: description: Response content: application/json: - schema: &208 + schema: &207 title: Webhook delivery description: Delivery made by a webhook. type: object @@ -2051,7 +4568,7 @@ paths: - request - response examples: - default: &209 + default: &208 value: id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -8323,7 +10840,7 @@ paths: description: Response content: application/json: - schema: &182 + schema: &181 type: array description: A list of default code security configurations items: @@ -8339,7 +10856,7 @@ paths: default configuration: *47 examples: - default: &183 + default: &182 value: - default_for_new_repos: public configuration: @@ -8679,7 +11196,7 @@ paths: - *38 - *49 responses: - '204': &184 + '204': &183 description: A header with no content is returned. '400': *14 '403': *27 @@ -8806,7 +11323,7 @@ paths: default: value: default_for_new_repos: all - configuration: &181 + configuration: &180 value: id: 1325 target_type: organization @@ -8891,7 +11408,7 @@ paths: application/json: schema: type: array - items: &185 + items: &184 type: object description: Repositories associated with a code security configuration and attachment status @@ -9236,7 +11753,7 @@ paths: summary: Example of code security configuration repositories value: - status: attached - repository: &186 + repository: &185 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -9537,7 +12054,7 @@ paths: url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-an-enterprise parameters: - *38 - - &190 + - &189 name: state in: query description: |- @@ -9546,7 +12063,7 @@ paths: Can be: `auto_dismissed`, `dismissed`, `fixed`, `open` schema: type: string - - &191 + - &190 name: severity in: query description: |- @@ -9555,7 +12072,7 @@ paths: Can be: `low`, `medium`, `high`, `critical` schema: type: string - - &192 + - &191 name: ecosystem in: query description: |- @@ -9564,14 +12081,14 @@ paths: Can be: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust` schema: type: string - - &193 + - &192 name: package in: query description: A comma-separated list of package names. If specified, only alerts for these packages will be returned. schema: type: string - - &194 + - &193 name: epss_percentage in: query description: |- @@ -9583,7 +12100,7 @@ paths: Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. schema: type: string - - &471 + - &470 name: has in: query description: |- @@ -9597,7 +12114,7 @@ paths: type: string enum: - patch - - &195 + - &194 name: assignee in: query description: |- @@ -9606,7 +12123,7 @@ paths: Use `*` to list alerts with at least one assignee or `none` to list alerts with no assignees. schema: type: string - - &196 + - &195 name: scope in: query description: The scope of the vulnerable dependency. If specified, only alerts @@ -9616,7 +12133,7 @@ paths: enum: - development - runtime - - &197 + - &196 name: sort in: query description: |- @@ -9642,11 +12159,11 @@ paths: application/json: schema: type: array - items: &198 + items: &197 type: object description: A Dependabot alert. properties: - number: &171 + number: &170 type: integer description: The security alert number. readOnly: true @@ -9711,8 +12228,9 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: &472 + security_advisory: &471 type: object description: Details for the GitHub Security Advisory. readOnly: true @@ -9919,29 +12437,29 @@ paths: - withdrawn_at additionalProperties: false security_vulnerability: *63 - url: &174 + url: &173 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &175 + html_url: &174 type: string description: The GitHub URL of the alert resource. format: uri readOnly: true - created_at: &172 + created_at: &171 type: string description: 'The time that the alert was created in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - updated_at: &173 + updated_at: &172 type: string description: 'The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissed_at: &177 + dismissed_at: &176 type: - string - 'null' @@ -9972,7 +12490,7 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: &176 + fixed_at: &175 type: - string - 'null' @@ -9980,7 +12498,7 @@ paths: and was considered fixed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - auto_dismissed_at: &473 + auto_dismissed_at: &472 type: - string - 'null' @@ -9988,7 +12506,7 @@ paths: ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissal_request: &474 + dismissal_request: &473 title: Dependabot alert dismissal request description: Information about an active dismissal request for this Dependabot alert. @@ -10051,7 +12569,7 @@ paths: - repository additionalProperties: false examples: - default: &199 + default: &198 value: - number: 2 state: dismissed @@ -10100,7 +12618,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -11415,7 +13933,7 @@ paths: properties: action: type: string - discussion: &722 + discussion: &721 title: Discussion description: A Discussion in a repository. type: object @@ -11916,7 +14434,7 @@ paths: milestone: anyOf: - type: 'null' - - &266 + - &265 title: Milestone description: A collection of related issues and pull requests. @@ -12088,7 +14606,7 @@ paths: timeline_url: type: string format: uri - type: &230 + type: &229 title: Issue Type description: The type of issue. type: @@ -12199,7 +14717,7 @@ paths: - hooray - eyes - rocket - sub_issues_summary: &643 + sub_issues_summary: &642 title: Sub-issues Summary type: object properties: @@ -12283,7 +14801,7 @@ paths: pin: anyOf: - type: 'null' - - &544 + - &543 title: Pinned Issue Comment description: Context around who pinned an issue comment and when it was pinned. @@ -12310,7 +14828,7 @@ paths: - url - created_at - updated_at - issue_dependencies_summary: &644 + issue_dependencies_summary: &643 title: Issue Dependencies Summary type: object properties: @@ -12329,7 +14847,7 @@ paths: - total_blocking issue_field_values: type: array - items: &529 + items: &528 title: Issue Field Value description: A value assigned to an issue field type: object @@ -13110,7 +15628,7 @@ paths: type: string release: allOf: - - &576 + - &575 title: Release description: A release. type: object @@ -13192,7 +15710,7 @@ paths: author: *4 assets: type: array - items: &577 + items: &576 title: Release Asset description: Data related to a release. type: object @@ -13795,7 +16313,7 @@ paths: url: type: string format: uri - user: &650 + user: &649 title: Public User description: Public User type: object @@ -15692,7 +18210,7 @@ paths: - closed - all default: open - - &233 + - &232 name: labels description: 'A list of comma separated label names. Example: `bug,ui,@high`' in: query @@ -15743,7 +18261,7 @@ paths: type: array items: *81 examples: - default: &234 + default: &233 value: - id: 1 node_id: MDU6SXNzdWUx @@ -17155,14 +19673,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/events#list-public-events-for-a-network-of-repositories parameters: - - &325 + - &324 name: owner description: The account owner of the repository. The name is not case sensitive. in: path required: true schema: type: string - - &326 + - &325 name: repo description: The name of the repository without the `.git` extension. The name is not case sensitive. @@ -17224,7 +19742,7 @@ paths: '404': *6 '403': *27 '304': *35 - '301': &329 + '301': &328 description: Moved permanently content: application/json: @@ -17246,7 +19764,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#list-notifications-for-the-authenticated-user parameters: - - &552 + - &551 name: all description: If `true`, show notifications marked as read. in: query @@ -17254,7 +19772,7 @@ paths: schema: type: boolean default: false - - &553 + - &552 name: participating description: If `true`, only shows notifications in which the user is directly participating or mentioned. @@ -17264,7 +19782,7 @@ paths: type: boolean default: false - *86 - - &554 + - &553 name: before description: 'Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: @@ -17296,7 +19814,7 @@ paths: properties: id: type: string - repository: &153 + repository: &152 title: Minimal Repository description: Minimal Repository type: object @@ -17646,7 +20164,7 @@ paths: type: boolean examples: - false - security_and_analysis: &281 + security_and_analysis: &280 type: - object - 'null' @@ -17850,7 +20368,7 @@ paths: - url - subscription_url examples: - default: &555 + default: &554 value: - id: '1' repository: @@ -19420,7 +21938,7 @@ paths: required: false schema: type: string - - &699 + - &698 name: model description: The model name to query usage for. The name is not case sensitive. in: query @@ -19566,7 +22084,7 @@ paths: parameters: - *73 - *115 - - &700 + - &699 name: month description: If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the @@ -19678,7 +22196,7 @@ paths: - *115 - *117 - *116 - - &701 + - &700 name: repository description: The repository name to query for usage in the format owner/repository. in: query @@ -19686,7 +22204,7 @@ paths: schema: type: string - *118 - - &702 + - &701 name: sku description: The SKU to query for usage. in: query @@ -20665,7 +23183,7 @@ paths: type: integer repository_cache_usages: type: array - items: &336 + items: &335 title: Actions Cache Usage by repository description: GitHub Actions Cache Usage by repository. type: object @@ -20913,7 +23431,7 @@ paths: - public_ip_enabled - platform examples: - default: &152 + default: &151 value: total_count: 2 runners: @@ -21908,7 +24426,7 @@ paths: description: A JSON serialized template for OIDC subject claim customization content: application/json: - schema: &135 + schema: title: Actions OIDC Subject customization description: Actions OIDC Subject customization type: object @@ -21922,7 +24440,7 @@ paths: required: - include_claim_keys examples: - default: &136 + default: &135 value: include_claim_keys: - repo @@ -21949,15 +24467,25 @@ paths: required: true content: application/json: - schema: *135 + schema: + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: - default: *136 + default: *135 responses: '201': description: Empty response content: application/json: - schema: &162 + schema: &161 title: Empty Object description: An object without any properties. type: object @@ -21996,7 +24524,7 @@ paths: schema: type: object properties: - enabled_repositories: &137 + enabled_repositories: &136 type: string description: The policy that controls the repositories in the organization that are allowed to run GitHub Actions. @@ -22009,7 +24537,7 @@ paths: description: The API URL to use to get or set the selected repositories that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`. - allowed_actions: &138 + allowed_actions: &137 type: string description: The permissions policy that controls the actions and reusable workflows that are allowed to run. @@ -22017,12 +24545,12 @@ paths: - all - local_only - selected - selected_actions_url: &342 + selected_actions_url: &341 type: string description: The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` is set to `selected`. - sha_pinning_required: &139 + sha_pinning_required: &138 type: boolean description: Whether actions must be pinned to a full-length commit SHA. @@ -22064,9 +24592,9 @@ paths: schema: type: object properties: - enabled_repositories: *137 - allowed_actions: *138 - sha_pinning_required: *139 + enabled_repositories: *136 + allowed_actions: *137 + sha_pinning_required: *138 required: - enabled_repositories examples: @@ -22100,7 +24628,7 @@ paths: description: Response content: application/json: - schema: &346 + schema: &345 type: object properties: days: @@ -22142,7 +24670,7 @@ paths: required: true content: application/json: - schema: &347 + schema: &346 type: object properties: days: @@ -22185,7 +24713,7 @@ paths: description: Response content: application/json: - schema: &140 + schema: &139 type: object properties: approval_policy: @@ -22199,7 +24727,7 @@ paths: required: - approval_policy examples: - default: &348 + default: &347 value: approval_policy: first_time_contributors '404': *6 @@ -22230,7 +24758,7 @@ paths: required: true content: application/json: - schema: *140 + schema: *139 examples: default: summary: Set approval policy to first time contributors @@ -22258,7 +24786,7 @@ paths: description: Response content: application/json: - schema: &349 + schema: &348 type: object required: - run_workflows_from_fork_pull_requests @@ -22284,7 +24812,7 @@ paths: description: Whether workflows triggered by pull requests from forks require approval from a repository administrator to run. examples: - default: &141 + default: &140 value: run_workflows_from_fork_pull_requests: true send_write_tokens_to_workflows: false @@ -22312,7 +24840,7 @@ paths: required: true content: application/json: - schema: &350 + schema: &349 type: object required: - run_workflows_from_fork_pull_requests @@ -22335,7 +24863,7 @@ paths: description: Whether workflows triggered by pull requests from forks require approval from a repository administrator to run. examples: - default: *141 + default: *140 responses: '204': description: Empty response for successful settings update @@ -22385,7 +24913,7 @@ paths: type: array items: *77 examples: - default: &145 + default: &144 value: total_count: 1 repositories: @@ -22570,7 +25098,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization parameters: - *73 - - &142 + - &141 name: repository_id description: The unique identifier of the repository. in: path @@ -22599,7 +25127,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -22628,7 +25156,7 @@ paths: description: Response content: application/json: - schema: &143 + schema: &142 type: object properties: github_owned_allowed: @@ -22650,7 +25178,7 @@ paths: items: type: string examples: - default: &144 + default: &143 value: github_owned_allowed: true verified_allowed: false @@ -22683,9 +25211,9 @@ paths: required: false content: application/json: - schema: *143 + schema: *142 examples: - selected_actions: *144 + selected_actions: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -22817,7 +25345,7 @@ paths: type: array items: *77 examples: - default: *145 + default: *144 '403': *27 '404': *6 x-github: @@ -22886,7 +25414,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#add-a-repository-to-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No content @@ -22913,7 +25441,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#remove-a-repository-from-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No content @@ -22947,17 +25475,17 @@ paths: description: Response content: application/json: - schema: &351 + schema: &350 type: object properties: - default_workflow_permissions: &146 + default_workflow_permissions: &145 type: string description: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. enum: - read - write - can_approve_pull_request_reviews: &147 + can_approve_pull_request_reviews: &146 type: boolean description: Whether GitHub Actions can approve pull requests. Enabling this can be a security risk. @@ -22965,7 +25493,7 @@ paths: - default_workflow_permissions - can_approve_pull_request_reviews examples: - default: &148 + default: &147 summary: Give read-only permission, and allow approving PRs. value: default_workflow_permissions: read @@ -22998,13 +25526,13 @@ paths: required: false content: application/json: - schema: &352 + schema: &351 type: object properties: - default_workflow_permissions: *146 - can_approve_pull_request_reviews: *147 + default_workflow_permissions: *145 + can_approve_pull_request_reviews: *146 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -23049,7 +25577,7 @@ paths: type: number runner_groups: type: array - items: &149 + items: &148 type: object properties: id: @@ -23239,9 +25767,9 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: - default: &151 + default: &150 value: id: 2 name: octo-runner-group @@ -23277,7 +25805,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#get-a-self-hosted-runner-group-for-an-organization parameters: - *73 - - &150 + - &149 name: runner_group_id description: Unique identifier of the self-hosted runner group. in: path @@ -23289,7 +25817,7 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: default: value: @@ -23326,7 +25854,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#update-a-self-hosted-runner-group-for-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -23382,9 +25910,9 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: - default: *151 + default: *150 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -23404,7 +25932,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#delete-a-self-hosted-runner-group-from-an-organization parameters: - *73 - - *150 + - *149 responses: '204': description: Response @@ -23428,7 +25956,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-github-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 - *17 - *19 responses: @@ -23448,7 +25976,7 @@ paths: type: array items: *123 examples: - default: *152 + default: *151 headers: Link: *65 x-github: @@ -23471,7 +25999,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 + - *149 - *19 - *17 responses: @@ -23489,9 +26017,9 @@ paths: type: number repositories: type: array - items: *153 + items: *152 examples: - default: &189 + default: &188 value: total_count: 1 repositories: @@ -23744,7 +26272,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#set-repository-access-for-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -23789,8 +26317,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#add-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 - - *142 + - *149 + - *141 responses: '204': description: Response @@ -23813,8 +26341,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#remove-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 - - *142 + - *149 + - *141 responses: '204': description: Response @@ -23838,7 +26366,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-self-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 - *17 - *19 responses: @@ -23856,7 +26384,7 @@ paths: type: number runners: type: array - items: &155 + items: &154 title: Self hosted runners description: A self hosted runner type: object @@ -23890,7 +26418,7 @@ paths: type: boolean labels: type: array - items: &158 + items: &157 title: Self hosted runner label description: A label for a self hosted runner type: object @@ -23920,7 +26448,7 @@ paths: - busy - labels examples: - default: &156 + default: &155 value: total_count: 2 runners: @@ -23980,7 +26508,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#set-self-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -24025,8 +26553,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#add-a-self-hosted-runner-to-a-group-for-an-organization parameters: - *73 - - *150 - - &154 + - *149 + - &153 name: runner_id description: Unique identifier of the self-hosted runner. in: path @@ -24055,8 +26583,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#remove-a-self-hosted-runner-from-a-group-for-an-organization parameters: - *73 - - *150 - - *154 + - *149 + - *153 responses: '204': description: Response @@ -24104,9 +26632,9 @@ paths: type: integer runners: type: array - items: *155 + items: *154 examples: - default: *156 + default: *155 headers: Link: *65 x-github: @@ -24138,7 +26666,7 @@ paths: application/json: schema: type: array - items: &353 + items: &352 title: Runner Application description: Runner Application type: object @@ -24163,7 +26691,7 @@ paths: - download_url - filename examples: - default: &354 + default: &353 value: - os: osx architecture: x64 @@ -24249,7 +26777,7 @@ paths: - no-gpu work_folder: _work responses: - '201': &355 + '201': &354 description: Response content: application/json: @@ -24259,7 +26787,7 @@ paths: - runner - encoded_jit_config properties: - runner: *155 + runner: *154 encoded_jit_config: type: string description: The base64 encoded runner configuration. @@ -24322,7 +26850,7 @@ paths: description: Response content: application/json: - schema: &157 + schema: &156 title: Authentication Token description: Authentication Token type: object @@ -24364,7 +26892,7 @@ paths: - token - expires_at examples: - default: &356 + default: &355 value: token: LLBF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-22T12:13:35.123-08:00' @@ -24401,9 +26929,9 @@ paths: description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: &357 + default: &356 value: token: AABF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-29T12:13:35.123-08:00' @@ -24429,15 +26957,15 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: '200': description: Response content: application/json: - schema: *155 + schema: *154 examples: - default: &358 + default: &357 value: id: 23 name: MBP @@ -24479,7 +27007,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-an-organization parameters: - *73 - - *154 + - *153 responses: '204': description: Response @@ -24506,9 +27034,9 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: - '200': &159 + '200': &158 description: Response content: application/json: @@ -24522,7 +27050,7 @@ paths: type: integer labels: type: array - items: *158 + items: *157 examples: default: value: @@ -24562,7 +27090,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 requestBody: required: true content: @@ -24586,7 +27114,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24611,7 +27139,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 requestBody: required: true content: @@ -24636,7 +27164,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24661,9 +27189,9 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: - '200': &359 + '200': &358 description: Response content: application/json: @@ -24677,7 +27205,7 @@ paths: type: integer labels: type: array - items: *158 + items: *157 examples: default: value: @@ -24719,8 +27247,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 - - &360 + - *153 + - &359 name: name description: The name of a self-hosted runner's custom label. in: path @@ -24728,7 +27256,7 @@ paths: schema: type: string responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24771,7 +27299,7 @@ paths: type: integer secrets: type: array - items: &160 + items: &159 title: Actions Secret for an Organization description: Secrets for GitHub Actions for an organization. type: object @@ -24852,7 +27380,7 @@ paths: description: Response content: application/json: - schema: &372 + schema: &371 title: ActionsPublicKey description: The public key used for setting Actions Secrets. type: object @@ -24887,7 +27415,7 @@ paths: - key_id - key examples: - default: &373 + default: &372 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -24913,7 +27441,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#get-an-organization-secret parameters: - *73 - - &161 + - &160 name: secret_name description: The name of the secret. in: path @@ -24925,7 +27453,7 @@ paths: description: Response content: application/json: - schema: *160 + schema: *159 examples: default: value: @@ -24956,7 +27484,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -25013,7 +27541,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -25040,7 +27568,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -25067,7 +27595,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -25085,9 +27613,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: &165 + default: &164 value: total_count: 1 repositories: @@ -25180,7 +27708,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -25233,7 +27761,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -25267,7 +27795,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -25300,7 +27828,7 @@ paths: url: https://docs.github.com/rest/actions/variables#list-organization-variables parameters: - *73 - - &341 + - &340 name: per_page description: The number of results per page (max 30). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -25324,7 +27852,7 @@ paths: type: integer variables: type: array - items: &163 + items: &162 title: Actions Variable for an Organization description: Organization variable for GitHub Actions. type: object @@ -25462,7 +27990,7 @@ paths: description: Response when creating a variable content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -25488,7 +28016,7 @@ paths: url: https://docs.github.com/rest/actions/variables#get-an-organization-variable parameters: - *73 - - &164 + - &163 name: name description: The name of the variable. in: path @@ -25500,7 +28028,7 @@ paths: description: Response content: application/json: - schema: *163 + schema: *162 examples: default: value: @@ -25531,7 +28059,7 @@ paths: url: https://docs.github.com/rest/actions/variables#update-an-organization-variable parameters: - *73 - - *164 + - *163 requestBody: required: true content: @@ -25594,7 +28122,7 @@ paths: url: https://docs.github.com/rest/actions/variables#delete-an-organization-variable parameters: - *73 - - *164 + - *163 responses: '204': description: Response @@ -25621,7 +28149,7 @@ paths: url: https://docs.github.com/rest/actions/variables#list-selected-repositories-for-an-organization-variable parameters: - *73 - - *164 + - *163 - *19 - *17 responses: @@ -25639,9 +28167,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 '409': description: Response when the visibility of the variable is not set to `selected` @@ -25668,7 +28196,7 @@ paths: url: https://docs.github.com/rest/actions/variables#set-selected-repositories-for-an-organization-variable parameters: - *73 - - *164 + - *163 requestBody: required: true content: @@ -25718,7 +28246,7 @@ paths: url: https://docs.github.com/rest/actions/variables#add-selected-repository-to-an-organization-variable parameters: - *73 - - *164 + - *163 - name: repository_id in: path required: true @@ -25753,7 +28281,7 @@ paths: url: https://docs.github.com/rest/actions/variables#remove-selected-repository-from-an-organization-variable parameters: - *73 - - *164 + - *163 - name: repository_id in: path required: true @@ -25882,6 +28410,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -25913,7 +28448,7 @@ paths: type: integer deployment_records: type: array - items: &166 + items: &165 title: Artifact Deployment Record description: Artifact Metadata Deployment Record type: object @@ -25957,8 +28492,10 @@ paths: - 'null' description: The ID of the provenance attestation associated with the deployment record. + required: + - total_count examples: - default: &167 + default: &166 value: total_count: 1 deployment_records: @@ -26102,6 +28639,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -26133,10 +28677,25 @@ paths: type: integer deployment_records: type: array - items: *166 + items: *165 + required: + - total_count examples: - default: *167 - '403': *27 + default: *166 + '403': + description: Forbidden + content: + application/json: + schema: *3 + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': *6 x-github: githubCloudOnly: false @@ -26238,6 +28797,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -26291,6 +28857,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -26349,9 +28917,9 @@ paths: - 3 deployment_records: type: array - items: *166 + items: *165 examples: - default: *167 + default: *166 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -26481,12 +29049,12 @@ paths: required: - subject_digests examples: - default: &681 + default: &680 value: subject_digests: - sha256:abc123 - sha512:def456 - withPredicateType: &682 + withPredicateType: &681 value: subject_digests: - sha256:abc123 @@ -26545,7 +29113,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: &683 + default: &682 value: attestations_subject_digests: - sha256:abc: @@ -26896,7 +29464,7 @@ paths: initiator: type: string examples: - default: &386 + default: &385 value: attestations: - bundle: @@ -27115,7 +29683,7 @@ paths: description: If specified, only campaigns with this state will be returned. in: query required: false - schema: &168 + schema: &167 title: Campaign state description: Indicates whether a campaign is open or closed type: string @@ -27141,7 +29709,7 @@ paths: application/json: schema: type: array - items: &169 + items: &168 title: Campaign summary description: The campaign metadata and alert stats. type: object @@ -27172,7 +29740,7 @@ paths: team_managers: description: The campaign team managers type: array - items: &188 + items: &187 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -27249,7 +29817,7 @@ paths: parent: anyOf: - type: 'null' - - &245 + - &244 title: Team Simple description: Groups of organization members that gives permissions on specified repositories. @@ -27385,7 +29953,7 @@ paths: - string - 'null' format: date-time - state: *168 + state: *167 contact_link: description: The contact link of the campaign. type: @@ -27608,9 +30176,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: &170 + default: &169 value: number: 3 created_at: '2024-02-14T12:29:18Z' @@ -27693,9 +30261,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: *170 + default: *169 '404': *6 '422': description: Unprocessable Entity @@ -27773,7 +30341,7 @@ paths: - string - 'null' format: uri - state: *168 + state: *167 examples: default: value: @@ -27783,9 +30351,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: *170 + default: *169 '400': description: Bad Request content: @@ -27852,17 +30420,17 @@ paths: url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization parameters: - *73 - - &410 + - &409 name: tool_name description: The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either `tool_name` or `tool_guid`, but not both. in: query required: false - schema: &178 + schema: &177 type: string description: The name of the tool used to generate the code scanning analysis. - - &411 + - &410 name: tool_guid description: The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in @@ -27870,7 +30438,7 @@ paths: or `tool_name`, but not both. in: query required: false - schema: &179 + schema: &178 type: - string - 'null' @@ -27886,7 +30454,7 @@ paths: be returned. in: query required: false - schema: &413 + schema: &412 type: string description: State of a code scanning alert. enum: @@ -27909,7 +30477,7 @@ paths: be returned. in: query required: false - schema: &414 + schema: &413 type: string description: Severity of a code scanning alert. enum: @@ -27938,18 +30506,18 @@ paths: items: type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: &415 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: &414 type: string description: The REST API URL for fetching the list of instances for an alert. format: uri readOnly: true - state: &180 + state: &179 type: - string - 'null' @@ -27959,13 +30527,13 @@ paths: - dismissed - fixed - - fixed_at: *176 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: &416 + dismissed_at: *176 + dismissed_reason: &415 type: - string - 'null' @@ -27976,14 +30544,14 @@ paths: - won't fix - used in tests - - dismissed_comment: &417 + dismissed_comment: &416 type: - string - 'null' description: The dismissal comment associated with the dismissal of the alert. maxLength: 280 - rule: &418 + rule: &417 type: object properties: id: @@ -28044,43 +30612,43 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: &419 + tool: &418 type: object properties: - name: *178 + name: *177 version: type: - string - 'null' description: The version of the tool used to generate the code scanning analysis. - guid: *179 - most_recent_instance: &420 + guid: *178 + most_recent_instance: &419 type: object properties: - ref: &412 + ref: &411 type: string description: |- The Git reference, formatted as `refs/pull//merge`, `refs/pull//head`, `refs/heads/` or simply ``. - analysis_key: &430 + analysis_key: &429 type: string description: Identifies the configuration under which the analysis was executed. For example, in GitHub Actions this includes the workflow filename and job name. - environment: &431 + environment: &430 type: string description: Identifies the variable values associated with the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed. - category: &432 + category: &431 type: string description: Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. - state: *180 + state: *179 commit_sha: type: string message: @@ -28094,7 +30662,7 @@ paths: with placeholder links for related locations replaced by links to the relevant code. Only populated when related locations are available for the alert instance. - location: &433 + location: &432 type: object description: Describe a region within a file for the alert. properties: @@ -28115,7 +30683,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: &434 + items: &433 type: - string - 'null' @@ -28751,7 +31319,7 @@ paths: application/json: schema: *47 examples: - default: *181 + default: *180 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28779,9 +31347,9 @@ paths: description: Response content: application/json: - schema: *182 + schema: *181 examples: - default: *183 + default: *182 '304': *35 '403': *27 '404': *6 @@ -28833,7 +31401,7 @@ paths: - 32 - 91 responses: - '204': *184 + '204': *183 '400': *14 '403': *27 '404': *6 @@ -28868,7 +31436,7 @@ paths: application/json: schema: *47 examples: - default: *181 + default: *180 '304': *35 '403': *27 '404': *6 @@ -29168,7 +31736,7 @@ paths: - *73 - *49 responses: - '204': *184 + '204': *183 '400': *14 '403': *27 '404': *6 @@ -29306,7 +31874,7 @@ paths: default: value: default_for_new_repos: all - configuration: *181 + configuration: *180 '403': *27 '404': *6 x-github: @@ -29359,13 +31927,13 @@ paths: application/json: schema: type: array - items: *185 + items: *184 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: *186 + repository: *185 '403': *27 '404': *6 x-github: @@ -29405,7 +31973,7 @@ paths: type: integer codespaces: type: array - items: &235 + items: &234 type: object title: Codespace description: A codespace. @@ -29436,11 +32004,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *153 + repository: *152 machine: anyOf: - type: 'null' - - &446 + - &445 type: object title: Codespace machine description: A description of the machine powering a codespace. @@ -29727,7 +32295,7 @@ paths: - pulls_url - recent_folders examples: - default: &236 + default: &235 value: total_count: 3 codespaces: @@ -30351,7 +32919,7 @@ paths: type: integer secrets: type: array - items: &187 + items: &186 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -30392,7 +32960,7 @@ paths: - updated_at - visibility examples: - default: &447 + default: &446 value: total_count: 2 secrets: @@ -30430,7 +32998,7 @@ paths: description: Response content: application/json: - schema: &448 + schema: &447 title: CodespacesPublicKey description: The public key used for setting Codespaces secrets. type: object @@ -30465,7 +33033,7 @@ paths: - key_id - key examples: - default: &449 + default: &448 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -30489,15 +33057,15 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#get-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *187 + schema: *186 examples: - default: &451 + default: &450 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -30525,7 +33093,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -30580,7 +33148,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -30607,7 +33175,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -30633,7 +33201,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -30651,9 +33219,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 '404': *6 x-github: githubCloudOnly: false @@ -30676,7 +33244,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -30727,7 +33295,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -30761,7 +33329,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -30964,7 +33532,7 @@ paths: currently being billed. seats: type: array - items: &238 + items: &237 title: Copilot Business Seat Detail description: Information about a Copilot Business seat assignment for a user, team, or organization. @@ -30982,7 +33550,7 @@ paths: description: The team through which the assignee is granted access to GitHub Copilot, if applicable. oneOf: - - *188 + - *187 - *66 type: - 'null' @@ -31595,12 +34163,12 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 required: - total_count - repositories examples: - default: *189 + default: *188 '500': *53 '401': *23 '403': *27 @@ -31686,7 +34254,7 @@ paths: url: https://docs.github.com/rest/copilot/copilot-coding-agent-management#enable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No Content @@ -31720,7 +34288,7 @@ paths: url: https://docs.github.com/rest/copilot/copilot-coding-agent-management#disable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No Content @@ -31935,7 +34503,7 @@ paths: application/json: schema: type: array - items: &318 + items: &317 title: Copilot Usage Metrics description: Copilot usage metrics for a given day. type: object @@ -32250,7 +34818,7 @@ paths: - date additionalProperties: true examples: - default: &319 + default: &318 value: - date: '2024-06-24' total_active_users: 24 @@ -32352,7 +34920,7 @@ paths: '500': *53 '403': *27 '404': *6 - '422': &320 + '422': &319 description: Copilot Usage Metrics API setting is disabled at the organization or enterprise level. content: @@ -32393,7 +34961,7 @@ paths: schema: *55 examples: default: *56 - '204': *184 + '204': *183 '500': *53 '403': *27 '404': *6 @@ -32469,7 +35037,7 @@ paths: schema: *55 examples: default: *56 - '204': *184 + '204': *183 '500': *53 '403': *27 '404': *6 @@ -32532,11 +35100,11 @@ paths: url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-an-organization parameters: - *73 + - *189 - *190 - *191 - *192 - *193 - - *194 - name: artifact_registry_url in: query description: A comma-separated list of artifact registry URLs. If specified, @@ -32566,7 +35134,7 @@ paths: enum: - patch - deployment - - *195 + - *194 - name: runtime_risk in: query description: |- @@ -32575,8 +35143,8 @@ paths: Can be: `critical-resource`, `internet-exposed`, `sensitive-data`, `lateral-movement` schema: type: string + - *195 - *196 - - *197 - *59 - *45 - *46 @@ -32588,9 +35156,9 @@ paths: application/json: schema: type: array - items: *198 + items: *197 examples: - default: *199 + default: *198 '304': *35 '400': *14 '403': *27 @@ -32634,7 +35202,7 @@ paths: type: integer secrets: type: array - items: &200 + items: &199 title: Dependabot Secret for an Organization description: Secrets for GitHub Dependabot for an organization. type: object @@ -32713,7 +35281,7 @@ paths: description: Response content: application/json: - schema: &477 + schema: &476 title: DependabotPublicKey description: The public key used for setting Dependabot Secrets. type: object @@ -32732,7 +35300,7 @@ paths: - key_id - key examples: - default: &478 + default: &477 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -32756,13 +35324,13 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#get-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *200 + schema: *199 examples: default: value: @@ -32791,7 +35359,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -32848,7 +35416,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -32873,7 +35441,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -32898,7 +35466,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -32916,9 +35484,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32940,7 +35508,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -32991,7 +35559,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -33023,7 +35591,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -33061,7 +35629,7 @@ paths: application/json: schema: type: array - items: &247 + items: &246 title: Package description: A software package type: object @@ -33114,7 +35682,7 @@ paths: repository: anyOf: - type: 'null' - - *153 + - *152 created_at: type: string format: date-time @@ -33132,7 +35700,7 @@ paths: - created_at - updated_at examples: - default: &248 + default: &247 value: - id: 197 name: hello_docker @@ -33302,7 +35870,7 @@ paths: application/json: schema: type: array - items: &224 + items: &223 title: Organization Invitation description: Organization Invitation type: object @@ -33356,7 +35924,7 @@ paths: - invitation_teams_url - node_id examples: - default: &225 + default: &224 value: - id: 1 login: monalisa @@ -33423,7 +35991,7 @@ paths: application/json: schema: type: array - items: &201 + items: &200 title: Org Hook description: Org Hook type: object @@ -33608,9 +36176,9 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: - default: &202 + default: &201 value: id: 1 url: https://api.github.com/orgs/octocat/hooks/1 @@ -33658,7 +36226,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook parameters: - *73 - - &203 + - &202 name: hook_id description: The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery. @@ -33671,9 +36239,9 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: - default: *202 + default: *201 '404': *6 x-github: githubCloudOnly: false @@ -33701,7 +36269,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook parameters: - *73 - - *203 + - *202 requestBody: required: false content: @@ -33747,7 +36315,7 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: default: value: @@ -33789,7 +36357,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook parameters: - *73 - - *203 + - *202 responses: '204': description: Response @@ -33817,7 +36385,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization parameters: - *73 - - *203 + - *202 responses: '200': description: Response @@ -33848,7 +36416,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization parameters: - *73 - - *203 + - *202 requestBody: required: false content: @@ -33899,10 +36467,10 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *17 + - *203 - *204 - - *205 responses: '200': description: Response @@ -33910,9 +36478,9 @@ paths: application/json: schema: type: array - items: *206 + items: *205 examples: - default: *207 + default: *206 '400': *14 '422': *15 x-github: @@ -33938,16 +36506,16 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *16 responses: '200': description: Response content: application/json: - schema: *208 + schema: *207 examples: - default: *209 + default: *208 '400': *14 '422': *15 x-github: @@ -33973,7 +36541,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *16 responses: '202': *37 @@ -34003,7 +36571,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook parameters: - *73 - - *203 + - *202 responses: '204': description: Response @@ -34026,7 +36594,7 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor parameters: - *73 - - &214 + - &213 name: actor_type in: path description: The type of the actor @@ -34039,14 +36607,14 @@ paths: - fine_grained_pat - oauth_app - github_app_user_to_server - - &215 + - &214 name: actor_id in: path description: The ID of the actor required: true schema: type: integer - - &210 + - &209 name: min_timestamp description: 'The minimum timestamp to query for stats. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -34054,7 +36622,7 @@ paths: required: true schema: type: string - - &211 + - &210 name: max_timestamp description: 'The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -34149,12 +36717,12 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-subject-stats parameters: - *73 + - *209 - *210 - - *211 - *19 - *17 - *59 - - &220 + - &219 name: sort description: The property to sort the results by. in: query @@ -34233,14 +36801,14 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats parameters: - *73 + - *209 - *210 - - *211 responses: '200': description: Response content: application/json: - schema: &212 + schema: &211 title: Summary Stats description: API Insights usage summary stats for an organization type: object @@ -34256,7 +36824,7 @@ paths: type: integer format: int64 examples: - default: &213 + default: &212 value: total_request_count: 34225 rate_limited_request_count: 23 @@ -34277,23 +36845,23 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user parameters: - *73 - - &216 + - &215 name: user_id in: path description: The ID of the user to query for stats required: true schema: type: string + - *209 - *210 - - *211 responses: '200': description: Response content: application/json: - schema: *212 + schema: *211 examples: - default: *213 + default: *212 x-github: enabledForGitHubApps: true category: orgs @@ -34312,18 +36880,18 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor parameters: - *73 + - *209 - *210 - - *211 + - *213 - *214 - - *215 responses: '200': description: Response content: application/json: - schema: *212 + schema: *211 examples: - default: *213 + default: *212 x-github: enabledForGitHubApps: true category: orgs @@ -34341,9 +36909,9 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats parameters: - *73 + - *209 - *210 - - *211 - - &217 + - &216 name: timestamp_increment description: The increment of time used to breakdown the query results (5m, 10m, 1h, etc.) @@ -34356,7 +36924,7 @@ paths: description: Response content: application/json: - schema: &218 + schema: &217 title: Time Stats description: API Insights usage time stats for an organization type: array @@ -34372,7 +36940,7 @@ paths: type: integer format: int64 examples: - default: &219 + default: &218 value: - timestamp: '2024-09-11T15:00:00Z' total_request_count: 34225 @@ -34409,18 +36977,18 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user parameters: - *73 - - *216 + - *215 + - *209 - *210 - - *211 - - *217 + - *216 responses: '200': description: Response content: application/json: - schema: *218 + schema: *217 examples: - default: *219 + default: *218 x-github: enabledForGitHubApps: true category: orgs @@ -34438,19 +37006,19 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor parameters: - *73 + - *213 - *214 - - *215 + - *209 - *210 - - *211 - - *217 + - *216 responses: '200': description: Response content: application/json: - schema: *218 + schema: *217 examples: - default: *219 + default: *218 x-github: enabledForGitHubApps: true category: orgs @@ -34468,13 +37036,13 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-user-stats parameters: - *73 - - *216 + - *215 + - *209 - *210 - - *211 - *19 - *17 - *59 - - *220 + - *219 - name: actor_name_substring in: query description: Providing a substring will filter results where the actor name @@ -34558,7 +37126,7 @@ paths: application/json: schema: *20 examples: - default: &516 + default: &515 value: id: 1 account: @@ -34724,12 +37292,12 @@ paths: application/json: schema: anyOf: - - &222 + - &221 title: Interaction Limits description: Interaction limit settings. type: object properties: - limit: &221 + limit: &220 type: string description: The type of GitHub user that can comment, open issues, or create pull requests while the interaction limit @@ -34757,7 +37325,7 @@ paths: properties: {} additionalProperties: false examples: - default: &223 + default: &222 value: limit: collaborators_only origin: organization @@ -34786,13 +37354,13 @@ paths: required: true content: application/json: - schema: &517 + schema: &516 title: Interaction Restrictions description: Limit interactions to a specific type of user for a specified duration type: object properties: - limit: *221 + limit: *220 expiry: type: string description: 'The duration of the interaction restriction. Default: @@ -34817,9 +37385,9 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: - default: *223 + default: *222 '422': *15 x-github: githubCloudOnly: false @@ -34895,9 +37463,9 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 '404': *6 @@ -34974,7 +37542,7 @@ paths: description: Response content: application/json: - schema: *224 + schema: *223 examples: default: value: @@ -35029,7 +37597,7 @@ paths: url: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation parameters: - *73 - - &226 + - &225 name: invitation_id description: The unique identifier of the invitation. in: path @@ -35060,7 +37628,7 @@ paths: url: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams parameters: - *73 - - *226 + - *225 - *17 - *19 responses: @@ -35070,9 +37638,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: &246 + default: &245 value: - id: 1 node_id: MDQ6VGVhbTE= @@ -35115,7 +37683,7 @@ paths: application/json: schema: type: array - items: &227 + items: &226 title: Issue Field description: A custom attribute defined at the organization level for attaching structured data to issues. @@ -35358,9 +37926,9 @@ paths: description: Response content: application/json: - schema: *227 + schema: *226 examples: - default: &228 + default: &227 value: id: 512 node_id: IF_kwDNAd3NAZr @@ -35416,7 +37984,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-fields#update-issue-field-for-an-organization parameters: - *73 - - &229 + - &228 name: issue_field_id description: The unique identifier of the issue field. in: path @@ -35517,9 +38085,9 @@ paths: description: Response content: application/json: - schema: *227 + schema: *226 examples: - default: *228 + default: *227 '404': *6 '422': *7 x-github: @@ -35544,9 +38112,9 @@ paths: url: https://docs.github.com/rest/orgs/issue-fields#delete-issue-field-for-an-organization parameters: - *73 - - *229 + - *228 responses: - '204': *184 + '204': *183 '404': *6 '422': *7 x-github: @@ -35574,7 +38142,7 @@ paths: application/json: schema: type: array - items: *230 + items: *229 examples: default: value: @@ -35662,9 +38230,9 @@ paths: description: Response content: application/json: - schema: *230 + schema: *229 examples: - default: &231 + default: &230 value: id: 410 node_id: IT_kwDNAd3NAZo @@ -35697,7 +38265,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization parameters: - *73 - - &232 + - &231 name: issue_type_id description: The unique identifier of the issue type. in: path @@ -35753,9 +38321,9 @@ paths: description: Response content: application/json: - schema: *230 + schema: *229 examples: - default: *231 + default: *230 '404': *6 '422': *7 x-github: @@ -35780,7 +38348,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization parameters: - *73 - - *232 + - *231 responses: '204': description: Response @@ -35843,7 +38411,7 @@ paths: - closed - all default: open - - *233 + - *232 - name: type description: Can be the name of an issue type. in: query @@ -35874,7 +38442,7 @@ paths: type: array items: *81 examples: - default: *234 + default: *233 headers: Link: *65 '404': *6 @@ -36033,9 +38601,9 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: - default: *236 + default: *235 '304': *35 '500': *53 '401': *23 @@ -36062,7 +38630,7 @@ paths: parameters: - *73 - *69 - - &237 + - &236 name: codespace_name in: path required: true @@ -36097,15 +38665,15 @@ paths: parameters: - *73 - *69 - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: &445 + default: &444 value: id: 1 name: monalisa-octocat-hello-world-g4wpq6h95q @@ -36285,7 +38853,7 @@ paths: description: The user's GitHub Copilot seat details, including usage. content: application/json: - schema: *238 + schema: *237 examples: default: value: @@ -36361,7 +38929,7 @@ paths: description: Response content: application/json: - schema: &239 + schema: &238 title: Org Membership description: Org Membership type: object @@ -36430,7 +38998,7 @@ paths: - organization - user examples: - response-if-user-has-an-active-admin-membership-with-organization: &240 + response-if-user-has-an-active-admin-membership-with-organization: &239 summary: Response if user has an active admin membership with organization value: url: https://api.github.com/orgs/octocat/memberships/defunkt @@ -36531,9 +39099,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: - response-if-user-already-had-membership-with-organization: *240 + response-if-user-already-had-membership-with-organization: *239 '422': *15 '403': *27 x-github: @@ -36605,7 +39173,7 @@ paths: application/json: schema: type: array - items: &241 + items: &240 title: Migration description: A migration. type: object @@ -36943,7 +39511,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -37122,7 +39690,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#get-an-organization-migration-status parameters: - *73 - - &242 + - &241 name: migration_id description: The unique identifier of the migration. in: path @@ -37150,7 +39718,7 @@ paths: * `failed`, which means the migration failed. content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -37320,7 +39888,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#download-an-organization-migration-archive parameters: - *73 - - *242 + - *241 responses: '302': description: Response @@ -37342,7 +39910,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#delete-an-organization-migration-archive parameters: - *73 - - *242 + - *241 responses: '204': description: Response @@ -37366,8 +39934,8 @@ paths: url: https://docs.github.com/rest/migrations/orgs#unlock-an-organization-repository parameters: - *73 - - *242 - - &664 + - *241 + - &663 name: repo_name description: repo_name parameter in: path @@ -37395,7 +39963,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#list-repositories-in-an-organization-migration parameters: - *73 - - *242 + - *241 - *17 - *19 responses: @@ -37405,9 +39973,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: &253 + default: &252 value: - id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -37536,7 +40104,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -37562,7 +40130,7 @@ paths: roles: type: array description: The list of organization roles available to the organization. - items: &244 + items: &243 title: Organization Role description: Organization roles type: object @@ -37739,7 +40307,7 @@ paths: parameters: - *73 - *75 - - &243 + - &242 name: role_id description: The unique identifier of the role. in: path @@ -37776,7 +40344,7 @@ paths: parameters: - *73 - *75 - - *243 + - *242 responses: '204': description: Response @@ -37829,7 +40397,7 @@ paths: parameters: - *73 - *69 - - *243 + - *242 responses: '204': description: Response @@ -37861,7 +40429,7 @@ paths: parameters: - *73 - *69 - - *243 + - *242 responses: '204': description: Response @@ -37879,7 +40447,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -37890,13 +40458,13 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role parameters: - *73 - - *243 + - *242 responses: '200': description: Response content: application/json: - schema: *244 + schema: *243 examples: default: value: @@ -37947,7 +40515,7 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - *73 - - *243 + - *242 - *17 - *19 responses: @@ -38026,7 +40594,7 @@ paths: parent: anyOf: - type: 'null' - - *245 + - *244 type: description: The ownership type of the team type: string @@ -38059,7 +40627,7 @@ paths: - type - parent examples: - default: *246 + default: *245 headers: Link: *65 '404': @@ -38089,7 +40657,7 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - *73 - - *243 + - *242 - *17 - *19 responses: @@ -38118,7 +40686,7 @@ paths: inherited_from: description: Team the user has gotten the role through type: array - items: *245 + items: *244 name: type: - string @@ -38428,7 +40996,7 @@ paths: - nuget - container - *73 - - &665 + - &664 name: visibility description: |- The selected visibility of the packages. This parameter is optional and only filters an existing result set. @@ -38464,12 +41032,12 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *248 + default: *247 '403': *27 '401': *23 - '400': &667 + '400': &666 description: The value of `per_page` multiplied by `page` cannot be greater than 10000. x-github: @@ -38491,7 +41059,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-an-organization parameters: - - &249 + - &248 name: package_type description: The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry @@ -38509,7 +41077,7 @@ paths: - docker - nuget - container - - &250 + - &249 name: package_name description: The name of the package. in: path @@ -38522,7 +41090,7 @@ paths: description: Response content: application/json: - schema: *247 + schema: *246 examples: default: value: @@ -38574,8 +41142,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-an-organization parameters: + - *248 - *249 - - *250 - *73 responses: '204': @@ -38608,8 +41176,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - name: token description: package token @@ -38642,8 +41210,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-an-organization parameters: + - *248 - *249 - - *250 - *73 - *19 - *17 @@ -38664,7 +41232,7 @@ paths: application/json: schema: type: array - items: &251 + items: &250 title: Package Version description: A version of a software package type: object @@ -38799,10 +41367,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - &252 + - &251 name: package_version_id description: Unique identifier of the package version. in: path @@ -38814,7 +41382,7 @@ paths: description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -38850,10 +41418,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - *252 + - *251 responses: '204': description: Response @@ -38885,10 +41453,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - *252 + - *251 responses: '204': description: Response @@ -38918,7 +41486,7 @@ paths: - *73 - *17 - *19 - - &254 + - &253 name: sort description: The property by which to sort the results. in: query @@ -38929,7 +41497,7 @@ paths: - created_at default: created_at - *59 - - &255 + - &254 name: owner description: A list of owner usernames to use to filter the results. in: query @@ -38941,7 +41509,7 @@ paths: type: string examples: - owner[]=octocat1,owner[]=octocat2 - - &256 + - &255 name: repository description: The name of the repository to use to filter the results. in: query @@ -38950,7 +41518,7 @@ paths: type: string examples: - Hello-World - - &257 + - &256 name: permission description: The permission to use to filter the results. in: query @@ -38959,7 +41527,7 @@ paths: type: string examples: - issues_read - - &258 + - &257 name: last_used_before description: 'Only show fine-grained personal access tokens used before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -38969,7 +41537,7 @@ paths: schema: type: string format: date-time - - &259 + - &258 name: last_used_after description: 'Only show fine-grained personal access tokens used after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -38979,7 +41547,7 @@ paths: schema: type: string format: date-time - - &260 + - &259 name: token_id description: The ID of the token in: query @@ -39255,7 +41823,7 @@ paths: '422': *15 '404': *6 '403': *27 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -39296,9 +41864,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -39324,14 +41892,14 @@ paths: - *73 - *17 - *19 - - *254 + - *253 - *59 + - *254 - *255 - *256 - *257 - *258 - *259 - - *260 responses: '500': *53 '422': *15 @@ -39572,7 +42140,7 @@ paths: responses: '500': *53 '404': *6 - '204': *184 + '204': *183 '403': *27 '422': *15 x-github: @@ -39613,9 +42181,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -39657,7 +42225,7 @@ paths: type: integer configurations: type: array - items: &261 + items: &260 title: Organization private registry description: Private registry configuration for an organization type: object @@ -40091,7 +42659,7 @@ paths: - created_at - updated_at examples: - org-private-registry-with-selected-visibility: &262 + org-private-registry-with-selected-visibility: &261 value: name: MAVEN_REPOSITORY_SECRET registry_type: maven_repository @@ -40183,15 +42751,15 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#get-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 responses: '200': description: The specified private registry configuration for the organization content: application/json: - schema: *261 + schema: *260 examples: - default: *262 + default: *261 '404': *6 x-github: githubCloudOnly: false @@ -40214,7 +42782,7 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#update-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -40379,7 +42947,7 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#delete-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -40419,7 +42987,7 @@ paths: application/json: schema: type: array - items: &263 + items: &262 title: Projects v2 Project description: A projects v2 project type: object @@ -40493,7 +43061,7 @@ paths: latest_status_update: anyOf: - type: 'null' - - &750 + - &749 title: Projects v2 Status Update description: An status update belonging to a project type: object @@ -40578,7 +43146,7 @@ paths: - deleted_at - deleted_by examples: - default: &264 + default: &263 value: id: 2 node_id: MDc6UHJvamVjdDEwMDI2MDM= @@ -40681,7 +43249,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/projects#get-project-for-organization parameters: - - &265 + - &264 name: project_number description: The project's number. in: path @@ -40694,9 +43262,9 @@ paths: description: Response content: application/json: - schema: *263 + schema: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -40719,7 +43287,7 @@ paths: url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true description: Details of the draft item to create in the project. @@ -40753,7 +43321,7 @@ paths: description: Response content: application/json: - schema: &270 + schema: &269 title: Projects v2 Item description: An item belonging to a project type: object @@ -40767,7 +43335,7 @@ paths: content: oneOf: - *81 - - &460 + - &459 title: Pull Request Simple description: Pull Request Simple type: object @@ -40887,7 +43455,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 active_lock_reason: type: - string @@ -40936,7 +43504,7 @@ paths: items: *4 requested_teams: type: array - items: *188 + items: *187 head: type: object properties: @@ -40980,7 +43548,7 @@ paths: _links: type: object properties: - comments: &267 + comments: &266 title: Link description: Hypermedia Link type: object @@ -40989,13 +43557,13 @@ paths: type: string required: - href - commits: *267 - statuses: *267 - html: *267 - issue: *267 - review_comments: *267 - review_comment: *267 - self: *267 + commits: *266 + statuses: *266 + html: *266 + issue: *266 + review_comments: *266 + review_comment: *266 + self: *266 required: - comments - commits @@ -41006,7 +43574,7 @@ paths: - review_comment - self author_association: *78 - auto_merge: &562 + auto_merge: &561 title: Auto merge description: The status of auto merging a pull request. type: @@ -41108,7 +43676,7 @@ paths: - created_at - updated_at description: The content represented by the item. - content_type: &269 + content_type: &268 title: Projects v2 Item Content Type description: The type of content tracked in a project item type: string @@ -41152,7 +43720,7 @@ paths: - updated_at - archived_at examples: - draft_issue: &271 + draft_issue: &270 value: id: 17 node_id: PVTI_lADOANN5s84ACbL0zgBueEI @@ -41226,7 +43794,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#list-project-fields-for-organization parameters: - - *265 + - *264 - *73 - *17 - *45 @@ -41238,7 +43806,7 @@ paths: application/json: schema: type: array - items: &268 + items: &267 title: Projects v2 Field description: A field inside a projects v2 project type: object @@ -41391,7 +43959,7 @@ paths: - updated_at - project_url examples: - default: &686 + default: &685 value: - id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41521,7 +44089,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#add-a-field-to-an-organization-owned-project parameters: - - *265 + - *264 - *73 requestBody: required: true @@ -41568,7 +44136,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: &687 + items: &686 type: object properties: name: @@ -41605,7 +44173,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: &688 + iteration_configuration: &687 type: object description: The configuration for iteration fields. properties: @@ -41655,7 +44223,7 @@ paths: value: name: Due date data_type: date - single_select_field: &689 + single_select_field: &688 summary: Create a single select field value: name: Priority @@ -41682,7 +44250,7 @@ paths: description: raw: High priority items html: High priority items - iteration_field: &690 + iteration_field: &689 summary: Create an iteration field value: name: Sprint @@ -41706,9 +44274,9 @@ paths: description: Response for adding a field to an organization-owned project. content: application/json: - schema: *268 + schema: *267 examples: - text_field: &691 + text_field: &690 value: id: 24680 node_id: PVTF_lADOABCD2468024680 @@ -41717,7 +44285,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-05-15T08:00:00Z' updated_at: '2022-05-15T08:00:00Z' - number_field: &692 + number_field: &691 value: id: 13579 node_id: PVTF_lADOABCD1357913579 @@ -41726,7 +44294,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-01T14:30:00Z' updated_at: '2022-06-01T14:30:00Z' - date_field: &693 + date_field: &692 value: id: 98765 node_id: PVTF_lADOABCD9876598765 @@ -41735,7 +44303,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-10T09:15:00Z' updated_at: '2022-06-10T09:15:00Z' - single_select_field: &694 + single_select_field: &693 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41769,7 +44337,7 @@ paths: raw: High priority items created_at: '2022-04-28T12:00:00Z' updated_at: '2022-04-28T12:00:00Z' - iteration_field: &695 + iteration_field: &694 value: id: 11223 node_id: PVTF_lADOABCD1122311223 @@ -41814,8 +44382,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#get-project-field-for-organization parameters: - - *265 - - &696 + - *264 + - &695 name: field_id description: The unique identifier of the field. in: path @@ -41828,9 +44396,9 @@ paths: description: Response content: application/json: - schema: *268 + schema: *267 examples: - default: &697 + default: &696 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41886,7 +44454,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-an-organization-owned-project parameters: - - *265 + - *264 - *73 - name: q description: Search query to filter items, see [Filtering projects](https://docs.github.com/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects) @@ -41919,7 +44487,7 @@ paths: application/json: schema: type: array - items: &272 + items: &271 title: Projects v2 Item description: An item belonging to a project type: object @@ -41936,7 +44504,7 @@ paths: description: The API URL of the project that contains this item. examples: - https://api.github.com/users/monalisa/2/projectsV2/3 - content_type: *269 + content_type: *268 content: type: - object @@ -41986,7 +44554,7 @@ paths: - updated_at - archived_at examples: - default: &273 + default: &272 value: id: 13 node_id: PVTI_lAAFAQ0 @@ -42684,7 +45252,7 @@ paths: url: https://docs.github.com/rest/projects/items#add-item-to-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -42754,22 +45322,22 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *271 + value: *270 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *271 + value: *270 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *271 + value: *270 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *271 + value: *270 '304': *35 '403': *27 '401': *23 @@ -42789,9 +45357,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#get-an-item-for-an-organization-owned-project parameters: - - *265 + - *264 - *73 - - &274 + - &273 name: item_id description: The unique identifier of the project item. in: path @@ -42817,9 +45385,9 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -42840,9 +45408,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#update-project-item-for-organization parameters: - - *265 + - *264 - *73 - - *274 + - *273 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -42915,13 +45483,13 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - text_field: *273 - number_field: *273 - date_field: *273 - single_select_field: *273 - iteration_field: *273 + text_field: *272 + number_field: *272 + date_field: *272 + single_select_field: *272 + iteration_field: *272 '401': *23 '403': *27 '404': *6 @@ -42941,9 +45509,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#delete-project-item-for-organization parameters: - - *265 + - *264 - *73 - - *274 + - *273 responses: '204': description: Response @@ -42967,7 +45535,7 @@ paths: url: https://docs.github.com/rest/projects/views#create-a-view-for-an-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true content: @@ -43041,7 +45609,7 @@ paths: description: Response for creating a view in an organization-owned project. content: application/json: - schema: &678 + schema: &677 title: Projects v2 View description: A view inside a projects v2 project type: object @@ -43145,7 +45713,7 @@ paths: examples: table_view: summary: Response for creating a table view - value: &275 + value: &274 value: id: 1 number: 1 @@ -43191,10 +45759,10 @@ paths: - 456 board_view: summary: Response for creating a board view with filter - value: *275 + value: *274 roadmap_view: summary: Response for creating a roadmap view - value: *275 + value: *274 '304': *35 '403': *27 '401': *23 @@ -43222,9 +45790,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-an-organization-project-view parameters: - - *265 + - *264 - *73 - - &698 + - &697 name: view_number description: The number that identifies the project view. in: path @@ -43256,9 +45824,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -43291,7 +45859,7 @@ paths: application/json: schema: type: array - items: &276 + items: &275 title: Organization Custom Property description: Custom property defined on an organization type: object @@ -43369,7 +45937,7 @@ paths: - property_name - value_type examples: - default: &277 + default: &276 value: - property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -43429,7 +45997,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *276 + items: *275 minItems: 1 maxItems: 100 required: @@ -43459,9 +46027,9 @@ paths: application/json: schema: type: array - items: *276 + items: *275 examples: - default: *277 + default: *276 '403': *27 '404': *6 x-github: @@ -43483,7 +46051,7 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization parameters: - *73 - - &278 + - &277 name: custom_property_name description: The custom property name in: path @@ -43495,9 +46063,9 @@ paths: description: Response content: application/json: - schema: *276 + schema: *275 examples: - default: &279 + default: &278 value: property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -43532,7 +46100,7 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization parameters: - *73 - - *278 + - *277 requestBody: required: true content: @@ -43612,9 +46180,9 @@ paths: description: Response content: application/json: - schema: *276 + schema: *275 examples: - default: *279 + default: *278 '403': *27 '404': *6 x-github: @@ -43638,9 +46206,9 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization parameters: - *73 - - *278 + - *277 responses: - '204': *184 + '204': *183 '403': *27 '404': *6 x-github: @@ -43702,7 +46270,7 @@ paths: - octocat/Hello-World properties: type: array - items: &280 + items: &279 title: Custom Property Value description: Custom property name and associated value type: object @@ -43792,7 +46360,7 @@ paths: type: array description: List of custom property names and associated values to apply to the repositories. - items: *280 + items: *279 required: - repository_names - properties @@ -43982,9 +46550,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -44187,7 +46755,7 @@ paths: description: Response content: application/json: - schema: &328 + schema: &327 title: Full Repository description: Full Repository type: object @@ -44665,7 +47233,7 @@ paths: description: Whether anonymous git access is allowed. default: true type: boolean - code_of_conduct: &465 + code_of_conduct: &464 title: Code Of Conduct Simple description: Code of Conduct Simple type: object @@ -44695,7 +47263,7 @@ paths: - key - name - html_url - security_and_analysis: *281 + security_and_analysis: *280 custom_properties: type: object description: The custom properties that were defined for the repository. @@ -44779,7 +47347,7 @@ paths: - network_count - subscribers_count examples: - default: &330 + default: &329 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -45300,7 +47868,7 @@ paths: - *73 - *17 - *19 - - &584 + - &583 name: targets description: | A comma-separated list of rule targets to filter by. @@ -45319,7 +47887,7 @@ paths: application/json: schema: type: array - items: &308 + items: &307 title: Repository ruleset type: object description: A set of rules to apply when specified conditions are @@ -45354,7 +47922,7 @@ paths: source: type: string description: The name of the source - enforcement: &284 + enforcement: &283 type: string description: The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins @@ -45367,7 +47935,7 @@ paths: bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: &285 + items: &284 title: Repository Ruleset Bypass Actor type: object description: An actor that can bypass rules in a ruleset @@ -45438,7 +48006,7 @@ paths: description: The html URL of the ruleset conditions: anyOf: - - &282 + - &281 title: Repository ruleset conditions for ref names type: object description: Parameters for a repository ruleset ref name @@ -45462,7 +48030,7 @@ paths: match. items: type: string - - &286 + - &285 title: Organization ruleset conditions type: object description: |- @@ -45476,7 +48044,7 @@ paths: description: Conditions to target repositories by name and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository names type: object description: Parameters for a repository name condition @@ -45510,7 +48078,7 @@ paths: description: Conditions to target repositories by id and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository IDs type: object description: Parameters for a repository ID condition @@ -45532,7 +48100,7 @@ paths: description: Conditions to target repositories by property and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository properties type: object description: Parameters for a repository property condition @@ -45545,7 +48113,7 @@ paths: description: The repository properties and values to include. All of these properties must match for the condition to pass. - items: &283 + items: &282 title: Repository ruleset property targeting definition type: object @@ -45578,7 +48146,7 @@ paths: description: The repository properties and values to exclude. The condition will not pass if any of these properties match. - items: *283 + items: *282 required: - repository_property type: @@ -45586,12 +48154,12 @@ paths: - object rules: type: array - items: &585 + items: &584 title: Repository Rule type: object description: A repository rule. oneOf: - - &287 + - &286 title: creation description: Only allow users with bypass permission to create matching refs. @@ -45603,7 +48171,7 @@ paths: type: string enum: - creation - - &288 + - &287 title: update description: Only allow users with bypass permission to update matching refs. @@ -45624,7 +48192,7 @@ paths: repository required: - update_allows_fetch_and_merge - - &289 + - &288 title: deletion description: Only allow users with bypass permissions to delete matching refs. @@ -45636,7 +48204,7 @@ paths: type: string enum: - deletion - - &290 + - &289 title: required_linear_history description: Prevent merge commits from being pushed to matching refs. @@ -45648,7 +48216,7 @@ paths: type: string enum: - required_linear_history - - &583 + - &582 title: merge_queue description: Merges must be performed via a merge queue. type: object @@ -45726,7 +48294,7 @@ paths: - merge_method - min_entries_to_merge - min_entries_to_merge_wait_minutes - - &291 + - &290 title: required_deployments description: Choose which environments must be successfully deployed to before refs can be pushed into a ref that @@ -45750,7 +48318,7 @@ paths: type: string required: - required_deployment_environments - - &292 + - &291 title: required_signatures description: Commits pushed to matching refs must have verified signatures. @@ -45762,7 +48330,7 @@ paths: type: string enum: - required_signatures - - &293 + - &292 title: pull_request description: Require all commits be made to a non-target branch and submitted via a pull request before they can @@ -45868,7 +48436,7 @@ paths: - require_last_push_approval - required_approving_review_count - required_review_thread_resolution - - &294 + - &293 title: required_status_checks description: Choose which status checks must pass before the ref is updated. When enabled, commits must first be @@ -45916,7 +48484,7 @@ paths: required: - required_status_checks - strict_required_status_checks_policy - - &295 + - &294 title: non_fast_forward description: Prevent users with push access from force pushing to refs. @@ -45928,7 +48496,7 @@ paths: type: string enum: - non_fast_forward - - &296 + - &295 title: commit_message_pattern description: Parameters to be used for the commit_message_pattern rule @@ -45965,7 +48533,7 @@ paths: required: - operator - pattern - - &297 + - &296 title: commit_author_email_pattern description: Parameters to be used for the commit_author_email_pattern rule @@ -46002,7 +48570,7 @@ paths: required: - operator - pattern - - &298 + - &297 title: committer_email_pattern description: Parameters to be used for the committer_email_pattern rule @@ -46039,7 +48607,7 @@ paths: required: - operator - pattern - - &299 + - &298 title: branch_name_pattern description: Parameters to be used for the branch_name_pattern rule @@ -46076,7 +48644,7 @@ paths: required: - operator - pattern - - &300 + - &299 title: tag_name_pattern description: Parameters to be used for the tag_name_pattern rule @@ -46113,7 +48681,7 @@ paths: required: - operator - pattern - - &301 + - &300 title: file_path_restriction description: Prevent commits that include changes in specified file and folder paths from being pushed to the commit @@ -46138,7 +48706,7 @@ paths: type: string required: - restricted_file_paths - - &302 + - &301 title: max_file_path_length description: Prevent commits that include file paths that exceed the specified character limit from being pushed @@ -46162,7 +48730,7 @@ paths: maximum: 32767 required: - max_file_path_length - - &303 + - &302 title: file_extension_restriction description: Prevent commits that include files with specified file extensions from being pushed to the commit graph. @@ -46185,7 +48753,7 @@ paths: type: string required: - restricted_file_extensions - - &304 + - &303 title: max_file_size description: Prevent commits with individual files that exceed the specified limit from being pushed to the commit @@ -46210,7 +48778,7 @@ paths: maximum: 100 required: - max_file_size - - &305 + - &304 title: workflows description: Require all changes made to a targeted branch to pass the specified workflows before they can be merged. @@ -46260,7 +48828,7 @@ paths: - repository_id required: - workflows - - &306 + - &305 title: code_scanning description: Choose which tools must provide code scanning results before the reference is updated. When configured, @@ -46321,7 +48889,7 @@ paths: - tool required: - code_scanning_tools - - &307 + - &306 title: copilot_code_review description: Request Copilot code review for new pull requests automatically if the author has access to Copilot code @@ -46420,20 +48988,21 @@ paths: - push - repository default: branch - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *286 + items: *284 + conditions: *285 rules: type: array description: An array of rules within the ruleset. - items: &310 + items: &309 title: Repository Rule type: object description: A repository rule. oneOf: + - *286 - *287 - *288 - *289 @@ -46454,7 +49023,6 @@ paths: - *304 - *305 - *306 - - *307 required: - name - enforcement @@ -46492,9 +49060,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: &309 + default: &308 value: id: 21 name: super cool ruleset @@ -46550,7 +49118,7 @@ paths: url: https://docs.github.com/rest/orgs/rule-suites#list-organization-rule-suites parameters: - *73 - - &586 + - &585 name: ref description: The name of the ref. Cannot contain wildcard characters. Optionally prefix with `refs/heads/` to limit to branches or `refs/tags/` to limit @@ -46565,7 +49133,7 @@ paths: in: query schema: type: string - - &587 + - &586 name: time_period description: |- The time period to filter by. @@ -46581,14 +49149,14 @@ paths: - week - month default: day - - &588 + - &587 name: actor_name description: The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned. in: query schema: type: string - - &589 + - &588 name: rule_suite_result description: The rule suite results to filter on. When specified, only suites with this result will be returned. @@ -46608,7 +49176,7 @@ paths: description: Response content: application/json: - schema: &590 + schema: &589 title: Rule Suites description: Response type: array @@ -46664,7 +49232,7 @@ paths: whether rules would pass or fail if all rules in the rule suite were `active`. examples: - default: &591 + default: &590 value: - id: 21 actor_id: 12 @@ -46708,7 +49276,7 @@ paths: url: https://docs.github.com/rest/orgs/rule-suites#get-an-organization-rule-suite parameters: - *73 - - &592 + - &591 name: rule_suite_id description: |- The unique identifier of the rule suite result. @@ -46724,7 +49292,7 @@ paths: description: Response content: application/json: - schema: &593 + schema: &592 title: Rule Suite description: Response type: object @@ -46831,7 +49399,7 @@ paths: description: The detailed failure message for the rule. Null if the rule passed. examples: - default: &594 + default: &593 value: id: 21 actor_id: 12 @@ -46904,9 +49472,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *309 + default: *308 '404': *6 '500': *53 put: @@ -46950,16 +49518,16 @@ paths: - tag - push - repository - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *286 + items: *284 + conditions: *285 rules: description: An array of rules within the ruleset. type: array - items: *310 + items: *309 examples: default: value: @@ -46994,9 +49562,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *309 + default: *308 '404': *6 '422': *15 '500': *53 @@ -47054,7 +49622,7 @@ paths: application/json: schema: type: array - items: &311 + items: &310 title: Ruleset version type: object description: The historical version of a ruleset @@ -47078,7 +49646,7 @@ paths: type: string format: date-time examples: - default: &596 + default: &595 value: - version_id: 3 actor: @@ -47131,9 +49699,9 @@ paths: description: Response content: application/json: - schema: &597 + schema: &596 allOf: - - *311 + - *310 - type: object required: - state @@ -47203,7 +49771,7 @@ paths: url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization parameters: - *73 - - &598 + - &597 name: state in: query description: Set to `open` or `resolved` to only list secret scanning alerts @@ -47214,7 +49782,7 @@ paths: enum: - open - resolved - - &599 + - &598 name: secret_type in: query description: A comma-separated list of secret types to return. All default @@ -47224,7 +49792,7 @@ paths: required: false schema: type: string - - &600 + - &599 name: resolution in: query description: A comma-separated list of resolutions. Only secret scanning alerts @@ -47233,7 +49801,7 @@ paths: required: false schema: type: string - - &601 + - &600 name: assignee in: query description: Filters alerts by assignee. Use `*` to get all assigned alerts, @@ -47252,7 +49820,7 @@ paths: all-unassigned: value: none summary: Filter for all unassigned alerts - - &602 + - &601 name: sort description: The property to sort the results by. `created` means when the alert was created. `updated` means when the alert was updated or resolved. @@ -47267,7 +49835,7 @@ paths: - *59 - *19 - *17 - - &603 + - &602 name: before description: A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. To @@ -47277,7 +49845,7 @@ paths: required: false schema: type: string - - &604 + - &603 name: after description: A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. To @@ -47287,7 +49855,7 @@ paths: required: false schema: type: string - - &605 + - &604 name: validity in: query description: A comma-separated list of validities that, when present, will @@ -47296,7 +49864,7 @@ paths: required: false schema: type: string - - &606 + - &605 name: is_publicly_leaked in: query description: A boolean value representing whether or not to filter alerts @@ -47305,7 +49873,7 @@ paths: schema: type: boolean default: false - - &607 + - &606 name: is_multi_repo in: query description: A boolean value representing whether or not to filter alerts @@ -47314,7 +49882,7 @@ paths: schema: type: boolean default: false - - &608 + - &607 name: hide_secret in: query description: A boolean value representing whether or not to hide literal secrets @@ -47333,27 +49901,27 @@ paths: items: type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: &609 + state: &608 description: Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`. type: string enum: - open - resolved - resolution: &610 + resolution: &609 type: - string - 'null' @@ -47460,14 +50028,14 @@ paths: first_location_detected: anyOf: - type: 'null' - - &611 + - &610 description: 'Details on the location where the token was initially detected. This can be a commit, wiki commit, issue, discussion, pull request. ' oneOf: - - &613 + - &612 description: Represents a 'commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository. @@ -47514,6 +50082,13 @@ paths: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit + resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -47524,7 +50099,7 @@ paths: - blob_url - commit_sha - commit_url - - &614 + - &613 description: Represents a 'wiki_commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository wiki. @@ -47585,7 +50160,7 @@ paths: - page_url - commit_sha - commit_url - - &615 + - &614 description: Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue. @@ -47598,9 +50173,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url - - &616 + - &615 description: Represents an 'issue_body' secret scanning location type. This location type shows that a secret was detected in the body of an issue. @@ -47613,9 +50195,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url - - &617 + - &616 description: Represents an 'issue_comment' secret scanning location type. This location type shows that a secret was detected in a comment on an issue. @@ -47628,9 +50217,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url - - &618 + - &617 description: Represents a 'discussion_title' secret scanning location type. This location type shows that a secret was detected in the title of a discussion. @@ -47645,7 +50241,7 @@ paths: - https://github.com/community/community/discussions/39082 required: - discussion_title_url - - &619 + - &618 description: Represents a 'discussion_body' secret scanning location type. This location type shows that a secret was detected in the body of a discussion. @@ -47660,7 +50256,7 @@ paths: - https://github.com/community/community/discussions/39082#discussion-4566270 required: - discussion_body_url - - &620 + - &619 description: Represents a 'discussion_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a discussion. @@ -47675,7 +50271,7 @@ paths: - https://github.com/community/community/discussions/39082#discussioncomment-4158232 required: - discussion_comment_url - - &621 + - &620 description: Represents a 'pull_request_title' secret scanning location type. This location type shows that a secret was detected in the title of a pull request. @@ -47688,9 +50284,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url - - &622 + - &621 description: Represents a 'pull_request_body' secret scanning location type. This location type shows that a secret was detected in the body of a pull request. @@ -47703,9 +50306,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url - - &623 + - &622 description: Represents a 'pull_request_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a pull request. @@ -47718,9 +50328,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url - - &624 + - &623 description: Represents a 'pull_request_review' secret scanning location type. This location type shows that a secret was detected in a review on a pull request. @@ -47733,9 +50350,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url - - &625 + - &624 description: Represents a 'pull_request_review_comment' secret scanning location type. This location type shows that a secret was detected in a review comment on a pull @@ -47749,6 +50373,13 @@ paths: comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url has_more_locations: @@ -47975,7 +50606,7 @@ paths: related to push protection. type: object properties: - pattern_config_version: &313 + pattern_config_version: &312 type: - string - 'null' @@ -47985,7 +50616,7 @@ paths: provider_pattern_overrides: type: array description: Overrides for partner patterns. - items: &312 + items: &311 type: object properties: token_type: @@ -48054,7 +50685,7 @@ paths: custom_pattern_overrides: type: array description: Overrides for custom patterns defined by the organization. - items: *312 + items: *311 examples: default: value: @@ -48111,7 +50742,7 @@ paths: schema: type: object properties: - pattern_config_version: *313 + pattern_config_version: *312 provider_pattern_settings: type: array description: Pattern settings for provider patterns. @@ -48137,7 +50768,7 @@ paths: token_type: type: string description: The ID of the pattern to configure. - custom_pattern_version: *313 + custom_pattern_version: *312 push_protection_setting: type: string description: Push protection setting to set for the pattern. @@ -48235,7 +50866,7 @@ paths: application/json: schema: type: array - items: &629 + items: &628 description: A repository security advisory. type: object properties: @@ -48479,7 +51110,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 credits_detailed: type: - array @@ -48490,7 +51121,7 @@ paths: type: object properties: user: *4 - type: *314 + type: *313 state: type: string description: The state of the user's acceptance of the @@ -48516,7 +51147,7 @@ paths: - array - 'null' description: A list of teams that collaborate on the advisory. - items: *188 + items: *187 private_fork: readOnly: true description: A temporary private fork of the advisory's repository @@ -48554,7 +51185,7 @@ paths: - private_fork additionalProperties: false examples: - default: &630 + default: &629 value: - ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -48941,7 +51572,7 @@ paths: application/json: schema: type: array - items: *245 + items: *244 examples: default: value: @@ -49161,9 +51792,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49232,7 +51863,7 @@ paths: url: https://docs.github.com/rest/orgs/orgs#enable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -49255,7 +51886,7 @@ paths: url: https://docs.github.com/rest/orgs/orgs#disable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -49296,7 +51927,7 @@ paths: type: integer network_configurations: type: array - items: &315 + items: &314 title: Hosted compute network configuration description: A hosted compute network configuration. type: object @@ -49421,6 +52052,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -49436,9 +52080,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: &316 + default: &315 value: id: 123456789ABCDEF name: My network configuration @@ -49467,7 +52111,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization parameters: - *73 - - &317 + - &316 name: network_configuration_id description: Unique identifier of the hosted compute network configuration. in: path @@ -49479,9 +52123,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: *316 + default: *315 headers: Link: *65 x-github: @@ -49503,7 +52147,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization parameters: - *73 - - *317 + - *316 requestBody: required: true content: @@ -49531,6 +52175,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -49543,9 +52200,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: *316 + default: *315 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49565,7 +52222,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#delete-a-hosted-compute-network-configuration-from-an-organization parameters: - *73 - - *317 + - *316 responses: '204': description: Response @@ -49710,13 +52367,13 @@ paths: application/json: schema: type: array - items: *318 + items: *317 examples: - default: *319 + default: *318 '500': *53 '403': *27 '404': *6 - '422': *320 + '422': *319 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49756,9 +52413,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 headers: Link: *65 '403': *27 @@ -49852,7 +52509,7 @@ paths: description: Response content: application/json: - schema: &321 + schema: &320 title: Full Team description: Groups of organization members that gives permissions on specified repositories. @@ -49926,7 +52583,7 @@ paths: parent: anyOf: - type: 'null' - - *245 + - *244 members_count: type: integer examples: @@ -50251,7 +52908,7 @@ paths: - repos_count - organization examples: - default: &322 + default: &321 value: id: 1 node_id: MDQ6VGVhbTE= @@ -50328,9 +52985,9 @@ paths: description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 x-github: githubCloudOnly: false @@ -50415,16 +53072,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '201': description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 '422': *15 '403': *27 @@ -50454,7 +53111,7 @@ paths: responses: '204': description: Response - '422': &323 + '422': &322 description: Unprocessable entity if you attempt to modify an enterprise team at the organization level. x-github: @@ -50488,12 +53145,12 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 - '422': *323 + '422': *322 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -50575,7 +53232,7 @@ paths: description: Response content: application/json: - schema: &324 + schema: &323 title: Team Membership description: Team Membership type: object @@ -50603,7 +53260,7 @@ paths: - state - url examples: - response-if-user-is-a-team-maintainer: &646 + response-if-user-is-a-team-maintainer: &645 summary: Response if user is a team maintainer value: url: https://api.github.com/teams/1/memberships/octocat @@ -50666,9 +53323,9 @@ paths: description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-users-membership-with-team-is-now-pending: &647 + response-if-users-membership-with-team-is-now-pending: &646 summary: Response if user's membership with team is now pending value: url: https://api.github.com/teams/1/memberships/octocat @@ -50742,9 +53399,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -50775,14 +53432,14 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 responses: '200': description: Alternative response with repository permissions content: application/json: - schema: &648 + schema: &647 title: Team Repository description: A team's access to a repository. type: object @@ -51425,8 +54082,8 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 requestBody: required: false content: @@ -51473,8 +54130,8 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 responses: '204': description: Response @@ -51509,9 +54166,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - response-if-child-teams-exist: &649 + response-if-child-teams-exist: &648 value: - id: 2 node_id: MDQ6VGVhbTI= @@ -51665,7 +54322,7 @@ paths: resources: type: object properties: - core: &327 + core: &326 title: Rate Limit type: object properties: @@ -51682,21 +54339,21 @@ paths: - remaining - reset - used - graphql: *327 - search: *327 - code_search: *327 - source_import: *327 - integration_manifest: *327 - code_scanning_upload: *327 - actions_runner_registration: *327 - scim: *327 - dependency_snapshots: *327 - dependency_sbom: *327 - code_scanning_autofix: *327 + graphql: *326 + search: *326 + code_search: *326 + source_import: *326 + integration_manifest: *326 + code_scanning_upload: *326 + actions_runner_registration: *326 + scim: *326 + dependency_snapshots: *326 + dependency_sbom: *326 + code_scanning_autofix: *326 required: - core - search - rate: *327 + rate: *326 required: - rate - resources @@ -51801,14 +54458,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#get-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *328 + schema: *327 examples: default-response: summary: Default response @@ -52313,7 +54970,7 @@ paths: status: disabled '403': *27 '404': *6 - '301': *329 + '301': *328 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -52331,8 +54988,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#update-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -52624,10 +55281,10 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 - '307': &331 + default: *329 + '307': &330 description: Temporary Redirect content: application/json: @@ -52656,8 +55313,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#delete-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -52679,7 +55336,7 @@ paths: value: message: Organization members cannot delete repositories. documentation_url: https://docs.github.com/rest/repos/repos#delete-a-repository - '307': *331 + '307': *330 '404': *6 '409': *52 x-github: @@ -52703,11 +55360,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#list-artifacts-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 - - &364 + - &363 name: name description: The name field of an artifact. When specified, only artifacts with this name will be returned. @@ -52730,7 +55387,7 @@ paths: type: integer artifacts: type: array - items: &332 + items: &331 title: Artifact description: An artifact type: object @@ -52825,7 +55482,7 @@ paths: - expires_at - updated_at examples: - default: &365 + default: &364 value: total_count: 2 artifacts: @@ -52886,9 +55543,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#get-an-artifact parameters: + - *324 - *325 - - *326 - - &333 + - &332 name: artifact_id description: The unique identifier of the artifact. in: path @@ -52900,7 +55557,7 @@ paths: description: Response content: application/json: - schema: *332 + schema: *331 examples: default: value: @@ -52938,9 +55595,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#delete-an-artifact parameters: + - *324 - *325 - - *326 - - *333 + - *332 responses: '204': description: Response @@ -52964,9 +55621,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#download-an-artifact parameters: + - *324 - *325 - - *326 - - *333 + - *332 - name: archive_format in: path required: true @@ -52980,7 +55637,7 @@ paths: example: https://pipelines.actions.githubusercontent.com/OhgS4QRKqmgx7bKC27GKU83jnQjyeqG8oIMTge8eqtheppcmw8/_apis/pipelines/1/runs/176/signedlogcontent?urlExpires=2020-01-24T18%3A10%3A31.5729946Z&urlSigningMethod=HMACV1&urlSignature=agG73JakPYkHrh06seAkvmH7rBR4Ji4c2%2B6a2ejYh3E%3D schema: type: string - '410': &520 + '410': &519 description: Gone content: application/json: @@ -53005,14 +55662,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-retention-limit-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &334 + schema: &333 title: Actions cache retention limit for a repository description: GitHub Actions cache retention policy for a repository. type: object @@ -53046,13 +55703,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#set-github-actions-cache-retention-limit-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *334 + schema: *333 examples: selected_actions: *40 responses: @@ -53081,14 +55738,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-storage-limit-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &335 + schema: &334 title: Actions cache storage limit for a repository description: GitHub Actions cache storage policy for a repository. type: object @@ -53122,13 +55779,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#set-github-actions-cache-storage-limit-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *335 + schema: *334 examples: selected_actions: *42 responses: @@ -53159,14 +55816,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-usage-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *336 + schema: *335 examples: default: value: @@ -53192,11 +55849,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#list-github-actions-caches-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 - - &337 + - &336 name: ref description: The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/`. To reference @@ -53230,7 +55887,7 @@ paths: description: Response content: application/json: - schema: &338 + schema: &337 title: Repository actions caches description: Repository actions caches type: object @@ -53280,7 +55937,7 @@ paths: - total_count - actions_caches examples: - default: &339 + default: &338 value: total_count: 1 actions_caches: @@ -53312,23 +55969,23 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#delete-github-actions-caches-for-a-repository-using-a-cache-key parameters: + - *324 - *325 - - *326 - name: key description: A key for identifying the cache. in: query required: true schema: type: string - - *337 + - *336 responses: '200': description: Response content: application/json: - schema: *338 + schema: *337 examples: - default: *339 + default: *338 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -53348,8 +56005,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#delete-a-github-actions-cache-for-a-repository-using-a-cache-id parameters: + - *324 - *325 - - *326 - name: cache_id description: The unique identifier of the GitHub Actions cache. in: path @@ -53380,9 +56037,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#get-a-job-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - &340 + - &339 name: job_id description: The unique identifier of the job. in: path @@ -53394,7 +56051,7 @@ paths: description: Response content: application/json: - schema: &368 + schema: &367 title: Job description: Information of a job execution in a workflow run type: object @@ -53741,9 +56398,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *340 + - *339 responses: '302': description: Response @@ -53771,9 +56428,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run parameters: + - *324 - *325 - - *326 - - *340 + - *339 requestBody: required: false content: @@ -53795,7 +56452,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -53819,8 +56476,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Status response @@ -53870,8 +56527,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -53905,7 +56562,7 @@ paths: description: Empty response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -53934,8 +56591,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-repository-organization-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -53953,7 +56610,7 @@ paths: type: integer secrets: type: array - items: &370 + items: &369 title: Actions Secret description: Set secrets for GitHub Actions. type: object @@ -53974,7 +56631,7 @@ paths: - created_at - updated_at examples: - default: &371 + default: &370 value: total_count: 2 secrets: @@ -54007,9 +56664,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-repository-organization-variables parameters: + - *324 - *325 - - *326 - - *341 + - *340 - *19 responses: '200': @@ -54026,7 +56683,7 @@ paths: type: integer variables: type: array - items: &374 + items: &373 title: Actions Variable type: object properties: @@ -54060,7 +56717,7 @@ paths: - created_at - updated_at examples: - default: &375 + default: &374 value: total_count: 2 variables: @@ -54093,8 +56750,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-github-actions-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -54103,12 +56760,12 @@ paths: schema: type: object properties: - enabled: &343 + enabled: &342 type: boolean description: Whether GitHub Actions is enabled on the repository. - allowed_actions: *138 - selected_actions_url: *342 - sha_pinning_required: *139 + allowed_actions: *137 + selected_actions_url: *341 + sha_pinning_required: *138 required: - enabled examples: @@ -54136,8 +56793,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-github-actions-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -54148,9 +56805,9 @@ paths: schema: type: object properties: - enabled: *343 - allowed_actions: *138 - sha_pinning_required: *139 + enabled: *342 + allowed_actions: *137 + sha_pinning_required: *138 required: - enabled examples: @@ -54180,14 +56837,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &344 + schema: &343 type: object properties: access_level: @@ -54204,7 +56861,7 @@ paths: required: - access_level examples: - default: &345 + default: &344 value: access_level: organization x-github: @@ -54228,15 +56885,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *344 + schema: *343 examples: - default: *345 + default: *344 responses: '204': description: Response @@ -54260,14 +56917,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-artifact-and-log-retention-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *346 + schema: *345 examples: default: value: @@ -54291,8 +56948,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-artifact-and-log-retention-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Empty response for successful settings update @@ -54302,7 +56959,7 @@ paths: required: true content: application/json: - schema: *347 + schema: *346 examples: default: summary: Set retention days @@ -54326,16 +56983,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *140 + schema: *139 examples: - default: *348 + default: *347 '404': *6 x-github: enabledForGitHubApps: true @@ -54354,8 +57011,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -54365,7 +57022,7 @@ paths: required: true content: application/json: - schema: *140 + schema: *139 examples: default: summary: Set approval policy to first time contributors @@ -54389,16 +57046,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *349 + schema: *348 examples: - default: *141 + default: *140 '403': *27 '404': *6 x-github: @@ -54418,15 +57075,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *350 + schema: *349 examples: - default: *141 + default: *140 responses: '204': description: Empty response for successful settings update @@ -54450,16 +57107,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *143 + schema: *142 examples: - default: *144 + default: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -54478,8 +57135,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -54487,9 +57144,9 @@ paths: required: false content: application/json: - schema: *143 + schema: *142 examples: - selected_actions: *144 + selected_actions: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -54511,16 +57168,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-default-workflow-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *351 + schema: *350 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54541,8 +57198,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-default-workflow-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Success response @@ -54553,9 +57210,9 @@ paths: required: true content: application/json: - schema: *352 + schema: *351 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54582,8 +57239,8 @@ paths: in: query schema: type: string + - *324 - *325 - - *326 - *17 - *19 responses: @@ -54601,9 +57258,9 @@ paths: type: integer runners: type: array - items: *155 + items: *154 examples: - default: *156 + default: *155 headers: Link: *65 x-github: @@ -54627,8 +57284,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#list-runner-applications-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -54636,9 +57293,9 @@ paths: application/json: schema: type: array - items: *353 + items: *352 examples: - default: *354 + default: *353 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54660,8 +57317,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -54704,7 +57361,7 @@ paths: - no-gpu work_folder: _work responses: - '201': *355 + '201': *354 '404': *6 '422': *7 '409': *52 @@ -54735,16 +57392,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-a-registration-token-for-a-repository parameters: + - *324 - *325 - - *326 responses: '201': description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: *356 + default: *355 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54772,16 +57429,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-a-remove-token-for-a-repository parameters: + - *324 - *325 - - *326 responses: '201': description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: *357 + default: *356 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54803,17 +57460,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: '200': description: Response content: application/json: - schema: *155 + schema: *154 examples: - default: *358 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54834,9 +57491,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: '204': description: Response @@ -54862,11 +57519,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: - '200': *159 + '200': *158 '404': *6 x-github: githubCloudOnly: false @@ -54888,9 +57545,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 requestBody: required: true content: @@ -54914,7 +57571,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -54938,9 +57595,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 requestBody: required: true content: @@ -54965,7 +57622,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -54989,11 +57646,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: - '200': *359 + '200': *358 '404': *6 x-github: githubCloudOnly: false @@ -55020,12 +57677,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 - - *360 + - *153 + - *359 responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -55051,9 +57708,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#list-workflow-runs-for-a-repository parameters: + - *324 - *325 - - *326 - - &378 + - &377 name: actor description: Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. @@ -55061,7 +57718,7 @@ paths: required: false schema: type: string - - &379 + - &378 name: branch description: Returns workflow runs associated with a branch. Use the name of the branch of the `push`. @@ -55069,7 +57726,7 @@ paths: required: false schema: type: string - - &380 + - &379 name: event description: Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events @@ -55078,7 +57735,7 @@ paths: required: false schema: type: string - - &381 + - &380 name: status description: Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status @@ -55105,7 +57762,7 @@ paths: - pending - *17 - *19 - - &382 + - &381 name: created description: Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." @@ -55114,7 +57771,7 @@ paths: schema: type: string format: date-time - - &361 + - &360 name: exclude_pull_requests description: If `true` pull requests are omitted from the response (empty array). @@ -55123,13 +57780,13 @@ paths: schema: type: boolean default: false - - &383 + - &382 name: check_suite_id description: Returns workflow runs with the `check_suite_id` that you specify. in: query schema: type: integer - - &384 + - &383 name: head_sha description: Only returns workflow runs that are associated with the specified `head_sha`. @@ -55152,7 +57809,7 @@ paths: type: integer workflow_runs: type: array - items: &362 + items: &361 title: Workflow Run description: An invocation of a workflow type: object @@ -55330,7 +57987,7 @@ paths: head_commit: anyOf: - type: 'null' - - &406 + - &405 title: Simple Commit description: A commit. type: object @@ -55404,8 +58061,8 @@ paths: - timestamp - author - committer - repository: *153 - head_repository: *153 + repository: *152 + head_repository: *152 head_repository_id: type: integer examples: @@ -55445,7 +58102,7 @@ paths: - workflow_url - pull_requests examples: - default: &385 + default: &384 value: total_count: 1 workflow_runs: @@ -55681,24 +58338,24 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-a-workflow-run parameters: + - *324 - *325 - - *326 - - &363 + - &362 name: run_id description: The unique identifier of the workflow run. in: path required: true schema: type: integer - - *361 + - *360 responses: '200': description: Response content: application/json: - schema: *362 + schema: *361 examples: - default: &366 + default: &365 value: id: 30433642 name: Build @@ -55939,9 +58596,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#delete-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '204': description: Response @@ -55964,9 +58621,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-the-review-history-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -56094,15 +58751,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#approve-a-workflow-run-for-a-fork-pull-request parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56129,12 +58786,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#list-workflow-run-artifacts parameters: + - *324 - *325 - - *326 - - *363 + - *362 - *17 - *19 - - *364 + - *363 - *59 responses: '200': @@ -56151,9 +58808,9 @@ paths: type: integer artifacts: type: array - items: *332 + items: *331 examples: - default: *365 + default: *364 headers: Link: *65 x-github: @@ -56177,25 +58834,25 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-a-workflow-run-attempt parameters: + - *324 - *325 - - *326 - - *363 - - &367 + - *362 + - &366 name: attempt_number description: The attempt number of the workflow run. in: path required: true schema: type: integer - - *361 + - *360 responses: '200': description: Response content: application/json: - schema: *362 + schema: *361 examples: - default: *366 + default: *365 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -56218,10 +58875,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run-attempt parameters: + - *324 - *325 - - *326 - - *363 - - *367 + - *362 + - *366 - *17 - *19 responses: @@ -56239,9 +58896,9 @@ paths: type: integer jobs: type: array - items: *368 + items: *367 examples: - default: &369 + default: &368 value: total_count: 1 jobs: @@ -56354,10 +59011,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#download-workflow-run-attempt-logs parameters: + - *324 - *325 - - *326 - - *363 - - *367 + - *362 + - *366 responses: '302': description: Response @@ -56385,15 +59042,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#cancel-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '202': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56420,9 +59077,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: true content: @@ -56489,15 +59146,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#force-cancel-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '202': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56524,9 +59181,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 - name: filter description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all @@ -56556,9 +59213,9 @@ paths: type: integer jobs: type: array - items: *368 + items: *367 examples: - default: *369 + default: *368 headers: Link: *65 x-github: @@ -56583,9 +59240,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#download-workflow-run-logs parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '302': description: Response @@ -56612,9 +59269,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#delete-workflow-run-logs parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '204': description: Response @@ -56641,9 +59298,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -56712,7 +59369,7 @@ paths: items: type: object properties: - type: &486 + type: &485 type: string description: The type of reviewer. enum: @@ -56723,7 +59380,7 @@ paths: reviewer: anyOf: - *4 - - *188 + - *187 required: - environment - wait_timer @@ -56798,9 +59455,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: true content: @@ -56850,7 +59507,7 @@ paths: application/json: schema: type: array - items: &481 + items: &480 title: Deployment description: A request for a specific ref(branch,sha,tag) to be deployed @@ -56962,7 +59619,7 @@ paths: - created_at - updated_at examples: - default: &482 + default: &481 value: - url: https://api.github.com/repos/octocat/example/deployments/1 id: 1 @@ -57018,9 +59675,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-a-workflow parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: false content: @@ -57042,7 +59699,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57065,9 +59722,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-failed-jobs-from-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: false content: @@ -57089,7 +59746,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57121,9 +59778,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-workflow-run-usage parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -57260,8 +59917,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -57279,9 +59936,9 @@ paths: type: integer secrets: type: array - items: *370 + items: *369 examples: - default: *371 + default: *370 headers: Link: *65 x-github: @@ -57306,16 +59963,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57337,17 +59994,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *370 + schema: *369 examples: - default: &499 + default: &498 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -57373,9 +60030,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -57406,7 +60063,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57432,9 +60089,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -57459,9 +60116,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-repository-variables parameters: + - *324 - *325 - - *326 - - *341 + - *340 - *19 responses: '200': @@ -57478,9 +60135,9 @@ paths: type: integer variables: type: array - items: *374 + items: *373 examples: - default: *375 + default: *374 headers: Link: *65 x-github: @@ -57503,8 +60160,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#create-a-repository-variable parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -57531,7 +60188,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57556,17 +60213,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#get-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 responses: '200': description: Response content: application/json: - schema: *374 + schema: *373 examples: - default: &500 + default: &499 value: name: USERNAME value: octocat @@ -57592,9 +60249,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#update-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 requestBody: required: true content: @@ -57636,9 +60293,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#delete-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 responses: '204': description: Response @@ -57663,8 +60320,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#list-repository-workflows parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -57682,7 +60339,7 @@ paths: type: integer workflows: type: array - items: &376 + items: &375 title: Workflow description: A GitHub Actions workflow type: object @@ -57800,9 +60457,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#get-a-workflow parameters: + - *324 - *325 - - *326 - - &377 + - &376 name: workflow_id in: path description: The ID of the workflow. You can also pass the workflow file name @@ -57817,7 +60474,7 @@ paths: description: Response content: application/json: - schema: *376 + schema: *375 examples: default: value: @@ -57850,9 +60507,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#disable-a-workflow parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Response @@ -57877,9 +60534,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#create-a-workflow-dispatch-event parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Empty response when `return_run_details` parameter is `false`. @@ -57966,9 +60623,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#enable-a-workflow parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Response @@ -57995,19 +60652,19 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#list-workflow-runs-for-a-workflow parameters: + - *324 - *325 - - *326 + - *376 - *377 - *378 - *379 - *380 - - *381 - *17 - *19 + - *381 + - *360 - *382 - - *361 - *383 - - *384 responses: '200': description: Response @@ -58023,9 +60680,9 @@ paths: type: integer workflow_runs: type: array - items: *362 + items: *361 examples: - default: *385 + default: *384 headers: Link: *65 x-github: @@ -58057,9 +60714,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#get-workflow-usage parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '200': description: Response @@ -58120,8 +60777,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-activities parameters: + - *324 - *325 - - *326 - *59 - *17 - *45 @@ -58289,8 +60946,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#list-assignees parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -58327,8 +60984,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#check-if-a-user-can-be-assigned parameters: + - *324 - *325 - - *326 - name: assignee in: path required: true @@ -58364,8 +61021,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/attestations#create-an-attestation parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -58475,8 +61132,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/attestations#list-attestations parameters: + - *324 - *325 - - *326 - *17 - *45 - *46 @@ -58533,7 +61190,7 @@ paths: initiator: type: string examples: - default: *386 + default: *385 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -58553,8 +61210,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#get-all-autolinks-of-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -58562,7 +61219,7 @@ paths: application/json: schema: type: array - items: &387 + items: &386 title: Autolink reference description: An autolink reference. type: object @@ -58621,8 +61278,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#create-an-autolink-reference-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -58661,9 +61318,9 @@ paths: description: response content: application/json: - schema: *387 + schema: *386 examples: - default: &388 + default: &387 value: id: 1 key_prefix: TICKET- @@ -58694,9 +61351,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#get-an-autolink-reference-of-a-repository parameters: + - *324 - *325 - - *326 - - &389 + - &388 name: autolink_id description: The unique identifier of the autolink. in: path @@ -58708,9 +61365,9 @@ paths: description: Response content: application/json: - schema: *387 + schema: *386 examples: - default: *388 + default: *387 '404': *6 x-github: githubCloudOnly: false @@ -58730,9 +61387,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#delete-an-autolink-reference-from-a-repository parameters: + - *324 - *325 - - *326 - - *389 + - *388 responses: '204': description: Response @@ -58756,8 +61413,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-dependabot-security-updates-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response if Dependabot is enabled @@ -58807,8 +61464,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-dependabot-security-updates parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -58829,8 +61486,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-dependabot-security-updates parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -58850,8 +61507,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#list-branches parameters: + - *324 - *325 - - *326 - name: protected description: Setting to `true` returns only branches protected by branch protections or rulesets. When set to `false`, only unprotected branches are returned. @@ -58889,7 +61546,7 @@ paths: - url protected: type: boolean - protection: &391 + protection: &390 title: Branch Protection description: Branch Protection type: object @@ -58932,7 +61589,7 @@ paths: required: - contexts - checks - enforce_admins: &394 + enforce_admins: &393 title: Protected Branch Admin Enforced description: Protected Branch Admin Enforced type: object @@ -58949,7 +61606,7 @@ paths: required: - url - enabled - required_pull_request_reviews: &396 + required_pull_request_reviews: &395 title: Protected Branch Pull Request Review description: Protected Branch Pull Request Review type: object @@ -58971,7 +61628,7 @@ paths: description: The list of teams with review dismissal access. type: array - items: *188 + items: *187 apps: description: The list of apps with review dismissal access. @@ -59003,7 +61660,7 @@ paths: description: The list of teams allowed to bypass pull request requirements. type: array - items: *188 + items: *187 apps: description: The list of apps allowed to bypass pull request requirements. @@ -59033,7 +61690,7 @@ paths: required: - dismiss_stale_reviews - require_code_owner_reviews - restrictions: &393 + restrictions: &392 title: Branch Restriction Policy description: Branch Restriction Policy type: object @@ -59096,7 +61753,7 @@ paths: type: string teams: type: array - items: *188 + items: *187 apps: type: array items: @@ -59326,9 +61983,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#get-a-branch parameters: + - *324 - *325 - - *326 - - &392 + - &391 name: branch description: The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use [the GraphQL API](https://docs.github.com/graphql). @@ -59342,14 +61999,14 @@ paths: description: Response content: application/json: - schema: &402 + schema: &401 title: Branch With Protection description: Branch With Protection type: object properties: name: type: string - commit: &456 + commit: &455 title: Commit description: Commit type: object @@ -59388,7 +62045,7 @@ paths: author: anyOf: - type: 'null' - - &390 + - &389 title: Git User description: Metaproperties for Git author/committer information. @@ -59410,7 +62067,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 message: type: string examples: @@ -59434,7 +62091,7 @@ paths: required: - sha - url - verification: &506 + verification: &505 title: Verification type: object properties: @@ -59470,14 +62127,14 @@ paths: author: oneOf: - *4 - - *162 + - *161 type: - 'null' - object committer: oneOf: - *4 - - *162 + - *161 type: - 'null' - object @@ -59514,7 +62171,7 @@ paths: type: integer files: type: array - items: &467 + items: &466 title: Diff Entry description: Diff Entry type: object @@ -59610,7 +62267,7 @@ paths: - self protected: type: boolean - protection: *391 + protection: *390 protection_url: type: string format: uri @@ -59719,7 +62376,7 @@ paths: contexts: [] checks: [] protection_url: https://api.github.com/repos/octocat/Hello-World/branches/main/protection - '301': *329 + '301': *328 '404': *6 x-github: githubCloudOnly: false @@ -59741,15 +62398,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *391 + schema: *390 examples: default: value: @@ -59943,9 +62600,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -60205,7 +62862,7 @@ paths: url: type: string format: uri - required_status_checks: &399 + required_status_checks: &398 title: Status Check Policy description: Status Check Policy type: object @@ -60286,7 +62943,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 apps: type: array items: *5 @@ -60304,7 +62961,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 apps: type: array items: *5 @@ -60364,7 +63021,7 @@ paths: additionalProperties: false required: - enabled - restrictions: *393 + restrictions: *392 required_conversation_resolution: type: object properties: @@ -60476,9 +63133,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60503,17 +63160,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: &395 + default: &394 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins enabled: true @@ -60535,17 +63192,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: *395 + default: *394 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -60564,9 +63221,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60591,17 +63248,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *396 + schema: *395 examples: - default: &397 + default: &396 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews dismissal_restrictions: @@ -60697,9 +63354,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -60797,9 +63454,9 @@ paths: description: Response content: application/json: - schema: *396 + schema: *395 examples: - default: *397 + default: *396 '422': *15 x-github: githubCloudOnly: false @@ -60820,9 +63477,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60849,17 +63506,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: &398 + default: &397 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_signatures enabled: true @@ -60882,17 +63539,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#create-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: *398 + default: *397 '404': *6 x-github: githubCloudOnly: false @@ -60912,9 +63569,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60939,17 +63596,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-status-checks-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *399 + schema: *398 examples: - default: &400 + default: &399 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks strict: true @@ -60975,9 +63632,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-status-check-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61029,9 +63686,9 @@ paths: description: Response content: application/json: - schema: *399 + schema: *398 examples: - default: *400 + default: *399 '404': *6 '422': *15 x-github: @@ -61053,9 +63710,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-status-check-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61079,9 +63736,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-all-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61115,9 +63772,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61184,9 +63841,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61250,9 +63907,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: content: application/json: @@ -61318,15 +63975,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *393 + schema: *392 examples: default: value: @@ -61417,9 +64074,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61442,9 +64099,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-apps-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61454,7 +64111,7 @@ paths: type: array items: *5 examples: - default: &401 + default: &400 value: - id: 1 slug: octoapp @@ -61511,9 +64168,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61547,7 +64204,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -61568,9 +64225,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61604,7 +64261,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -61625,9 +64282,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61661,7 +64318,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -61683,9 +64340,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-teams-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61693,9 +64350,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '404': *6 x-github: githubCloudOnly: false @@ -61715,9 +64372,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61753,9 +64410,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -61776,9 +64433,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61814,9 +64471,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -61837,9 +64494,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: content: application/json: @@ -61874,9 +64531,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -61898,9 +64555,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-users-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61934,9 +64591,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61994,9 +64651,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62054,9 +64711,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62116,9 +64773,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#rename-a-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62140,7 +64797,7 @@ paths: description: Response content: application/json: - schema: *402 + schema: *401 examples: default: value: @@ -62256,8 +64913,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#create-a-check-run parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -62536,7 +65193,7 @@ paths: description: Response content: application/json: - schema: &403 + schema: &402 title: CheckRun description: A check performed on the code of a given code change type: object @@ -62672,7 +65329,7 @@ paths: check. type: array items: *84 - deployment: &711 + deployment: &710 title: Deployment description: A deployment created as the result of an Actions check run from a workflow that references an environment @@ -62959,9 +65616,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#get-a-check-run parameters: + - *324 - *325 - - *326 - - &404 + - &403 name: check_run_id description: The unique identifier of the check run. in: path @@ -62973,9 +65630,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: &405 + default: &404 value: id: 4 head_sha: ce587453ced02b1526dfb4cb910479d431683101 @@ -63075,9 +65732,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#update-a-check-run parameters: + - *324 - *325 - - *326 - - *404 + - *403 requestBody: required: true content: @@ -63317,9 +65974,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: *405 + default: *404 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -63339,9 +65996,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-run-annotations parameters: + - *324 - *325 - - *326 - - *404 + - *403 - *17 - *19 responses: @@ -63451,15 +66108,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#rerequest-a-check-run parameters: + - *324 - *325 - - *326 - - *404 + - *403 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -63497,8 +66154,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#create-a-check-suite parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -63520,7 +66177,7 @@ paths: description: Response when the suite already exists content: application/json: - schema: &407 + schema: &406 title: CheckSuite description: A suite of checks performed on the code of a given code change @@ -63607,7 +66264,7 @@ paths: anyOf: - type: 'null' - *5 - repository: *153 + repository: *152 created_at: type: - string @@ -63618,7 +66275,7 @@ paths: - string - 'null' format: date-time - head_commit: *406 + head_commit: *405 latest_check_runs_count: type: integer check_runs_url: @@ -63646,7 +66303,7 @@ paths: - check_runs_url - pull_requests examples: - default: &408 + default: &407 value: id: 5 node_id: MDEwOkNoZWNrU3VpdGU1 @@ -63937,9 +66594,9 @@ paths: description: Response when the suite was created content: application/json: - schema: *407 + schema: *406 examples: - default: *408 + default: *407 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -63958,8 +66615,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#update-repository-preferences-for-check-suites parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -64020,7 +66677,7 @@ paths: required: - app_id - setting - repository: *153 + repository: *152 examples: default: value: @@ -64268,9 +66925,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#get-a-check-suite parameters: + - *324 - *325 - - *326 - - &409 + - &408 name: check_suite_id description: The unique identifier of the check suite. in: path @@ -64282,9 +66939,9 @@ paths: description: Response content: application/json: - schema: *407 + schema: *406 examples: - default: *408 + default: *407 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -64307,17 +66964,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-runs-in-a-check-suite parameters: + - *324 - *325 - - *326 - - *409 - - &462 + - *408 + - &461 name: check_name description: Returns check runs with the specified `name`. in: query required: false schema: type: string - - &463 + - &462 name: status description: Returns check runs with the specified `status`. in: query @@ -64356,9 +67013,9 @@ paths: type: integer check_runs: type: array - items: *403 + items: *402 examples: - default: &464 + default: &463 value: total_count: 1 check_runs: @@ -64460,15 +67117,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#rerequest-a-check-suite parameters: + - *324 - *325 - - *326 - - *409 + - *408 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -64495,21 +67152,21 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *409 - *410 - - *411 - *19 - *17 - - &428 + - &427 name: ref description: The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. in: query required: false - schema: *412 - - &429 + schema: *411 + - &428 name: pr description: The number of the pull request for the results you want to list. in: query @@ -64534,13 +67191,13 @@ paths: be returned. in: query required: false - schema: *413 + schema: *412 - name: severity description: If specified, only code scanning alerts with this severity will be returned. in: query required: false - schema: *414 + schema: *413 - name: assignees description: | Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., `octocat` or `octocat,hubot`). @@ -64559,24 +67216,24 @@ paths: items: type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: *415 - state: *180 - fixed_at: *176 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: *414 + state: *179 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: *416 - dismissed_comment: *417 - rule: *418 - tool: *419 - most_recent_instance: *420 + dismissed_at: *176 + dismissed_reason: *415 + dismissed_comment: *416 + rule: *417 + tool: *418 + most_recent_instance: *419 dismissal_approved_by: anyOf: - type: 'null' @@ -64699,7 +67356,7 @@ paths: classifications: [] instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/3/instances '304': *35 - '403': &421 + '403': &420 description: Response if GitHub Advanced Security is not enabled for this repository content: @@ -64726,9 +67383,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - &422 + - &421 name: alert_number in: path description: The number that identifies an alert. You can find this at the @@ -64736,30 +67393,30 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *171 + schema: *170 responses: '200': description: Response content: application/json: - schema: &423 + schema: &422 type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: *415 - state: *180 - fixed_at: *176 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: *414 + state: *179 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: *416 - dismissed_comment: *417 + dismissed_at: *176 + dismissed_reason: *415 + dismissed_comment: *416 rule: type: object properties: @@ -64821,8 +67478,8 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: *419 - most_recent_instance: *420 + tool: *418 + most_recent_instance: *419 dismissal_approved_by: anyOf: - type: 'null' @@ -64918,7 +67575,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '304': *35 - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -64938,9 +67595,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#update-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: true content: @@ -64955,8 +67612,8 @@ paths: enum: - open - dismissed - dismissed_reason: *416 - dismissed_comment: *417 + dismissed_reason: *415 + dismissed_comment: *416 create_request: type: boolean description: If `true`, attempt to create an alert dismissal request. @@ -64984,7 +67641,7 @@ paths: description: Response content: application/json: - schema: *423 + schema: *422 examples: default: value: @@ -65060,7 +67717,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '400': *14 - '403': &427 + '403': &426 description: Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository content: @@ -65087,15 +67744,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 responses: '200': description: Response content: application/json: - schema: &424 + schema: &423 type: object properties: status: @@ -65122,13 +67779,13 @@ paths: - description - started_at examples: - default: &425 + default: &424 value: status: success description: This fixes an XSS vulnerability by escaping the user input. started_at: '2024-02-14T12:29:18Z' - '400': &426 + '400': &425 description: Bad Request content: application/json: @@ -65139,7 +67796,7 @@ paths: message: The alert_number is not valid documentation_url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert status: '400' - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65164,29 +67821,29 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 responses: '200': description: OK content: application/json: - schema: *424 + schema: *423 examples: - default: *425 + default: *424 '202': description: Accepted content: application/json: - schema: *424 + schema: *423 examples: default: value: status: pending description: started_at: '2024-02-14T12:29:18Z' - '400': *426 + '400': *425 '403': description: Response if the repository is archived, if GitHub Advanced Security is not enabled for this repository or if rate limit is exceeded @@ -65218,9 +67875,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: false content: @@ -65266,8 +67923,8 @@ paths: value: target_ref: refs/heads/main sha: 178f4f6090b3fccad4a65b3e83d076a622d59652 - '400': *426 - '403': *427 + '400': *425 + '403': *426 '404': *6 '422': description: Unprocessable Entity @@ -65291,13 +67948,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 - *19 - *17 + - *427 - *428 - - *429 responses: '200': description: Response @@ -65308,10 +67965,10 @@ paths: items: type: object properties: - ref: *412 - analysis_key: *430 - environment: *431 - category: *432 + ref: *411 + analysis_key: *429 + environment: *430 + category: *431 state: type: - string @@ -65328,7 +67985,7 @@ paths: properties: text: type: string - location: *433 + location: *432 html_url: type: string classifications: @@ -65336,7 +67993,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: *434 + items: *433 examples: default: value: @@ -65373,7 +68030,7 @@ paths: end_column: 50 classifications: - source - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65407,25 +68064,25 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository parameters: + - *324 - *325 - - *326 + - *409 - *410 - - *411 - *19 - *17 - - *429 + - *428 - name: ref in: query description: The Git reference for the analyses you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. required: false - schema: *412 + schema: *411 - name: sarif_id in: query description: Filter analyses belonging to the same SARIF upload. required: false - schema: &435 + schema: &434 type: string description: An identifier for the upload. examples: @@ -65447,23 +68104,23 @@ paths: application/json: schema: type: array - items: &436 + items: &435 type: object properties: - ref: *412 - commit_sha: &444 + ref: *411 + commit_sha: &443 description: The SHA of the commit to which the analysis you are uploading relates. type: string minLength: 40 maxLength: 40 pattern: "^[0-9a-fA-F]+$" - analysis_key: *430 + analysis_key: *429 environment: type: string description: Identifies the variable values associated with the environment in which this analysis was performed. - category: *432 + category: *431 error: type: string examples: @@ -65488,8 +68145,8 @@ paths: description: The REST API URL of the analysis resource. format: uri readOnly: true - sarif_id: *435 - tool: *419 + sarif_id: *434 + tool: *418 deletable: type: boolean warning: @@ -65551,7 +68208,7 @@ paths: version: 1.2.0 deletable: true warning: '' - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65587,8 +68244,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository parameters: + - *324 - *325 - - *326 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -65601,7 +68258,7 @@ paths: description: Response content: application/json: - schema: *436 + schema: *435 examples: response: summary: application/json response @@ -65655,7 +68312,7 @@ paths: properties: - github/alertNumber: 2 - github/alertUrl: https://api.github.com/repos/monalisa/monalisa/code-scanning/alerts/2 - '403': *421 + '403': *420 '404': *6 '422': description: Response if analysis could not be processed @@ -65742,8 +68399,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository parameters: + - *324 - *325 - - *326 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -65799,7 +68456,7 @@ paths: next_analysis_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41 confirm_delete_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41?confirm_delete '400': *14 - '403': *427 + '403': *426 '404': *6 '503': *113 x-github: @@ -65821,8 +68478,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -65830,7 +68487,7 @@ paths: application/json: schema: type: array - items: &437 + items: &436 title: CodeQL Database description: A CodeQL database. type: object @@ -65942,7 +68599,7 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65971,8 +68628,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository parameters: + - *324 - *325 - - *326 - name: language in: path description: The language of the CodeQL database. @@ -65984,7 +68641,7 @@ paths: description: Response content: application/json: - schema: *437 + schema: *436 examples: default: value: @@ -66016,9 +68673,9 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '302': &469 + '302': &468 description: Found - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66040,8 +68697,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#delete-a-codeql-database parameters: + - *324 - *325 - - *326 - name: language in: path description: The language of the CodeQL database. @@ -66051,7 +68708,7 @@ paths: responses: '204': description: Response - '403': *427 + '403': *426 '404': *6 '503': *113 x-github: @@ -66079,8 +68736,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#create-a-codeql-variant-analysis parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -66089,7 +68746,7 @@ paths: type: object additionalProperties: false properties: - language: &438 + language: &437 type: string description: The language targeted by the CodeQL query enum: @@ -66169,7 +68826,7 @@ paths: description: Variant analysis submitted for processing content: application/json: - schema: &442 + schema: &441 title: Variant Analysis description: A run of a CodeQL query against one or more repositories. type: object @@ -66179,7 +68836,7 @@ paths: description: The ID of the variant analysis. controller_repo: *64 actor: *4 - query_language: *438 + query_language: *437 query_pack_url: type: string description: The download url for the query pack. @@ -66227,7 +68884,7 @@ paths: items: type: object properties: - repository: &439 + repository: &438 title: Repository Identifier description: Repository Identifier type: object @@ -66269,7 +68926,7 @@ paths: - private - stargazers_count - updated_at - analysis_status: &443 + analysis_status: &442 type: string description: The new status of the CodeQL variant analysis repository task. @@ -66301,7 +68958,7 @@ paths: from processing. This information is only available to the user that initiated the variant analysis. properties: - access_mismatch_repos: &440 + access_mismatch_repos: &439 type: object properties: repository_count: @@ -66316,7 +68973,7 @@ paths: This list may not include all repositories that were skipped. This is only available when the repository was found and the user has access to it. - items: *439 + items: *438 required: - repository_count - repositories @@ -66339,8 +68996,8 @@ paths: required: - repository_count - repository_full_names - no_codeql_db_repos: *440 - over_limit_repos: *440 + no_codeql_db_repos: *439 + over_limit_repos: *439 required: - access_mismatch_repos - not_found_repos @@ -66356,7 +69013,7 @@ paths: examples: repositories_parameter: summary: Response for a successful variant analysis submission - value: &441 + value: &440 summary: Default response value: id: 1 @@ -66502,10 +69159,10 @@ paths: private: false repository_owners: summary: Response for a successful variant analysis submission - value: *441 + value: *440 repository_lists: summary: Response for a successful variant analysis submission - value: *441 + value: *440 '404': *6 '422': description: Unable to process variant analysis submission @@ -66533,8 +69190,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-summary-of-a-codeql-variant-analysis parameters: + - *324 - *325 - - *326 - name: codeql_variant_analysis_id in: path description: The unique identifier of the variant analysis. @@ -66546,9 +69203,9 @@ paths: description: Response content: application/json: - schema: *442 + schema: *441 examples: - default: *441 + default: *440 '404': *6 '503': *113 x-github: @@ -66571,7 +69228,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-analysis-status-of-a-repository-in-a-codeql-variant-analysis parameters: - - *325 + - *324 - name: repo in: path description: The name of the controller repository. @@ -66606,7 +69263,7 @@ paths: type: object properties: repository: *64 - analysis_status: *443 + analysis_status: *442 artifact_size_in_bytes: type: integer description: The size of the artifact. This is only available @@ -66731,8 +69388,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -66825,7 +69482,7 @@ paths: threat_model: remote updated_at: '2023-01-19T11:21:34Z' schedule: weekly - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66846,8 +69503,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -66916,7 +69573,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -66941,7 +69598,7 @@ paths: value: run_id: 42 run_url: https://api.github.com/repos/octoorg/octocat/actions/runs/42 - '403': *427 + '403': *426 '404': *6 '409': description: Response if there is already a validation run in progress with @@ -67012,8 +69669,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#upload-an-analysis-as-sarif-data parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -67021,7 +69678,7 @@ paths: schema: type: object properties: - commit_sha: *444 + commit_sha: *443 ref: type: string description: |- @@ -67081,7 +69738,7 @@ paths: schema: type: object properties: - id: *435 + id: *434 url: type: string description: The REST API URL for checking the status of the upload. @@ -67095,7 +69752,7 @@ paths: url: https://api.github.com/repos/octocat/hello-world/code-scanning/sarifs/47177e22-5596-11eb-80a1-c1e54ef945c6 '400': description: Bad Request if the sarif field is invalid - '403': *427 + '403': *426 '404': *6 '413': description: Payload Too Large if the sarif field is too large @@ -67118,8 +69775,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-information-about-a-sarif-upload parameters: + - *324 - *325 - - *326 - name: sarif_id description: The SARIF ID obtained after uploading. in: path @@ -67167,7 +69824,7 @@ paths: value: processing_status: complete analyses_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses?sarif_id=47177e22-5596-11eb-80a1-c1e54ef945c6 - '403': *421 + '403': *420 '404': description: Not Found if the sarif id does not match any upload '503': *113 @@ -67192,8 +69849,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-security/configurations#get-the-code-security-configuration-associated-with-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -67249,7 +69906,7 @@ paths: html_url: https://github.com/organizations/octo-org/settings/security_products/configurations/edit/1325 created_at: '2024-05-01T00:00:00Z' updated_at: '2024-05-01T00:00:00Z' - '204': *184 + '204': *183 '304': *35 '403': *27 '404': *6 @@ -67274,8 +69931,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-codeowners-errors parameters: + - *324 - *325 - - *326 - name: ref description: 'A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository''s default branch @@ -67403,8 +70060,8 @@ paths: parameters: - *17 - *19 + - *324 - *325 - - *326 responses: '200': description: Response @@ -67420,7 +70077,7 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: default: value: @@ -67718,8 +70375,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-codespace-in-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -67783,17 +70440,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '400': *14 '401': *23 '403': *27 @@ -67822,8 +70479,8 @@ paths: parameters: - *17 - *19 + - *324 - *325 - - *326 responses: '200': description: Response @@ -67887,8 +70544,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/machines#list-available-machine-types-for-a-repository parameters: + - *324 - *325 - - *326 - name: location description: The location to check for available machines. Assigned by IP if not provided. @@ -67925,9 +70582,9 @@ paths: type: integer machines: type: array - items: *446 + items: *445 examples: - default: &655 + default: &654 value: total_count: 2 machines: @@ -67967,8 +70624,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-default-attributes-for-a-codespace parameters: + - *324 - *325 - - *326 - name: ref description: The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked. @@ -68055,8 +70712,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user parameters: + - *324 - *325 - - *326 - name: ref description: The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of `ref` will typically @@ -68125,8 +70782,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -68144,7 +70801,7 @@ paths: type: integer secrets: type: array - items: &450 + items: &449 title: Codespaces Secret description: Set repository secrets for GitHub Codespaces. type: object @@ -68165,7 +70822,7 @@ paths: - created_at - updated_at examples: - default: *447 + default: *446 headers: Link: *65 x-github: @@ -68188,16 +70845,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *448 + schema: *447 examples: - default: *449 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -68217,17 +70874,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *450 + schema: *449 examples: - default: *451 + default: *450 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68247,9 +70904,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -68277,7 +70934,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -68301,9 +70958,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -68331,8 +70988,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#list-repository-collaborators parameters: + - *324 - *325 - - *326 - name: affiliation description: Filter collaborators returned by their affiliation. `outside` means all outside collaborators of an organization-owned repository. `direct` @@ -68370,7 +71027,7 @@ paths: application/json: schema: type: array - items: &452 + items: &451 title: Collaborator description: Collaborator type: object @@ -68563,8 +71220,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 responses: '204': @@ -68611,8 +71268,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#add-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 requestBody: required: false @@ -68639,7 +71296,7 @@ paths: description: Response when a new invitation is created content: application/json: - schema: &519 + schema: &518 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -68651,7 +71308,7 @@ paths: format: int64 examples: - 42 - repository: *153 + repository: *152 invitee: anyOf: - type: 'null' @@ -68867,8 +71524,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#remove-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 responses: '204': @@ -68900,8 +71557,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#get-repository-permissions-for-a-user parameters: + - *324 - *325 - - *326 - *69 responses: '200': @@ -68922,7 +71579,7 @@ paths: user: anyOf: - type: 'null' - - *452 + - *451 required: - permission - role_name @@ -68976,8 +71633,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#list-commit-comments-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -68987,7 +71644,7 @@ paths: application/json: schema: type: array - items: &453 + items: &452 title: Commit Comment description: Commit Comment type: object @@ -69045,7 +71702,7 @@ paths: - created_at - updated_at examples: - default: &458 + default: &457 value: - html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -69104,17 +71761,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#get-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': description: Response content: application/json: - schema: *453 + schema: *452 examples: - default: &459 + default: &458 value: html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -69171,8 +71828,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#update-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -69195,7 +71852,7 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: default: value: @@ -69246,8 +71903,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#delete-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -69269,8 +71926,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -69297,7 +71954,7 @@ paths: application/json: schema: type: array - items: &454 + items: &453 title: Reaction description: Reactions to conversations provide a way to help people express their feelings more simply and effectively. @@ -69341,7 +71998,7 @@ paths: - content - created_at examples: - default: &522 + default: &521 value: - id: 1 node_id: MDg6UmVhY3Rpb24x @@ -69386,8 +72043,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -69420,9 +72077,9 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: &455 + default: &454 value: id: 1 node_id: MDg6UmVhY3Rpb24x @@ -69451,9 +72108,9 @@ paths: description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -69475,10 +72132,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-commit-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - &523 + - &522 name: reaction_id description: The unique identifier of the reaction. in: path @@ -69533,8 +72190,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-commits parameters: + - *324 - *325 - - *326 - name: sha description: 'SHA or branch to start listing commits from. Default: the repository’s default branch (usually `main`).' @@ -69590,9 +72247,9 @@ paths: application/json: schema: type: array - items: *456 + items: *455 examples: - default: &569 + default: &568 value: - url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -69686,9 +72343,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-branches-for-head-commit parameters: + - *324 - *325 - - *326 - - &457 + - &456 name: commit_sha description: The SHA of the commit. in: path @@ -69760,9 +72417,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#list-commit-comments parameters: + - *324 - *325 - - *326 - - *457 + - *456 - *17 - *19 responses: @@ -69772,9 +72429,9 @@ paths: application/json: schema: type: array - items: *453 + items: *452 examples: - default: *458 + default: *457 headers: Link: *65 x-github: @@ -69802,9 +72459,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#create-a-commit-comment parameters: + - *324 - *325 - - *326 - - *457 + - *456 requestBody: required: true content: @@ -69839,9 +72496,9 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: - default: *459 + default: *458 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -69869,9 +72526,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-pull-requests-associated-with-a-commit parameters: + - *324 - *325 - - *326 - - *457 + - *456 - *17 - *19 responses: @@ -69881,9 +72538,9 @@ paths: application/json: schema: type: array - items: *460 + items: *459 examples: - default: &561 + default: &560 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -70420,11 +73077,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#get-a-commit parameters: + - *324 - *325 - - *326 - *19 - *17 - - &461 + - &460 name: ref description: 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](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" @@ -70439,9 +73096,9 @@ paths: description: Response content: application/json: - schema: *456 + schema: *455 examples: - default: &549 + default: &548 value: url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -70554,11 +73211,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-runs-for-a-git-reference parameters: + - *324 - *325 - - *326 + - *460 - *461 - *462 - - *463 - name: filter description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. @@ -70592,9 +73249,9 @@ paths: type: integer check_runs: type: array - items: *403 + items: *402 examples: - default: *464 + default: *463 headers: Link: *65 x-github: @@ -70619,9 +73276,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#list-check-suites-for-a-git-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - name: app_id description: Filters check suites by GitHub App `id`. in: query @@ -70629,7 +73286,7 @@ paths: schema: type: integer example: 1 - - *462 + - *461 - *17 - *19 responses: @@ -70647,7 +73304,7 @@ paths: type: integer check_suites: type: array - items: *407 + items: *406 examples: default: value: @@ -70847,9 +73504,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#get-the-combined-status-for-a-specific-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - *17 - *19 responses: @@ -70920,7 +73577,7 @@ paths: type: string total_count: type: integer - repository: *153 + repository: *152 commit_url: type: string format: uri @@ -71051,9 +73708,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#list-commit-statuses-for-a-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - *17 - *19 responses: @@ -71063,7 +73720,7 @@ paths: application/json: schema: type: array - items: &634 + items: &633 title: Status description: The status of a commit. type: object @@ -71144,7 +73801,7 @@ paths: site_admin: false headers: Link: *65 - '301': *329 + '301': *328 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -71172,8 +73829,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/community#get-community-profile-metrics parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -71206,11 +73863,11 @@ paths: code_of_conduct: anyOf: - type: 'null' - - *465 + - *464 code_of_conduct_file: anyOf: - type: 'null' - - &466 + - &465 title: Community Health File type: object properties: @@ -71230,19 +73887,19 @@ paths: contributing: anyOf: - type: 'null' - - *466 + - *465 readme: anyOf: - type: 'null' - - *466 + - *465 issue_template: anyOf: - type: 'null' - - *466 + - *465 pull_request_template: anyOf: - type: 'null' - - *466 + - *465 required: - code_of_conduct - code_of_conduct_file @@ -71371,8 +74028,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#compare-two-commits parameters: + - *324 - *325 - - *326 - *19 - *17 - name: basehead @@ -71420,8 +74077,8 @@ paths: format: uri examples: - https://github.com/octocat/Hello-World/compare/master...topic.patch - base_commit: *456 - merge_base_commit: *456 + base_commit: *455 + merge_base_commit: *455 status: type: string enum: @@ -71445,10 +74102,10 @@ paths: - 6 commits: type: array - items: *456 + items: *455 files: type: array - items: *467 + items: *466 required: - url - html_url @@ -71734,8 +74391,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-repository-content parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -71905,7 +74562,7 @@ paths: - type - url examples: - response-if-content-is-a-file-github-object: &468 + response-if-content-is-a-file-github-object: &467 summary: Response if content is a file value: type: file @@ -72042,7 +74699,7 @@ paths: - size - type - url - - &574 + - &573 title: Content File description: Content File type: object @@ -72260,7 +74917,7 @@ paths: - url - submodule_git_url examples: - response-if-content-is-a-file: *468 + response-if-content-is-a-file: *467 response-if-content-is-a-directory: summary: Response if content is a directory and the application/json media type is requested @@ -72329,7 +74986,7 @@ paths: html: https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9 '404': *6 '403': *27 - '302': *469 + '302': *468 '304': *35 x-github: githubCloudOnly: false @@ -72352,8 +75009,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#create-or-update-file-contents parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -72448,7 +75105,7 @@ paths: description: Response content: application/json: - schema: &470 + schema: &469 title: File Commit description: File Commit type: object @@ -72604,7 +75261,7 @@ paths: description: Response content: application/json: - schema: *470 + schema: *469 examples: example-for-creating-a-file: value: @@ -72658,7 +75315,7 @@ paths: schema: oneOf: - *3 - - &501 + - &500 description: Repository rule violation was detected type: object properties: @@ -72679,7 +75336,7 @@ paths: items: type: object properties: - placeholder_id: &626 + placeholder_id: &625 description: The ID of the push protection bypass placeholder. This value is returned on any push protected routes. @@ -72711,8 +75368,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#delete-a-file parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -72773,7 +75430,7 @@ paths: description: Response content: application/json: - schema: *470 + schema: *469 examples: default: value: @@ -72828,8 +75485,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-contributors parameters: + - *324 - *325 - - *326 - name: anon description: Set to `1` or `true` to include anonymous contributors in results. in: query @@ -72953,23 +75610,23 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *189 - *190 - *191 - *192 - - *193 - name: manifest in: query description: A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned. schema: type: string + - *193 + - *470 - *194 - - *471 - *195 - *196 - - *197 - *59 - *45 - *46 @@ -72981,11 +75638,11 @@ paths: application/json: schema: type: array - items: &475 + items: &474 type: object description: A Dependabot alert. properties: - number: *171 + number: *170 state: type: string description: The state of the Dependabot alert. @@ -73030,14 +75687,15 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: *472 + security_advisory: *471 security_vulnerability: *63 - url: *174 - html_url: *175 - created_at: *172 - updated_at: *173 - dismissed_at: *177 + url: *173 + html_url: *174 + created_at: *171 + updated_at: *172 + dismissed_at: *176 dismissed_by: anyOf: - type: 'null' @@ -73061,9 +75719,9 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *176 - auto_dismissed_at: *473 - dismissal_request: *474 + fixed_at: *175 + auto_dismissed_at: *472 + dismissal_request: *473 assignees: type: array description: The users assigned to this alert. @@ -73135,7 +75793,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -73318,9 +75976,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#get-a-dependabot-alert parameters: + - *324 - *325 - - *326 - - &476 + - &475 name: alert_number in: path description: |- @@ -73329,13 +75987,13 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *171 + schema: *170 responses: '200': description: Response content: application/json: - schema: *475 + schema: *474 examples: default: value: @@ -73392,7 +76050,7 @@ paths: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 @@ -73467,9 +76125,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#update-a-dependabot-alert parameters: + - *324 - *325 - - *326 - - *476 + - *475 requestBody: required: true content: @@ -73525,7 +76183,7 @@ paths: description: Response content: application/json: - schema: *475 + schema: *474 examples: default: value: @@ -73655,8 +76313,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -73674,7 +76332,7 @@ paths: type: integer secrets: type: array - items: &479 + items: &478 title: Dependabot Secret description: Set secrets for Dependabot. type: object @@ -73728,16 +76386,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *477 + schema: *476 examples: - default: *478 + default: *477 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -73757,15 +76415,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *479 + schema: *478 examples: default: value: @@ -73791,9 +76449,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -73821,7 +76479,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -73845,9 +76503,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -73869,8 +76527,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits parameters: + - *324 - *325 - - *326 - name: basehead description: The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their @@ -74044,8 +76702,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -74305,8 +76963,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -74389,7 +77047,7 @@ paths: - version - url additionalProperties: false - metadata: &480 + metadata: &479 title: metadata description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -74428,7 +77086,7 @@ paths: examples: - "/src/build/package-lock.json" additionalProperties: false - metadata: *480 + metadata: *479 resolved: type: object description: A collection of resolved package dependencies. @@ -74442,7 +77100,7 @@ paths: pattern: "^pkg" examples: - pkg:/npm/%40actions/http-client@1.0.11 - metadata: *480 + metadata: *479 relationship: type: string description: A notation of whether a dependency is requested @@ -74575,8 +77233,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#list-deployments parameters: + - *324 - *325 - - *326 - name: sha description: The SHA recorded at creation time. in: query @@ -74617,9 +77275,9 @@ paths: application/json: schema: type: array - items: *481 + items: *480 examples: - default: *482 + default: *481 headers: Link: *65 x-github: @@ -74685,8 +77343,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#create-a-deployment parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -74768,7 +77426,7 @@ paths: description: Response content: application/json: - schema: *481 + schema: *480 examples: simple-example: summary: Simple example @@ -74841,9 +77499,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#get-a-deployment parameters: + - *324 - *325 - - *326 - - &483 + - &482 name: deployment_id description: deployment_id parameter in: path @@ -74855,7 +77513,7 @@ paths: description: Response content: application/json: - schema: *481 + schema: *480 examples: default: value: @@ -74920,9 +77578,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#delete-a-deployment parameters: + - *324 - *325 - - *326 - - *483 + - *482 responses: '204': description: Response @@ -74944,9 +77602,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#list-deployment-statuses parameters: + - *324 - *325 - - *326 - - *483 + - *482 - *17 - *19 responses: @@ -74956,7 +77614,7 @@ paths: application/json: schema: type: array - items: &484 + items: &483 title: Deployment Status description: The status of a deployment. type: object @@ -75120,9 +77778,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#create-a-deployment-status parameters: + - *324 - *325 - - *326 - - *483 + - *482 requestBody: required: true content: @@ -75197,9 +77855,9 @@ paths: description: Response content: application/json: - schema: *484 + schema: *483 examples: - default: &485 + default: &484 value: url: https://api.github.com/repos/octocat/example/deployments/42/statuses/1 id: 1 @@ -75255,9 +77913,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#get-a-deployment-status parameters: + - *324 - *325 - - *326 - - *483 + - *482 - name: status_id in: path required: true @@ -75268,9 +77926,9 @@ paths: description: Response content: application/json: - schema: *484 + schema: *483 examples: - default: *485 + default: *484 '404': *6 x-github: githubCloudOnly: false @@ -75295,8 +77953,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#create-a-repository-dispatch-event parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -75353,8 +78011,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#list-environments parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -75372,7 +78030,7 @@ paths: - 5 environments: type: array - items: &487 + items: &486 title: Environment description: Details of a deployment environment type: object @@ -75434,7 +78092,7 @@ paths: type: string examples: - wait_timer - wait_timer: &489 + wait_timer: &488 type: integer description: The amount of time to delay a job after the job is initially triggered. The time (in minutes) @@ -75476,11 +78134,11 @@ paths: items: type: object properties: - type: *486 + type: *485 reviewer: anyOf: - *4 - - *188 + - *187 required: - id - node_id @@ -75503,7 +78161,7 @@ paths: - id - node_id - type - deployment_branch_policy: &490 + deployment_branch_policy: &489 type: - object - 'null' @@ -75620,9 +78278,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#get-an-environment parameters: + - *324 - *325 - - *326 - - &488 + - &487 name: environment_name in: path required: true @@ -75635,9 +78293,9 @@ paths: description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: &491 + default: &490 value: id: 161088068 node_id: MDExOkVudmlyb25tZW50MTYxMDg4MDY4 @@ -75721,9 +78379,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#create-or-update-an-environment parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: false content: @@ -75733,7 +78391,7 @@ paths: - object - 'null' properties: - wait_timer: *489 + wait_timer: *488 prevent_self_review: type: boolean description: Whether or not a user who created the job is prevented @@ -75752,14 +78410,14 @@ paths: items: type: object properties: - type: *486 + type: *485 id: type: integer description: The id of the user or team who can review the deployment examples: - 4532992 - deployment_branch_policy: *490 + deployment_branch_policy: *489 additionalProperties: false examples: default: @@ -75779,9 +78437,9 @@ paths: description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: *491 + default: *490 '422': description: Validation error when the environment name is invalid or when `protected_branches` and `custom_branch_policies` in `deployment_branch_policy` @@ -75805,9 +78463,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#delete-an-environment parameters: + - *324 - *325 - - *326 - - *488 + - *487 responses: '204': description: Default response @@ -75832,9 +78490,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#list-deployment-branch-policies parameters: + - *324 - *325 - - *326 - - *488 + - *487 - *17 - *19 responses: @@ -75853,7 +78511,7 @@ paths: - 2 branch_policies: type: array - items: &492 + items: &491 title: Deployment branch policy description: Details of a deployment branch or tag policy. type: object @@ -75914,9 +78572,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#create-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: true content: @@ -75964,9 +78622,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - example-wildcard: &493 + example-wildcard: &492 value: id: 364662 node_id: MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI= @@ -76008,10 +78666,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#get-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - &494 + - *487 + - &493 name: branch_policy_id in: path required: true @@ -76023,9 +78681,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - default: *493 + default: *492 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76044,10 +78702,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#update-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - *494 + - *487 + - *493 requestBody: required: true content: @@ -76076,9 +78734,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - default: *493 + default: *492 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76097,10 +78755,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#delete-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - *494 + - *487 + - *493 responses: '204': description: Response @@ -76125,9 +78783,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#get-all-deployment-protection-rules-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 responses: '200': description: List of deployment protection rules @@ -76144,7 +78802,7 @@ paths: - 10 custom_deployment_protection_rules: type: array - items: &495 + items: &494 title: Deployment protection rule description: Deployment protection rule type: object @@ -76166,7 +78824,7 @@ paths: for the environment. examples: - true - app: &496 + app: &495 title: Custom deployment protection rule app description: A GitHub App that is providing a custom deployment protection rule. @@ -76269,9 +78927,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#create-a-custom-deployment-protection-rule-on-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 requestBody: content: application/json: @@ -76292,9 +78950,9 @@ paths: description: The enabled custom deployment protection rule content: application/json: - schema: *495 + schema: *494 examples: - default: &497 + default: &496 value: id: 3 node_id: IEH37kRlcGxveW1lbnRTdGF0ddiv @@ -76329,9 +78987,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#list-custom-deployment-rule-integrations-available-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 - *19 - *17 responses: @@ -76351,7 +79009,7 @@ paths: - 35 available_custom_deployment_protection_rule_integrations: type: array - items: *496 + items: *495 examples: default: value: @@ -76386,10 +79044,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#get-a-custom-deployment-protection-rule parameters: + - *324 - *325 - - *326 - - *488 - - &498 + - *487 + - &497 name: protection_rule_id description: The unique identifier of the protection rule. in: path @@ -76401,9 +79059,9 @@ paths: description: Response content: application/json: - schema: *495 + schema: *494 examples: - default: *497 + default: *496 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76424,10 +79082,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#disable-a-custom-protection-rule-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 - - *498 + - *324 + - *497 responses: '204': description: Response @@ -76453,9 +79111,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-environment-secrets parameters: + - *324 - *325 - - *326 - - *488 + - *487 - *17 - *19 responses: @@ -76473,9 +79131,9 @@ paths: type: integer secrets: type: array - items: *370 + items: *369 examples: - default: *371 + default: *370 headers: Link: *65 x-github: @@ -76500,17 +79158,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-an-environment-public-key parameters: + - *324 - *325 - - *326 - - *488 + - *487 responses: '200': description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76532,18 +79190,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 responses: '200': description: Response content: application/json: - schema: *370 + schema: *369 examples: - default: *499 + default: *498 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76565,10 +79223,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#create-or-update-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 requestBody: required: true content: @@ -76599,7 +79257,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -76625,10 +79283,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#delete-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 responses: '204': description: Default response @@ -76653,10 +79311,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-environment-variables parameters: + - *324 - *325 - - *326 - - *488 - - *341 + - *487 + - *340 - *19 responses: '200': @@ -76673,9 +79331,9 @@ paths: type: integer variables: type: array - items: *374 + items: *373 examples: - default: *375 + default: *374 headers: Link: *65 x-github: @@ -76698,9 +79356,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#create-an-environment-variable parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: true content: @@ -76727,7 +79385,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -76752,18 +79410,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#get-an-environment-variable parameters: + - *324 - *325 - - *326 - - *488 - - *164 + - *487 + - *163 responses: '200': description: Response content: application/json: - schema: *374 + schema: *373 examples: - default: *500 + default: *499 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76784,10 +79442,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#update-an-environment-variable parameters: + - *324 - *325 - - *326 - - *164 - - *488 + - *163 + - *487 requestBody: required: true content: @@ -76829,10 +79487,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#delete-an-environment-variable parameters: + - *324 - *325 - - *326 - - *164 - - *488 + - *163 + - *487 responses: '204': description: Response @@ -76854,8 +79512,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/events#list-repository-events parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -76923,8 +79581,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/forks#list-forks parameters: + - *324 - *325 - - *326 - name: sort description: The sort order. `stargazers` will sort by star count. in: query @@ -76946,7 +79604,7 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: default: value: @@ -77083,8 +79741,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/forks#create-a-fork parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -77117,9 +79775,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 '400': *14 '422': *15 '403': *27 @@ -77140,8 +79798,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/blobs#create-a-blob parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77201,7 +79859,7 @@ paths: schema: oneOf: - *121 - - *501 + - *500 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77226,8 +79884,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/blobs#get-a-blob parameters: + - *324 - *325 - - *326 - name: file_sha in: path required: true @@ -77327,8 +79985,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/commits#create-a-commit parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77437,7 +80095,7 @@ paths: description: Response content: application/json: - schema: &502 + schema: &501 title: Git Commit description: Low-level Git commit operations within a repository type: object @@ -77664,15 +80322,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/commits#get-a-commit-object parameters: + - *324 - *325 - - *326 - - *457 + - *456 responses: '200': description: Response content: application/json: - schema: *502 + schema: *501 examples: default: value: @@ -77728,9 +80386,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#list-matching-references parameters: + - *324 - *325 - - *326 - - &503 + - &502 name: ref description: The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. @@ -77747,7 +80405,7 @@ paths: application/json: schema: type: array - items: &504 + items: &503 title: Git Reference description: Git references within a repository type: object @@ -77823,17 +80481,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#get-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 responses: '200': description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: &505 + default: &504 value: ref: refs/heads/featureA node_id: MDM6UmVmcmVmcy9oZWFkcy9mZWF0dXJlQQ== @@ -77862,8 +80520,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#create-a-reference parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77892,9 +80550,9 @@ paths: description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: *505 + default: *504 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA @@ -77920,9 +80578,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#update-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 requestBody: required: true content: @@ -77951,9 +80609,9 @@ paths: description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: *505 + default: *504 '422': *15 '409': *52 x-github: @@ -77971,9 +80629,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#delete-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 responses: '204': description: Response @@ -78028,8 +80686,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/tags#create-a-tag-object parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -78096,7 +80754,7 @@ paths: description: Response content: application/json: - schema: &507 + schema: &506 title: Git Tag description: Metadata for a Git tag type: object @@ -78152,7 +80810,7 @@ paths: - sha - type - url - verification: *506 + verification: *505 required: - sha - url @@ -78162,7 +80820,7 @@ paths: - tag - message examples: - default: &508 + default: &507 value: node_id: MDM6VGFnOTQwYmQzMzYyNDhlZmFlMGY5ZWU1YmM3YjJkNWM5ODU4ODdiMTZhYw== tag: v0.0.1 @@ -78235,8 +80893,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/tags#get-a-tag parameters: + - *324 - *325 - - *326 - name: tag_sha in: path required: true @@ -78247,9 +80905,9 @@ paths: description: Response content: application/json: - schema: *507 + schema: *506 examples: - default: *508 + default: *507 '404': *6 '409': *52 x-github: @@ -78273,8 +80931,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/trees#create-a-tree parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -78348,7 +81006,7 @@ paths: description: Response content: application/json: - schema: &509 + schema: &508 title: Git Tree description: The hierarchy between files in a Git repository. type: object @@ -78450,8 +81108,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/trees#get-a-tree parameters: + - *324 - *325 - - *326 - name: tree_sha description: The SHA1 value or ref (branch or tag) name of the tree. in: path @@ -78474,7 +81132,7 @@ paths: description: Response content: application/json: - schema: *509 + schema: *508 examples: default-response: summary: Default response @@ -78533,8 +81191,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#list-repository-webhooks parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -78544,7 +81202,7 @@ paths: application/json: schema: type: array - items: &510 + items: &509 title: Webhook description: Webhooks for repositories. type: object @@ -78607,7 +81265,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/hooks/1/deliveries - last_response: &742 + last_response: &741 title: Hook Response type: object properties: @@ -78684,8 +81342,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#create-a-repository-webhook parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -78738,9 +81396,9 @@ paths: description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: &511 + default: &510 value: type: Repository id: 12345678 @@ -78788,17 +81446,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '200': description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: *511 + default: *510 '404': *6 x-github: githubCloudOnly: false @@ -78818,9 +81476,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#update-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 requestBody: required: true content: @@ -78865,9 +81523,9 @@ paths: description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: *511 + default: *510 '422': *15 '404': *6 x-github: @@ -78888,9 +81546,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#delete-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -78914,9 +81572,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-webhook-configuration-for-a-repository parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '200': description: Response @@ -78943,9 +81601,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#update-a-webhook-configuration-for-a-repository parameters: + - *324 - *325 - - *326 - - *203 + - *202 requestBody: required: false content: @@ -78989,12 +81647,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#list-deliveries-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *17 + - *203 - *204 - - *205 responses: '200': description: Response @@ -79002,9 +81660,9 @@ paths: application/json: schema: type: array - items: *206 + items: *205 examples: - default: *207 + default: *206 '400': *14 '422': *15 x-github: @@ -79023,18 +81681,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-delivery-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *16 responses: '200': description: Response content: application/json: - schema: *208 + schema: *207 examples: - default: *209 + default: *208 '400': *14 '422': *15 x-github: @@ -79053,9 +81711,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#redeliver-a-delivery-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *16 responses: '202': *37 @@ -79078,9 +81736,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#ping-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -79105,9 +81763,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#test-the-push-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -79130,8 +81788,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-immutable-releases-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response if immutable releases are enabled @@ -79179,10 +81837,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-immutable-releases parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '409': *52 x-github: githubCloudOnly: false @@ -79200,10 +81858,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-immutable-releases parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '409': *52 x-github: githubCloudOnly: false @@ -79258,14 +81916,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-an-import-status parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &512 + schema: &511 title: Import description: A repository import from an external source. type: object @@ -79372,7 +82030,7 @@ paths: - html_url - authors_url examples: - default: &515 + default: &514 value: vcs: subversion use_lfs: true @@ -79388,7 +82046,7 @@ paths: authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm '404': *6 - '503': &513 + '503': &512 description: Unavailable due to service under maintenance. content: application/json: @@ -79417,8 +82075,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#start-an-import parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -79466,7 +82124,7 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: default: value: @@ -79491,7 +82149,7 @@ paths: type: string '422': *15 '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79519,8 +82177,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#update-an-import parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -79572,7 +82230,7 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: example-1: summary: Example 1 @@ -79620,7 +82278,7 @@ paths: html_url: https://import.github.com/octocat/socm/import authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79643,12 +82301,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#cancel-an-import parameters: + - *324 - *325 - - *326 responses: '204': description: Response - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79674,9 +82332,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-commit-authors parameters: + - *324 - *325 - - *326 - - &676 + - &675 name: since description: A user ID. Only return users with an ID greater than this ID. in: query @@ -79690,7 +82348,7 @@ paths: application/json: schema: type: array - items: &514 + items: &513 title: Porter Author description: Porter Author type: object @@ -79744,7 +82402,7 @@ paths: url: https://api.github.com/repos/octocat/socm/import/authors/2268559 import_url: https://api.github.com/repos/octocat/socm/import '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79769,8 +82427,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#map-a-commit-author parameters: + - *324 - *325 - - *326 - name: author_id in: path required: true @@ -79800,7 +82458,7 @@ paths: description: Response content: application/json: - schema: *514 + schema: *513 examples: default: value: @@ -79813,7 +82471,7 @@ paths: import_url: https://api.github.com/repos/octocat/socm/import '422': *15 '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79837,8 +82495,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-large-files parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -79879,7 +82537,7 @@ paths: path: foo/bar/3 oid: c20ad4d76fe97759aa27a0c99bff6710 size: 12582912 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79907,8 +82565,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#update-git-lfs-preference parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -79935,11 +82593,11 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: - default: *515 + default: *514 '422': *15 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79962,8 +82620,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/apps/apps#get-a-repository-installation-for-the-authenticated-app parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -79971,8 +82629,8 @@ paths: application/json: schema: *20 examples: - default: *516 - '301': *329 + default: *515 + '301': *328 '404': *6 x-github: githubCloudOnly: false @@ -79992,8 +82650,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#get-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -80001,12 +82659,12 @@ paths: application/json: schema: anyOf: - - *222 + - *221 - type: object properties: {} additionalProperties: false examples: - default: &518 + default: &517 value: limit: collaborators_only origin: repository @@ -80031,13 +82689,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#set-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *517 + schema: *516 examples: default: summary: Example request body @@ -80049,9 +82707,9 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: - default: *518 + default: *517 '409': description: Response x-github: @@ -80073,8 +82731,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#remove-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -80097,8 +82755,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#list-repository-invitations parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -80108,9 +82766,9 @@ paths: application/json: schema: type: array - items: *519 + items: *518 examples: - default: &669 + default: &668 value: - id: 1 repository: @@ -80241,9 +82899,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#update-a-repository-invitation parameters: + - *324 - *325 - - *326 - - *226 + - *225 requestBody: required: false content: @@ -80272,7 +82930,7 @@ paths: description: Response content: application/json: - schema: *519 + schema: *518 examples: default: value: @@ -80403,9 +83061,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#delete-a-repository-invitation parameters: + - *324 - *325 - - *326 - - *226 + - *225 responses: '204': description: Response @@ -80436,8 +83094,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#list-repository-issues parameters: + - *324 - *325 - - *326 - name: milestone description: If an `integer` is passed, it should refer to a milestone by its `number` field. If the string `*` is passed, issues with any milestone @@ -80485,7 +83143,7 @@ paths: required: false schema: type: string - - *233 + - *232 - name: sort description: What to sort results by. in: query @@ -80510,7 +83168,7 @@ paths: type: array items: *81 examples: - default: &528 + default: &527 value: - id: 1 node_id: MDU6SXNzdWUx @@ -80659,7 +83317,7 @@ paths: state_reason: completed headers: Link: *65 - '301': *329 + '301': *328 '422': *15 '404': *6 x-github: @@ -80688,8 +83346,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#create-an-issue parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -80781,7 +83439,7 @@ paths: application/json: schema: *81 examples: - default: &525 + default: &524 value: id: 1 node_id: MDU6SXNzdWUx @@ -80938,7 +83596,7 @@ paths: '422': *15 '503': *113 '404': *6 - '410': *520 + '410': *519 x-github: triggersNotification: true githubCloudOnly: false @@ -80966,8 +83624,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#list-issue-comments-for-a-repository parameters: + - *324 - *325 - - *326 - *103 - name: direction description: Either `asc` or `desc`. Ignored without the `sort` parameter. @@ -80990,7 +83648,7 @@ paths: type: array items: *82 examples: - default: &527 + default: &526 value: - id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -81048,8 +83706,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#get-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': @@ -81058,7 +83716,7 @@ paths: application/json: schema: *82 examples: - default: &521 + default: &520 value: id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -81113,8 +83771,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#update-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -81139,7 +83797,7 @@ paths: application/json: schema: *82 examples: - default: *521 + default: *520 '422': *15 x-github: githubCloudOnly: false @@ -81157,8 +83815,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#delete-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -81187,8 +83845,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#pin-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': @@ -81251,7 +83909,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -81268,8 +83926,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#unpin-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -81277,7 +83935,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 '503': *113 x-github: githubCloudOnly: false @@ -81295,8 +83953,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -81323,9 +83981,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -81346,8 +84004,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -81380,16 +84038,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -81411,10 +84069,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-an-issue-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - *523 + - *522 responses: '204': description: Response @@ -81434,8 +84092,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#list-issue-events-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -81445,7 +84103,7 @@ paths: application/json: schema: type: array - items: &524 + items: &523 title: Issue Event description: Issue Event type: object @@ -81525,7 +84183,7 @@ paths: anyOf: - type: 'null' - *4 - requested_team: *188 + requested_team: *187 dismissed_review: title: Issue Event Dismissed Review type: object @@ -81785,8 +84443,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#get-an-issue-event parameters: + - *324 - *325 - - *326 - name: event_id in: path required: true @@ -81797,7 +84455,7 @@ paths: description: Response content: application/json: - schema: *524 + schema: *523 examples: default: value: @@ -81990,7 +84648,7 @@ paths: author_association: COLLABORATOR state_reason: completed '404': *6 - '410': *520 + '410': *519 '403': *27 x-github: githubCloudOnly: false @@ -82024,9 +84682,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#get-an-issue parameters: + - *324 - *325 - - *326 - - &526 + - &525 name: issue_number description: The number that identifies the issue. in: path @@ -82042,7 +84700,7 @@ paths: examples: default: summary: Issue - value: *525 + value: *524 pinned_comment: summary: Issue with pinned comment value: @@ -82241,9 +84899,9 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 '304': *35 x-github: githubCloudOnly: false @@ -82268,9 +84926,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#update-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -82411,13 +85069,13 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 '422': *15 '503': *113 '403': *27 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82435,9 +85093,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#add-assignees-to-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -82465,7 +85123,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82481,9 +85139,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#remove-assignees-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: content: application/json: @@ -82510,7 +85168,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82532,9 +85190,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#check-if-a-user-can-be-assigned-to-a-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: assignee in: path required: true @@ -82574,9 +85232,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#list-issue-comments parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *86 - *17 - *19 @@ -82589,11 +85247,11 @@ paths: type: array items: *82 examples: - default: *527 + default: *526 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82622,9 +85280,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#create-an-issue-comment parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -82648,14 +85306,14 @@ paths: application/json: schema: *82 examples: - default: *521 + default: *520 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/comments/1 schema: type: string '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -82683,9 +85341,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -82697,12 +85355,12 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82730,9 +85388,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#add-a-dependency-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -82756,15 +85414,15 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/dependencies/blocked_by schema: type: string - '301': *329 + '301': *328 '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -82795,9 +85453,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#remove-dependency-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: issue_id in: path description: The id of the blocking issue to remove as a dependency @@ -82811,13 +85469,13 @@ paths: application/json: schema: *81 examples: - default: *525 - '301': *329 + default: *524 + '301': *328 '400': *14 '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 x-github: triggersNotification: true githubCloudOnly: false @@ -82843,9 +85501,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocking parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -82857,12 +85515,12 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82879,9 +85537,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#list-issue-events parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -82895,7 +85553,7 @@ paths: title: Issue Event for Issue description: Issue Event for Issue anyOf: - - &531 + - &530 title: Labeled Issue Event description: Labeled Issue Event type: object @@ -82944,7 +85602,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &532 + - &531 title: Unlabeled Issue Event description: Unlabeled Issue Event type: object @@ -83072,7 +85730,7 @@ paths: - performed_via_github_app - assignee - assigner - - &533 + - &532 title: Milestoned Issue Event description: Milestoned Issue Event type: object @@ -83118,7 +85776,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &534 + - &533 title: Demilestoned Issue Event description: Demilestoned Issue Event type: object @@ -83164,7 +85822,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &535 + - &534 title: Renamed Issue Event description: Renamed Issue Event type: object @@ -83213,7 +85871,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &536 + - &535 title: Review Requested Issue Event description: Review Requested Issue Event type: object @@ -83242,7 +85900,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *188 + requested_team: *187 requested_reviewer: *4 required: - review_requester @@ -83255,7 +85913,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &537 + - &536 title: Review Request Removed Issue Event description: Review Request Removed Issue Event type: object @@ -83284,7 +85942,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *188 + requested_team: *187 requested_reviewer: *4 required: - review_requester @@ -83297,7 +85955,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &538 + - &537 title: Review Dismissed Issue Event description: Review Dismissed Issue Event type: object @@ -83353,7 +86011,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &539 + - &538 title: Locked Issue Event description: Locked Issue Event type: object @@ -83398,7 +86056,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &540 + - &539 title: Added to Project Issue Event description: Added to Project Issue Event type: object @@ -83459,7 +86117,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &541 + - &540 title: Moved Column in Project Issue Event description: Moved Column in Project Issue Event type: object @@ -83520,7 +86178,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &542 + - &541 title: Removed from Project Issue Event description: Removed from Project Issue Event type: object @@ -83581,7 +86239,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &543 + - &542 title: Converted Note to Issue Issue Event description: Converted Note to Issue Issue Event type: object @@ -83674,7 +86332,7 @@ paths: color: red headers: Link: *65 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83691,9 +86349,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#list-issue-field-values-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83703,9 +86361,9 @@ paths: application/json: schema: type: array - items: *529 + items: *528 examples: - default: &640 + default: &639 value: - issue_field_id: 1 node_id: IFT_GDKND @@ -83729,9 +86387,9 @@ paths: value: '2025-12-25' headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83748,9 +86406,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83762,7 +86420,7 @@ paths: type: array items: *80 examples: - default: &530 + default: &529 value: - id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -83780,9 +86438,9 @@ paths: default: false headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83798,9 +86456,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#add-labels-to-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83845,10 +86503,10 @@ paths: type: array items: *80 examples: - default: *530 - '301': *329 + default: *529 + '301': *328 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -83865,9 +86523,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#set-labels-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83929,10 +86587,10 @@ paths: type: array items: *80 examples: - default: *530 - '301': *329 + default: *529 + '301': *328 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -83949,15 +86607,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#remove-all-labels-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '204': description: Response - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83976,9 +86634,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#remove-a-label-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: name in: path required: true @@ -84002,9 +86660,9 @@ paths: description: Something isn't working color: f29513 default: true - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84024,9 +86682,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#lock-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -84055,7 +86713,7 @@ paths: '204': description: Response '403': *27 - '410': *520 + '410': *519 '404': *6 '422': *15 x-github: @@ -84073,9 +86731,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#unlock-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '204': description: Response @@ -84105,9 +86763,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#get-parent-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '200': description: Response @@ -84115,10 +86773,10 @@ paths: application/json: schema: *81 examples: - default: *525 - '301': *329 + default: *524 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84135,9 +86793,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue. @@ -84163,13 +86821,13 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84187,9 +86845,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84221,16 +86879,16 @@ paths: description: Response content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Response content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -84252,10 +86910,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-an-issue-reaction parameters: + - *324 - *325 - - *326 - - *526 - - *523 + - *525 + - *522 responses: '204': description: Response @@ -84284,9 +86942,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#remove-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84310,7 +86968,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/sub-issue @@ -84343,9 +87001,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#list-sub-issues parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -84357,11 +87015,11 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84389,9 +87047,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#add-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84420,14 +87078,14 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/sub-issues/1 schema: type: string '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -84447,9 +87105,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#reprioritize-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84482,7 +87140,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 '403': *27 '404': *6 '422': *7 @@ -84504,9 +87162,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/timeline#list-timeline-events-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -84521,6 +87179,7 @@ paths: description: Timeline Event type: object anyOf: + - *530 - *531 - *532 - *533 @@ -84533,7 +87192,6 @@ paths: - *540 - *541 - *542 - - *543 - title: Timeline Comment Event description: Timeline Comment Event type: object @@ -84590,7 +87248,7 @@ paths: pin: anyOf: - type: 'null' - - *544 + - *543 required: - event - actor @@ -84866,7 +87524,7 @@ paths: type: string comments: type: array - items: &563 + items: &562 title: Pull Request Review Comment description: Pull Request Review Comments are comments on a portion of the Pull Request's diff. @@ -85107,7 +87765,7 @@ paths: type: string comments: type: array - items: *453 + items: *452 - title: Timeline Assigned Issue Event description: Timeline Assigned Issue Event type: object @@ -85382,7 +88040,7 @@ paths: headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85399,8 +88057,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#list-deploy-keys parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -85410,7 +88068,7 @@ paths: application/json: schema: type: array - items: &545 + items: &544 title: Deploy Key description: An SSH key granting access to a single repository. type: object @@ -85478,8 +88136,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#create-a-deploy-key parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85515,9 +88173,9 @@ paths: description: Response content: application/json: - schema: *545 + schema: *544 examples: - default: &546 + default: &545 value: id: 1 key: ssh-rsa AAA... @@ -85551,9 +88209,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#get-a-deploy-key parameters: + - *324 - *325 - - *326 - - &547 + - &546 name: key_id description: The unique identifier of the key. in: path @@ -85565,9 +88223,9 @@ paths: description: Response content: application/json: - schema: *545 + schema: *544 examples: - default: *546 + default: *545 '404': *6 x-github: githubCloudOnly: false @@ -85585,9 +88243,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#delete-a-deploy-key parameters: + - *324 - *325 - - *326 - - *547 + - *546 responses: '204': description: Response @@ -85607,8 +88265,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -85620,7 +88278,7 @@ paths: type: array items: *80 examples: - default: *530 + default: *529 headers: Link: *65 '404': *6 @@ -85641,8 +88299,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#create-a-label parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85680,7 +88338,7 @@ paths: application/json: schema: *80 examples: - default: &548 + default: &547 value: id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -85712,8 +88370,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#get-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -85726,7 +88384,7 @@ paths: application/json: schema: *80 examples: - default: *548 + default: *547 '404': *6 x-github: githubCloudOnly: false @@ -85743,8 +88401,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#update-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -85809,8 +88467,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#delete-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -85836,8 +88494,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-languages parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -85876,9 +88534,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/licenses/licenses#get-the-license-for-a-repository parameters: + - *324 - *325 - - *326 - - *428 + - *427 responses: '200': description: Response @@ -86025,8 +88683,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86091,8 +88749,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#merge-a-branch parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86126,9 +88784,9 @@ paths: description: Successful Response (The resulting merge commit) content: application/json: - schema: *456 + schema: *455 examples: - default: *549 + default: *548 '204': description: Response when already merged '404': @@ -86153,8 +88811,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#list-milestones parameters: + - *324 - *325 - - *326 - name: state description: The state of the milestone. Either `open`, `closed`, or `all`. in: query @@ -86195,7 +88853,7 @@ paths: application/json: schema: type: array - items: *266 + items: *265 examples: default: value: @@ -86251,8 +88909,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#create-a-milestone parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86292,9 +88950,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: &550 + default: &549 value: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -86353,9 +89011,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#get-a-milestone parameters: + - *324 - *325 - - *326 - - &551 + - &550 name: milestone_number description: The number that identifies the milestone. in: path @@ -86367,9 +89025,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: *550 + default: *549 '404': *6 x-github: githubCloudOnly: false @@ -86386,9 +89044,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#update-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 requestBody: required: false content: @@ -86426,9 +89084,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: *550 + default: *549 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -86444,9 +89102,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#delete-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 responses: '204': description: Response @@ -86467,9 +89125,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-issues-in-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 - *17 - *19 responses: @@ -86481,7 +89139,7 @@ paths: type: array items: *80 examples: - default: *530 + default: *529 headers: Link: *65 x-github: @@ -86500,12 +89158,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#list-repository-notifications-for-the-authenticated-user parameters: + - *324 - *325 - - *326 + - *551 - *552 - - *553 - *86 - - *554 + - *553 - *17 - *19 responses: @@ -86517,7 +89175,7 @@ paths: type: array items: *106 examples: - default: *555 + default: *554 headers: Link: *65 x-github: @@ -86541,8 +89199,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#mark-repository-notifications-as-read parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -86600,14 +89258,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-a-apiname-pages-site parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &556 + schema: &555 title: GitHub Pages description: The configuration for GitHub Pages for a repository. type: object @@ -86751,7 +89409,7 @@ paths: - custom_404 - public examples: - default: &557 + default: &556 value: url: https://api.github.com/repos/github/developer.github.com/pages status: built @@ -86792,8 +89450,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#create-a-apiname-pages-site parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86848,9 +89506,9 @@ paths: description: Response content: application/json: - schema: *556 + schema: *555 examples: - default: *557 + default: *556 '422': *15 '409': *52 x-github: @@ -86873,8 +89531,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#update-information-about-a-apiname-pages-site parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86974,8 +89632,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#delete-a-apiname-pages-site parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -87001,8 +89659,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#list-apiname-pages-builds parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -87012,7 +89670,7 @@ paths: application/json: schema: type: array - items: &558 + items: &557 title: Page Build description: Page Build type: object @@ -87104,8 +89762,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#request-a-apiname-pages-build parameters: + - *324 - *325 - - *326 responses: '201': description: Response @@ -87152,16 +89810,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-latest-pages-build parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *558 + schema: *557 examples: - default: &559 + default: &558 value: url: https://api.github.com/repos/github/developer.github.com/pages/builds/5472601 status: built @@ -87209,8 +89867,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-apiname-pages-build parameters: + - *324 - *325 - - *326 - name: build_id in: path required: true @@ -87221,9 +89879,9 @@ paths: description: Response content: application/json: - schema: *558 + schema: *557 examples: - default: *559 + default: *558 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -87243,8 +89901,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#create-a-github-pages-deployment parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -87352,9 +90010,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-the-status-of-a-github-pages-deployment parameters: + - *324 - *325 - - *326 - - &560 + - &559 name: pages_deployment_id description: The ID of the Pages deployment. You can also give the commit SHA of the deployment. @@ -87412,11 +90070,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#cancel-a-github-pages-deployment parameters: + - *324 - *325 - - *326 - - *560 + - *559 responses: - '204': *184 + '204': *183 '404': *6 x-github: githubCloudOnly: false @@ -87441,8 +90099,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-a-dns-health-check-for-github-pages parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -87710,7 +90368,7 @@ paths: description: Empty response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -87737,8 +90395,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-private-vulnerability-reporting-is-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Private vulnerability reporting status @@ -87775,10 +90433,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-private-vulnerability-reporting-for-a-repository parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '422': *14 x-github: githubCloudOnly: false @@ -87797,10 +90455,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-private-vulnerability-reporting-for-a-repository parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '422': *14 x-github: githubCloudOnly: false @@ -87820,8 +90478,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/custom-properties#get-all-custom-property-values-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -87829,7 +90487,7 @@ paths: application/json: schema: type: array - items: *280 + items: *279 examples: default: value: @@ -87860,8 +90518,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/custom-properties#create-or-update-custom-property-values-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -87873,7 +90531,7 @@ paths: type: array description: A list of custom property names and associated values to apply to the repositories. - items: *280 + items: *279 required: - properties examples: @@ -87923,8 +90581,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-pull-requests parameters: + - *324 - *325 - - *326 - name: state description: Either `open`, `closed`, or `all` to filter by state. in: query @@ -87984,9 +90642,9 @@ paths: application/json: schema: type: array - items: *460 + items: *459 examples: - default: *561 + default: *560 headers: Link: *65 '304': *35 @@ -88018,8 +90676,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#create-a-pull-request parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -88086,7 +90744,7 @@ paths: description: Response content: application/json: - schema: &565 + schema: &564 type: object title: Pull Request description: Pull requests let you tell others about changes you've @@ -88215,7 +90873,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 active_lock_reason: type: - string @@ -88264,7 +90922,7 @@ paths: items: *4 requested_teams: type: array - items: *245 + items: *244 head: type: object properties: @@ -88302,14 +90960,14 @@ paths: _links: type: object properties: - comments: *267 - commits: *267 - statuses: *267 - html: *267 - issue: *267 - review_comments: *267 - review_comment: *267 - self: *267 + comments: *266 + commits: *266 + statuses: *266 + html: *266 + issue: *266 + review_comments: *266 + review_comment: *266 + self: *266 required: - comments - commits @@ -88320,7 +90978,7 @@ paths: - review_comment - self author_association: *78 - auto_merge: *562 + auto_merge: *561 draft: description: Indicates whether or not the pull request is a draft. type: boolean @@ -88422,7 +91080,7 @@ paths: - merged_by - review_comments examples: - default: &566 + default: &565 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -88949,8 +91607,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository parameters: + - *324 - *325 - - *326 - name: sort in: query required: false @@ -88979,9 +91637,9 @@ paths: application/json: schema: type: array - items: *563 + items: *562 examples: - default: &568 + default: &567 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -89058,17 +91716,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 responses: '200': description: Response content: application/json: - schema: *563 + schema: *562 examples: - default: &564 + default: &563 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -89143,8 +91801,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -89167,9 +91825,9 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: - default: *564 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -89185,8 +91843,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -89208,8 +91866,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-pull-request-review-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -89236,9 +91894,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -89259,8 +91917,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-pull-request-review-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -89293,16 +91951,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -89324,10 +91982,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-pull-request-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - *523 + - *522 responses: '204': description: Response @@ -89370,9 +92028,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#get-a-pull-request parameters: + - *324 - *325 - - *326 - - &567 + - &566 name: pull_number description: The number that identifies the pull request. in: path @@ -89385,9 +92043,9 @@ paths: to fetch diff and patch formats. content: application/json: - schema: *565 + schema: *564 examples: - default: *566 + default: *565 '304': *35 '404': *6 '406': @@ -89422,9 +92080,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#update-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -89466,9 +92124,9 @@ paths: description: Response content: application/json: - schema: *565 + schema: *564 examples: - default: *566 + default: *565 '422': *15 '403': *27 x-github: @@ -89490,9 +92148,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-codespace-from-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -89553,17 +92211,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -89593,9 +92251,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *103 - name: direction description: The direction to sort results. Ignored without `sort` parameter. @@ -89616,9 +92274,9 @@ paths: application/json: schema: type: array - items: *563 + items: *562 examples: - default: *568 + default: *567 headers: Link: *65 x-github: @@ -89651,9 +92309,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -89759,7 +92417,7 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: example-for-a-multi-line-comment: value: @@ -89847,9 +92505,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *95 requestBody: required: true @@ -89872,7 +92530,7 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: default: value: @@ -89958,9 +92616,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -89970,9 +92628,9 @@ paths: application/json: schema: type: array - items: *456 + items: *455 examples: - default: *569 + default: *568 headers: Link: *65 x-github: @@ -90002,9 +92660,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -90014,7 +92672,7 @@ paths: application/json: schema: type: array - items: *467 + items: *466 examples: default: value: @@ -90052,9 +92710,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged parameters: + - *324 - *325 - - *326 - - *567 + - *566 responses: '204': description: Response if pull request has been merged @@ -90077,9 +92735,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -90191,9 +92849,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 responses: '200': description: Response @@ -90209,7 +92867,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 required: - users - teams @@ -90268,9 +92926,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -90307,7 +92965,7 @@ paths: description: Response content: application/json: - schema: *460 + schema: *459 examples: default: value: @@ -90843,9 +93501,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -90879,7 +93537,7 @@ paths: description: Response content: application/json: - schema: *460 + schema: *459 examples: default: value: @@ -91384,9 +94042,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -91396,7 +94054,7 @@ paths: application/json: schema: type: array - items: &570 + items: &569 title: Pull Request Review description: Pull Request Reviews are reviews on pull requests. type: object @@ -91552,9 +94210,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -91644,9 +94302,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: &572 + default: &571 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -91709,10 +94367,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - &571 + - *566 + - &570 name: review_id description: The unique identifier of the review. in: path @@ -91724,9 +94382,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: &573 + default: &572 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -91785,10 +94443,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -91811,7 +94469,7 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: default: value: @@ -91873,18 +94531,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 responses: '200': description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: *572 + default: *571 '422': *7 '404': *6 x-github: @@ -91911,10 +94569,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 - *17 - *19 responses: @@ -92012,9 +94670,9 @@ paths: _links: type: object properties: - self: *267 - html: *267 - pull_request: *267 + self: *266 + html: *266 + pull_request: *266 required: - self - html @@ -92172,10 +94830,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -92204,7 +94862,7 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: default: value: @@ -92267,10 +94925,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -92305,9 +94963,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: *573 + default: *572 '404': *6 '422': *7 '403': *27 @@ -92329,9 +94987,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -92395,8 +95053,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-a-repository-readme parameters: + - *324 - *325 - - *326 - name: ref description: 'The name of the commit/branch/tag. Default: the repository’s default branch.' @@ -92409,9 +95067,9 @@ paths: description: Response content: application/json: - schema: *574 + schema: *573 examples: - default: &575 + default: &574 value: type: file encoding: base64 @@ -92453,8 +95111,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-a-repository-readme-for-a-directory parameters: + - *324 - *325 - - *326 - name: dir description: The alternate path to look for a README file in: path @@ -92474,9 +95132,9 @@ paths: description: Response content: application/json: - schema: *574 + schema: *573 examples: - default: *575 + default: *574 '404': *6 '422': *15 x-github: @@ -92498,8 +95156,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#list-releases parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -92509,7 +95167,7 @@ paths: application/json: schema: type: array - items: *576 + items: *575 examples: default: value: @@ -92603,8 +95261,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#create-a-release parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -92680,9 +95338,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: &580 + default: &579 value: url: https://api.github.com/repos/octocat/Hello-World/releases/1 html_url: https://github.com/octocat/Hello-World/releases/v1.0.0 @@ -92787,9 +95445,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#get-a-release-asset parameters: + - *324 - *325 - - *326 - - &578 + - &577 name: asset_id description: The unique identifier of the asset. in: path @@ -92801,9 +95459,9 @@ paths: description: Response content: application/json: - schema: *577 + schema: *576 examples: - default: &579 + default: &578 value: url: https://api.github.com/repos/octocat/Hello-World/releases/assets/1 browser_download_url: https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip @@ -92838,7 +95496,7 @@ paths: type: User site_admin: false '404': *6 - '302': *469 + '302': *468 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -92854,9 +95512,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#update-a-release-asset parameters: + - *324 - *325 - - *326 - - *578 + - *577 requestBody: required: false content: @@ -92885,9 +95543,9 @@ paths: description: Response content: application/json: - schema: *577 + schema: *576 examples: - default: *579 + default: *578 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -92903,9 +95561,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#delete-a-release-asset parameters: + - *324 - *325 - - *326 - - *578 + - *577 responses: '204': description: Response @@ -92930,8 +95588,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#generate-release-notes-content-for-a-release parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -93017,16 +95675,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-the-latest-release parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': *6 x-github: githubCloudOnly: false @@ -93044,8 +95702,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-a-release-by-tag-name parameters: + - *324 - *325 - - *326 - name: tag description: tag parameter in: path @@ -93058,9 +95716,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': *6 x-github: githubCloudOnly: false @@ -93082,9 +95740,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-a-release parameters: + - *324 - *325 - - *326 - - &581 + - &580 name: release_id description: The unique identifier of the release. in: path @@ -93098,9 +95756,9 @@ paths: For more information, see "[Getting started with the REST API](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia)."' content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '401': description: Unauthorized x-github: @@ -93118,9 +95776,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#update-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 requestBody: required: false content: @@ -93184,9 +95842,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': description: Not Found if the discussion category name is invalid content: @@ -93207,9 +95865,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#delete-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 responses: '204': description: Response @@ -93230,9 +95888,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#list-release-assets parameters: + - *324 - *325 - - *326 - - *581 + - *580 - *17 - *19 responses: @@ -93242,7 +95900,7 @@ paths: application/json: schema: type: array - items: *577 + items: *576 examples: default: value: @@ -93323,9 +95981,9 @@ paths: description: The URL origin (protocol + host name + port) is included in `upload_url` returned in the response of the "Create a release" endpoint parameters: + - *324 - *325 - - *326 - - *581 + - *580 - name: name in: query required: true @@ -93351,7 +96009,7 @@ paths: description: Response for successful upload content: application/json: - schema: *577 + schema: *576 examples: response-for-successful-upload: value: @@ -93406,9 +96064,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a release. @@ -93432,9 +96090,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -93455,9 +96113,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 requestBody: required: true content: @@ -93487,16 +96145,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -93518,10 +96176,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-release-reaction parameters: + - *324 - *325 - - *326 - - *581 - - *523 + - *580 + - *522 responses: '204': description: Response @@ -93545,9 +96203,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-rules-for-a-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 - *17 - *19 responses: @@ -93563,8 +96221,8 @@ paths: description: A repository rule with ruleset details. oneOf: - allOf: - - *287 - - &582 + - *286 + - &581 title: repository ruleset data for rule description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -93583,69 +96241,69 @@ paths: ruleset_id: type: integer description: The ID of the ruleset that includes this rule. + - allOf: + - *287 + - *581 - allOf: - *288 - - *582 + - *581 - allOf: - *289 - - *582 + - *581 - allOf: - - *290 - *582 + - *581 - allOf: - - *583 - - *582 + - *290 + - *581 - allOf: - *291 - - *582 + - *581 - allOf: - *292 - - *582 + - *581 - allOf: - *293 - - *582 + - *581 - allOf: - *294 - - *582 + - *581 - allOf: - *295 - - *582 + - *581 - allOf: - *296 - - *582 + - *581 - allOf: - *297 - - *582 + - *581 - allOf: - *298 - - *582 + - *581 - allOf: - *299 - - *582 + - *581 - allOf: - *300 - - *582 + - *581 - allOf: - *301 - - *582 + - *581 - allOf: - *302 - - *582 + - *581 - allOf: - *303 - - *582 + - *581 - allOf: - *304 - - *582 + - *581 - allOf: - *305 - - *582 + - *581 - allOf: - *306 - - *582 - - allOf: - - *307 - - *582 + - *581 examples: default: value: @@ -93684,8 +96342,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - *17 - *19 - name: includes_parents @@ -93696,7 +96354,7 @@ paths: schema: type: boolean default: true - - *584 + - *583 responses: '200': description: Response @@ -93704,7 +96362,7 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: default: value: @@ -93751,8 +96409,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 requestBody: description: Request body required: true @@ -93772,16 +96430,16 @@ paths: - tag - push default: branch - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *282 + items: *284 + conditions: *281 rules: type: array description: An array of rules within the ruleset. - items: *585 + items: *584 required: - name - enforcement @@ -93812,9 +96470,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: &595 + default: &594 value: id: 42 name: super cool ruleset @@ -93862,12 +96520,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rule-suites#list-repository-rule-suites parameters: + - *324 - *325 - - *326 + - *585 - *586 - *587 - *588 - - *589 - *17 - *19 responses: @@ -93875,9 +96533,9 @@ paths: description: Response content: application/json: - schema: *590 + schema: *589 examples: - default: *591 + default: *590 '404': *6 '500': *53 x-github: @@ -93898,17 +96556,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rule-suites#get-a-repository-rule-suite parameters: + - *324 - *325 - - *326 - - *592 + - *591 responses: '200': description: Response content: application/json: - schema: *593 + schema: *592 examples: - default: *594 + default: *593 '404': *6 '500': *53 x-github: @@ -93936,8 +96594,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -93957,9 +96615,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *595 + default: *594 '404': *6 '500': *53 put: @@ -93977,8 +96635,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94003,16 +96661,16 @@ paths: - branch - tag - push - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *282 + items: *284 + conditions: *281 rules: description: An array of rules within the ruleset. type: array - items: *585 + items: *584 examples: default: value: @@ -94040,9 +96698,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *595 + default: *594 '404': *6 '422': *15 '500': *53 @@ -94061,8 +96719,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94085,8 +96743,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-repository-ruleset-history parameters: + - *324 - *325 - - *326 - *17 - *19 - name: ruleset_id @@ -94102,9 +96760,9 @@ paths: application/json: schema: type: array - items: *311 + items: *310 examples: - default: *596 + default: *595 '404': *6 '500': *53 x-github: @@ -94123,8 +96781,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-repository-ruleset-version parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94142,7 +96800,7 @@ paths: description: Response content: application/json: - schema: *597 + schema: *596 examples: default: value: @@ -94197,22 +96855,22 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *597 - *598 - *599 - *600 - *601 - - *602 - *59 - *19 - *17 + - *602 - *603 - *604 - *605 - *606 - *607 - - *608 responses: '200': description: Response @@ -94220,24 +96878,24 @@ paths: application/json: schema: type: array - items: &612 + items: &611 type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: *609 - resolution: *610 + state: *608 + resolution: *609 resolved_at: type: - string @@ -94331,7 +96989,7 @@ paths: first_location_detected: anyOf: - type: 'null' - - *611 + - *610 has_more_locations: type: boolean description: A boolean value representing whether or not the @@ -94476,16 +97134,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 - - *608 + - *421 + - *607 responses: '200': description: Response content: application/json: - schema: *612 + schema: *611 examples: default: value: @@ -94539,9 +97197,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#update-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: true content: @@ -94549,8 +97207,8 @@ paths: schema: type: object properties: - state: *609 - resolution: *610 + state: *608 + resolution: *609 resolution_comment: description: An optional comment when closing or reopening an alert. Cannot be updated or deleted. @@ -94588,7 +97246,7 @@ paths: description: Response content: application/json: - schema: *612 + schema: *611 examples: default: value: @@ -94683,9 +97341,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 - *19 - *17 responses: @@ -94696,7 +97354,7 @@ paths: schema: type: array description: List of locations where the secret was detected - items: &762 + items: &761 type: object properties: type: @@ -94723,6 +97381,7 @@ paths: - commit details: oneOf: + - *612 - *613 - *614 - *615 @@ -94735,7 +97394,6 @@ paths: - *622 - *623 - *624 - - *625 examples: default: value: @@ -94821,8 +97479,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#create-a-push-protection-bypass parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -94830,14 +97488,14 @@ paths: schema: type: object properties: - reason: &627 + reason: &626 description: The reason for bypassing push protection. type: string enum: - false_positive - used_in_tests - will_fix_later - placeholder_id: *626 + placeholder_id: *625 required: - reason - placeholder_id @@ -94854,7 +97512,7 @@ paths: schema: type: object properties: - reason: *627 + reason: *626 expire_at: type: - string @@ -94901,8 +97559,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#get-secret-scanning-scan-history-for-a-repository parameters: + - *324 - *325 - - *326 responses: '404': description: Repository does not have GitHub Advanced Security or secret @@ -94917,7 +97575,7 @@ paths: properties: incremental_scans: type: array - items: &628 + items: &627 description: Information on a single scan performed by secret scanning on the repository type: object @@ -94945,15 +97603,15 @@ paths: the scan is pending pattern_update_scans: type: array - items: *628 + items: *627 backfill_scans: type: array - items: *628 + items: *627 custom_pattern_backfill_scans: type: array items: allOf: - - *628 + - *627 - type: object properties: pattern_name: @@ -95023,8 +97681,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#list-repository-security-advisories parameters: + - *324 - *325 - - *326 - *59 - name: sort description: The property to sort the results by. @@ -95068,9 +97726,9 @@ paths: application/json: schema: type: array - items: *629 + items: *628 examples: - default: *630 + default: *629 '400': *14 '404': *6 x-github: @@ -95093,8 +97751,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#create-a-repository-security-advisory parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -95174,7 +97832,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 required: - login - type @@ -95264,9 +97922,9 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: &632 + default: &631 value: ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -95499,8 +98157,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -95613,7 +98271,7 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: default: value: @@ -95760,17 +98418,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#get-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '200': description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *632 + default: *631 '403': *27 '404': *6 x-github: @@ -95794,9 +98452,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#update-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 requestBody: required: true content: @@ -95876,7 +98534,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 required: - login - type @@ -95967,10 +98625,10 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *632 - add_credit: *632 + default: *631 + add_credit: *631 '403': *27 '404': *6 '422': @@ -96008,9 +98666,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#request-a-cve-for-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '202': *37 '400': *14 @@ -96037,17 +98695,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#create-a-temporary-private-fork parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '202': description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 '400': *14 '422': *15 '403': *27 @@ -96073,8 +98731,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#list-stargazers parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96170,8 +98828,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-weekly-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Returns a weekly aggregate of the number of additions and deletions @@ -96180,7 +98838,7 @@ paths: application/json: schema: type: array - items: &633 + items: &632 title: Code Frequency Stat description: Code Frequency Stat type: array @@ -96193,7 +98851,7 @@ paths: - 1124 - -435 '202': *37 - '204': *184 + '204': *183 '422': description: Repository contains more than 10,000 commits x-github: @@ -96213,8 +98871,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-last-year-of-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -96265,7 +98923,7 @@ paths: total: 89 week: 1336280400 '202': *37 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96292,8 +98950,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-all-contributor-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -96365,7 +99023,7 @@ paths: d: 77 c: 10 '202': *37 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96387,8 +99045,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-weekly-commit-count parameters: + - *324 - *325 - - *326 responses: '200': description: The array order is oldest week (index 0) to most recent week. @@ -96542,8 +99200,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-hourly-commit-count-for-each-day parameters: + - *324 - *325 - - *326 responses: '200': description: For example, `[2, 14, 25]` indicates that there were 25 total @@ -96553,7 +99211,7 @@ paths: application/json: schema: type: array - items: *633 + items: *632 examples: default: value: @@ -96566,7 +99224,7 @@ paths: - - 0 - 2 - 21 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96586,8 +99244,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#create-a-commit-status parameters: + - *324 - *325 - - *326 - name: sha in: path required: true @@ -96643,7 +99301,7 @@ paths: description: Response content: application/json: - schema: *634 + schema: *633 examples: default: value: @@ -96697,8 +99355,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#list-watchers parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96730,14 +99388,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#get-a-repository-subscription parameters: + - *324 - *325 - - *326 responses: '200': description: if you subscribe to the repository content: application/json: - schema: &635 + schema: &634 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -96810,8 +99468,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#set-a-repository-subscription parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -96837,7 +99495,7 @@ paths: description: Response content: application/json: - schema: *635 + schema: *634 examples: default: value: @@ -96864,8 +99522,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#delete-a-repository-subscription parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -96885,8 +99543,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-tags parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96968,8 +99626,8 @@ paths: url: https://docs.github.com/rest/repos/contents#download-a-repository-archive-tar operationId: repos/download-tarball-archive parameters: + - *324 - *325 - - *326 - name: ref in: path required: true @@ -97005,8 +99663,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-teams parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -97016,9 +99674,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 headers: Link: *65 '404': *6 @@ -97038,8 +99696,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#get-all-repository-topics parameters: + - *324 - *325 - - *326 - *19 - *17 responses: @@ -97047,7 +99705,7 @@ paths: description: Response content: application/json: - schema: &636 + schema: &635 title: Topic description: A topic aggregates entities that are related to a subject. type: object @@ -97059,7 +99717,7 @@ paths: required: - names examples: - default: &637 + default: &636 value: names: - octocat @@ -97082,8 +99740,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#replace-all-repository-topics parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -97114,9 +99772,9 @@ paths: description: Response content: application/json: - schema: *636 + schema: *635 examples: - default: *637 + default: *636 '404': *6 '422': *7 x-github: @@ -97137,9 +99795,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-repository-clones parameters: + - *324 - *325 - - *326 - - &638 + - &637 name: per description: The time frame to display results for. in: query @@ -97170,7 +99828,7 @@ paths: - 128 clones: type: array - items: &639 + items: &638 title: Traffic type: object properties: @@ -97257,8 +99915,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-top-referral-paths parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -97352,8 +100010,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-top-referral-sources parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -97416,9 +100074,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-page-views parameters: + - *324 - *325 - - *326 - - *638 + - *637 responses: '200': description: Response @@ -97439,7 +100097,7 @@ paths: - 3782 views: type: array - items: *639 + items: *638 required: - uniques - count @@ -97516,8 +100174,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#transfer-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -97553,7 +100211,7 @@ paths: description: Response content: application/json: - schema: *153 + schema: *152 examples: default: value: @@ -97791,8 +100449,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response if repository is enabled with vulnerability alerts @@ -97815,8 +100473,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-vulnerability-alerts parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -97838,8 +100496,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-vulnerability-alerts parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -97865,8 +100523,8 @@ paths: url: https://docs.github.com/rest/repos/contents#download-a-repository-archive-zip operationId: repos/download-zipball-archive parameters: + - *324 - *325 - - *326 - name: ref in: path required: true @@ -97958,9 +100616,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -98001,7 +100659,7 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: default: value: @@ -98107,8 +100765,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#add-issue-field-values-to-an-issue parameters: - - *142 - - *526 + - *141 + - *525 requestBody: required: true content: @@ -98174,9 +100832,9 @@ paths: type: array description: The current issue field values for this issue after adding the new values - items: *529 + items: *528 examples: - default: *640 + default: *639 '400': *14 '403': *27 '404': *6 @@ -98212,8 +100870,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#set-issue-field-values-for-an-issue parameters: - - *142 - - *526 + - *141 + - *525 requestBody: required: true content: @@ -98280,9 +100938,9 @@ paths: type: array description: The current issue field values for this issue after setting the new values - items: *529 + items: *528 examples: - default: *640 + default: *639 '400': *14 '403': *27 '404': *6 @@ -98313,9 +100971,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#delete-an-issue-field-value-from-an-issue parameters: - - *142 - - *526 - - *229 + - *141 + - *525 + - *228 responses: '204': description: Issue field value deleted successfully @@ -98436,7 +101094,7 @@ paths: html_url: type: string format: uri - repository: *153 + repository: *152 score: type: number file_size: @@ -98455,7 +101113,7 @@ paths: examples: - 73..77 - 77..78 - text_matches: &641 + text_matches: &640 title: Search Result Text Matches type: array items: @@ -98618,7 +101276,7 @@ paths: enum: - author-date - committer-date - - &642 + - &641 name: order description: Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter @@ -98687,7 +101345,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 comment_count: type: integer message: @@ -98706,7 +101364,7 @@ paths: url: type: string format: uri - verification: *506 + verification: *505 required: - author - committer @@ -98721,7 +101379,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 parents: type: array items: @@ -98733,12 +101391,12 @@ paths: type: string sha: type: string - repository: *153 + repository: *152 score: type: number node_id: type: string - text_matches: *641 + text_matches: *640 required: - sha - node_id @@ -98930,7 +101588,7 @@ paths: - interactions - created - updated - - *642 + - *641 - *17 - *19 - name: advanced_search @@ -99044,11 +101702,11 @@ paths: type: - string - 'null' - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: type: string state_reason: @@ -99062,7 +101720,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 comments: type: integer created_at: @@ -99076,7 +101734,7 @@ paths: - string - 'null' format: date-time - text_matches: *641 + text_matches: *640 pull_request: type: object properties: @@ -99125,7 +101783,7 @@ paths: timeline_url: type: string format: uri - type: *230 + type: *229 performed_via_github_app: anyOf: - type: 'null' @@ -99342,7 +102000,7 @@ paths: enum: - created - updated - - *642 + - *641 - *17 - *19 responses: @@ -99387,7 +102045,7 @@ paths: - 'null' score: type: number - text_matches: *641 + text_matches: *640 required: - id - node_id @@ -99472,7 +102130,7 @@ paths: - forks - help-wanted-issues - updated - - *642 + - *641 - *17 - *19 responses: @@ -99718,7 +102376,7 @@ paths: - admin - pull - push - text_matches: *641 + text_matches: *640 temp_clone_token: type: string allow_merge_commit: @@ -100026,7 +102684,7 @@ paths: - string - 'null' format: uri - text_matches: *641 + text_matches: *640 related: type: - array @@ -100219,7 +102877,7 @@ paths: - followers - repositories - joined - - *642 + - *641 - *17 - *19 responses: @@ -100329,7 +102987,7 @@ paths: type: - boolean - 'null' - text_matches: *641 + text_matches: *640 blog: type: - string @@ -100411,7 +103069,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#get-a-team-legacy parameters: - - &645 + - &644 name: team_id description: The unique identifier of the team. in: path @@ -100423,9 +103081,9 @@ paths: description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 x-github: githubCloudOnly: false @@ -100452,7 +103110,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#update-a-team-legacy parameters: - - *645 + - *644 requestBody: required: true content: @@ -100516,16 +103174,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '201': description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 '422': *15 '403': *27 @@ -100553,7 +103211,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#delete-a-team-legacy parameters: - - *645 + - *644 responses: '204': description: Response @@ -100582,7 +103240,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#list-pending-team-invitations-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -100592,9 +103250,9 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 x-github: @@ -100620,7 +103278,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#list-team-members-legacy parameters: - - *645 + - *644 - name: role description: Filters members returned by their role in the team. in: query @@ -100671,7 +103329,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#get-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100708,7 +103366,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#add-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100748,7 +103406,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#remove-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100785,16 +103443,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#get-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 responses: '200': description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-user-is-a-team-maintainer: *646 + response-if-user-is-a-team-maintainer: *645 '404': *6 x-github: githubCloudOnly: false @@ -100827,7 +103485,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 requestBody: required: false @@ -100853,9 +103511,9 @@ paths: description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-users-membership-with-team-is-now-pending: *647 + response-if-users-membership-with-team-is-now-pending: *646 '403': description: Forbidden if team synchronization is set up '422': @@ -100889,7 +103547,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100917,7 +103575,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#list-team-repositories-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -100927,9 +103585,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 '404': *6 @@ -100959,15 +103617,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#check-team-permissions-for-a-repository-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 responses: '200': description: Alternative response with extra repository information content: application/json: - schema: *648 + schema: *647 examples: alternative-response-with-extra-repository-information: value: @@ -101118,9 +103776,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#add-or-update-team-repository-permissions-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 requestBody: required: false content: @@ -101170,9 +103828,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#remove-a-repository-from-a-team-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 responses: '204': description: Response @@ -101197,7 +103855,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#list-child-teams-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -101207,9 +103865,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - response-if-child-teams-exist: *649 + response-if-child-teams-exist: *648 headers: Link: *65 '404': *6 @@ -101242,7 +103900,7 @@ paths: application/json: schema: oneOf: - - &651 + - &650 title: Private User description: Private User type: object @@ -101492,7 +104150,7 @@ paths: - private_gists - total_private_repos - two_factor_authentication - - *650 + - *649 examples: response-with-public-and-private-profile-information: summary: Response with public and private profile information @@ -101652,7 +104310,7 @@ paths: description: Response content: application/json: - schema: *651 + schema: *650 examples: default: value: @@ -101855,9 +104513,9 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: - default: *236 + default: *235 '304': *35 '500': *53 '401': *23 @@ -101996,17 +104654,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -102050,7 +104708,7 @@ paths: type: integer secrets: type: array - items: &652 + items: &651 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -102092,7 +104750,7 @@ paths: - visibility - selected_repositories_url examples: - default: *447 + default: *446 headers: Link: *65 x-github: @@ -102164,13 +104822,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#get-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *652 + schema: *651 examples: default: value: @@ -102200,7 +104858,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#create-or-update-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 requestBody: required: true content: @@ -102245,7 +104903,7 @@ paths: description: Response after successfully creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -102273,7 +104931,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#delete-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 responses: '204': description: Response @@ -102298,7 +104956,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#list-selected-repositories-for-a-user-secret parameters: - - *161 + - *160 responses: '200': description: Response @@ -102314,9 +104972,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *189 + default: *188 '401': *23 '403': *27 '404': *6 @@ -102341,7 +104999,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#set-selected-repositories-for-a-user-secret parameters: - - *161 + - *160 requestBody: required: true content: @@ -102395,7 +105053,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#add-a-selected-repository-to-a-user-secret parameters: - - *161 + - *160 - name: repository_id in: path required: true @@ -102428,7 +105086,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#remove-a-selected-repository-from-a-user-secret parameters: - - *161 + - *160 - name: repository_id in: path required: true @@ -102460,15 +105118,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '304': *35 '500': *53 '401': *23 @@ -102494,7 +105152,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#update-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 requestBody: required: false content: @@ -102524,9 +105182,9 @@ paths: description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -102548,7 +105206,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#delete-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '202': *37 '304': *35 @@ -102577,13 +105235,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#export-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '202': description: Response content: application/json: - schema: &653 + schema: &652 type: object title: Fetches information about an export of a codespace. description: An export of a codespace. Also, latest export details @@ -102636,7 +105294,7 @@ paths: examples: - https://github.com/octocat/hello-world/tree/:branch examples: - default: &654 + default: &653 value: state: succeeded completed_at: '2022-01-01T14:59:22Z' @@ -102668,7 +105326,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-details-about-a-codespace-export parameters: - - *237 + - *236 - name: export_id in: path required: true @@ -102681,9 +105339,9 @@ paths: description: Response content: application/json: - schema: *653 + schema: *652 examples: - default: *654 + default: *653 '404': *6 x-github: githubCloudOnly: false @@ -102704,7 +105362,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/machines#list-machine-types-for-a-codespace parameters: - - *237 + - *236 responses: '200': description: Response @@ -102720,9 +105378,9 @@ paths: type: integer machines: type: array - items: *446 + items: *445 examples: - default: *655 + default: *654 '304': *35 '500': *53 '401': *23 @@ -102751,7 +105409,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-repository-from-an-unpublished-codespace parameters: - - *237 + - *236 requestBody: required: true content: @@ -102807,11 +105465,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *328 + repository: *327 machine: anyOf: - type: 'null' - - *446 + - *445 devcontainer_path: description: Path to devcontainer.json from repo root used to create Codespace. @@ -103608,15 +106266,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#start-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '304': *35 '500': *53 '400': *14 @@ -103648,15 +106306,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#stop-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '500': *53 '401': *23 '403': *27 @@ -103686,9 +106344,9 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: &666 + default: &665 value: - id: 197 name: hello_docker @@ -103789,7 +106447,7 @@ paths: application/json: schema: type: array - items: &656 + items: &655 title: Email description: Email type: object @@ -103859,9 +106517,9 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: - default: &668 + default: &667 value: - email: octocat@github.com verified: true @@ -103938,7 +106596,7 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: default: value: @@ -104196,7 +106854,7 @@ paths: application/json: schema: type: array - items: &657 + items: &656 title: GPG Key description: A unique encryption key type: object @@ -104341,7 +106999,7 @@ paths: - subkeys - revoked examples: - default: &684 + default: &683 value: - id: 3 name: Octocat's GPG Key @@ -104426,9 +107084,9 @@ paths: description: Response content: application/json: - schema: *657 + schema: *656 examples: - default: &658 + default: &657 value: id: 3 name: Octocat's GPG Key @@ -104485,7 +107143,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/gpg-keys#get-a-gpg-key-for-the-authenticated-user parameters: - - &659 + - &658 name: gpg_key_id description: The unique identifier of the GPG key. in: path @@ -104497,9 +107155,9 @@ paths: description: Response content: application/json: - schema: *657 + schema: *656 examples: - default: *658 + default: *657 '404': *6 '304': *35 '403': *27 @@ -104522,7 +107180,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/gpg-keys#delete-a-gpg-key-for-the-authenticated-user parameters: - - *659 + - *658 responses: '204': description: Response @@ -104715,7 +107373,7 @@ paths: allOf: - *77 examples: - default: *145 + default: *144 headers: Link: *65 '404': *6 @@ -104741,7 +107399,7 @@ paths: url: https://docs.github.com/rest/apps/installations#add-a-repository-to-an-app-installation parameters: - *21 - - *142 + - *141 responses: '204': description: Response @@ -104767,7 +107425,7 @@ paths: url: https://docs.github.com/rest/apps/installations#remove-a-repository-from-an-app-installation parameters: - *21 - - *142 + - *141 responses: '204': description: Response @@ -104801,12 +107459,12 @@ paths: application/json: schema: anyOf: - - *222 + - *221 - type: object properties: {} additionalProperties: false examples: - default: *223 + default: *222 '204': description: Response when there are no restrictions x-github: @@ -104830,7 +107488,7 @@ paths: required: true content: application/json: - schema: *517 + schema: *516 examples: default: value: @@ -104841,7 +107499,7 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: default: value: @@ -104922,7 +107580,7 @@ paths: - closed - all default: open - - *233 + - *232 - name: sort description: What to sort results by. in: query @@ -104947,7 +107605,7 @@ paths: type: array items: *81 examples: - default: *234 + default: *233 headers: Link: *65 '404': *6 @@ -104980,7 +107638,7 @@ paths: application/json: schema: type: array - items: &660 + items: &659 title: Key description: Key type: object @@ -105083,9 +107741,9 @@ paths: description: Response content: application/json: - schema: *660 + schema: *659 examples: - default: &661 + default: &660 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -105118,15 +107776,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/keys#get-a-public-ssh-key-for-the-authenticated-user parameters: - - *547 + - *546 responses: '200': description: Response content: application/json: - schema: *660 + schema: *659 examples: - default: *661 + default: *660 '404': *6 '304': *35 '403': *27 @@ -105149,7 +107807,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/keys#delete-a-public-ssh-key-for-the-authenticated-user parameters: - - *547 + - *546 responses: '204': description: Response @@ -105182,7 +107840,7 @@ paths: application/json: schema: type: array - items: &662 + items: &661 title: User Marketplace Purchase description: User Marketplace Purchase type: object @@ -105261,7 +107919,7 @@ paths: - account - plan examples: - default: &663 + default: &662 value: - billing_cycle: monthly next_billing_date: '2017-11-11T00:00:00Z' @@ -105323,9 +107981,9 @@ paths: application/json: schema: type: array - items: *662 + items: *661 examples: - default: *663 + default: *662 headers: Link: *65 '304': *35 @@ -105365,7 +108023,7 @@ paths: application/json: schema: type: array - items: *239 + items: *238 examples: default: value: @@ -105479,7 +108137,7 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: default: value: @@ -105566,7 +108224,7 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: default: value: @@ -105638,7 +108296,7 @@ paths: application/json: schema: type: array - items: *241 + items: *240 examples: default: value: @@ -105900,7 +108558,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -106080,7 +108738,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#get-a-user-migration-status parameters: - - *242 + - *241 - name: exclude in: query required: false @@ -106093,7 +108751,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -106287,7 +108945,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#download-a-user-migration-archive parameters: - - *242 + - *241 responses: '302': description: Response @@ -106313,7 +108971,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#delete-a-user-migration-archive parameters: - - *242 + - *241 responses: '204': description: Response @@ -106342,8 +109000,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#unlock-a-user-repository parameters: - - *242 - - *664 + - *241 + - *663 responses: '204': description: Response @@ -106367,7 +109025,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#list-repositories-for-a-user-migration parameters: - - *242 + - *241 - *17 - *19 responses: @@ -106377,9 +109035,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 '404': *6 @@ -106458,7 +109116,7 @@ paths: - docker - nuget - container - - *665 + - *664 - *19 - *17 responses: @@ -106468,10 +109126,10 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *666 - '400': *667 + default: *665 + '400': *666 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106491,16 +109149,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 responses: '200': description: Response content: application/json: - schema: *247 + schema: *246 examples: - default: &685 + default: &684 value: id: 40201 name: octo-name @@ -106613,8 +109271,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 responses: '204': description: Response @@ -106644,8 +109302,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - name: token description: package token schema: @@ -106677,8 +109335,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user parameters: + - *248 - *249 - - *250 - *19 - *17 - name: state @@ -106698,7 +109356,7 @@ paths: application/json: schema: type: array - items: *251 + items: *250 examples: default: value: @@ -106747,15 +109405,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '200': description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -106791,9 +109449,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '204': description: Response @@ -106823,9 +109481,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '204': description: Response @@ -106862,9 +109520,9 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: - default: *668 + default: *667 headers: Link: *65 '304': *35 @@ -106977,7 +109635,7 @@ paths: type: array items: *77 examples: - default: &675 + default: &674 summary: Default response value: - id: 1296269 @@ -107295,9 +109953,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -107335,9 +109993,9 @@ paths: application/json: schema: type: array - items: *519 + items: *518 examples: - default: *669 + default: *668 headers: Link: *65 '304': *35 @@ -107360,7 +110018,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#accept-a-repository-invitation parameters: - - *226 + - *225 responses: '204': description: Response @@ -107383,7 +110041,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#decline-a-repository-invitation parameters: - - *226 + - *225 responses: '204': description: Response @@ -107416,7 +110074,7 @@ paths: application/json: schema: type: array - items: &670 + items: &669 title: Social account description: Social media account type: object @@ -107433,7 +110091,7 @@ paths: - provider - url examples: - default: &671 + default: &670 value: - provider: twitter url: https://twitter.com/github @@ -107496,9 +110154,9 @@ paths: application/json: schema: type: array - items: *670 + items: *669 examples: - default: *671 + default: *670 '422': *15 '304': *35 '404': *6 @@ -107586,7 +110244,7 @@ paths: application/json: schema: type: array - items: &672 + items: &671 title: SSH Signing Key description: A public SSH key used to sign Git commits type: object @@ -107606,7 +110264,7 @@ paths: - title - created_at examples: - default: &703 + default: &702 value: - id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -107671,9 +110329,9 @@ paths: description: Response content: application/json: - schema: *672 + schema: *671 examples: - default: &673 + default: &672 value: id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -107703,7 +110361,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/ssh-signing-keys#get-an-ssh-signing-key-for-the-authenticated-user parameters: - - &674 + - &673 name: ssh_signing_key_id description: The unique identifier of the SSH signing key. in: path @@ -107715,9 +110373,9 @@ paths: description: Response content: application/json: - schema: *672 + schema: *671 examples: - default: *673 + default: *672 '404': *6 '304': *35 '403': *27 @@ -107740,7 +110398,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/ssh-signing-keys#delete-an-ssh-signing-key-for-the-authenticated-user parameters: - - *674 + - *673 responses: '204': description: Response @@ -107769,7 +110427,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-the-authenticated-user parameters: - - &704 + - &703 name: sort description: The property to sort the results by. `created` means when the repository was starred. `updated` means when the repository was last pushed @@ -107794,11 +110452,11 @@ paths: type: array items: *77 examples: - default-response: *675 + default-response: *674 application/vnd.github.v3.star+json: schema: type: array - items: &705 + items: &704 title: Starred Repository description: Starred Repository type: object @@ -107954,8 +110612,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response if this repository is starred by you @@ -107983,8 +110641,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#star-a-repository-for-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -108008,8 +110666,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#unstar-a-repository-for-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -108042,9 +110700,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 '304': *35 @@ -108081,7 +110739,7 @@ paths: application/json: schema: type: array - items: *321 + items: *320 examples: default: value: @@ -108167,10 +110825,10 @@ paths: application/json: schema: oneOf: - - *651 - *650 + - *649 examples: - default-response: &679 + default-response: &678 summary: Default response value: login: octocat @@ -108205,7 +110863,7 @@ paths: following: 0 created_at: '2008-01-14T04:33:35Z' updated_at: '2008-01-14T04:33:35Z' - response-with-git-hub-plan-information: &680 + response-with-git-hub-plan-information: &679 summary: Response with GitHub plan information value: login: octocat @@ -108262,14 +110920,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-user-owned-project parameters: - - &677 + - &676 name: user_id description: The unique identifier of the user. in: path required: true schema: type: string - - *265 + - *264 requestBody: required: true description: Details of the draft item to create in the project. @@ -108303,9 +110961,9 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: - draft_issue: *271 + draft_issue: *270 '304': *35 '403': *27 '401': *23 @@ -108328,7 +110986,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/users#list-users parameters: - - *676 + - *675 - *17 responses: '200': @@ -108363,8 +111021,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/views#create-a-view-for-a-user-owned-project parameters: - - *677 - - *265 + - *676 + - *264 requestBody: required: true content: @@ -108438,17 +111096,17 @@ paths: description: Response for creating a view in a user-owned project. content: application/json: - schema: *678 + schema: *677 examples: table_view: summary: Response for creating a table view - value: *275 + value: *274 board_view: summary: Response for creating a board view with filter - value: *275 + value: *274 roadmap_view: summary: Response for creating a roadmap view - value: *275 + value: *274 '304': *35 '403': *27 '401': *23 @@ -108490,11 +111148,11 @@ paths: application/json: schema: oneOf: - - *651 - *650 + - *649 examples: - default-response: *679 - response-with-git-hub-plan-information: *680 + default-response: *678 + response-with-git-hub-plan-information: *679 '404': *6 x-github: githubCloudOnly: false @@ -108544,8 +111202,8 @@ paths: required: - subject_digests examples: - default: *681 - withPredicateType: *682 + default: *680 + withPredicateType: *681 responses: '200': description: Response @@ -108599,7 +111257,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: *683 + default: *682 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -108804,12 +111462,12 @@ paths: initiator: type: string examples: - default: *386 + default: *385 '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -108843,9 +111501,9 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *666 + default: *665 '403': *27 '401': *23 x-github: @@ -109229,9 +111887,9 @@ paths: application/json: schema: type: array - items: *657 + items: *656 examples: - default: *684 + default: *683 headers: Link: *65 x-github: @@ -109335,7 +111993,7 @@ paths: application/json: schema: *20 examples: - default: *516 + default: *515 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -109460,7 +112118,7 @@ paths: - docker - nuget - container - - *665 + - *664 - *69 - *19 - *17 @@ -109471,12 +112129,12 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *666 + default: *665 '403': *27 '401': *23 - '400': *667 + '400': *666 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -109496,17 +112154,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '200': description: Response content: application/json: - schema: *247 + schema: *246 examples: - default: *685 + default: *684 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -109527,8 +112185,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '204': @@ -109561,8 +112219,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 - name: token description: package token @@ -109595,8 +112253,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '200': @@ -109605,7 +112263,7 @@ paths: application/json: schema: type: array - items: *251 + items: *250 examples: default: value: @@ -109663,16 +112321,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-a-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 - *69 responses: '200': description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -109707,10 +112365,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-package-version-for-a-user parameters: + - *248 - *249 - - *250 - *69 - - *252 + - *251 responses: '204': description: Response @@ -109742,10 +112400,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-package-version-for-a-user parameters: + - *248 - *249 - - *250 - *69 - - *252 + - *251 responses: '204': description: Response @@ -109786,9 +112444,9 @@ paths: application/json: schema: type: array - items: *263 + items: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -109810,16 +112468,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/projects#get-project-for-user parameters: - - *265 + - *264 - *69 responses: '200': description: Response content: application/json: - schema: *263 + schema: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -109841,7 +112499,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#list-project-fields-for-user parameters: - - *265 + - *264 - *69 - *17 - *45 @@ -109853,9 +112511,9 @@ paths: application/json: schema: type: array - items: *268 + items: *267 examples: - default: *686 + default: *685 headers: Link: *65 '304': *35 @@ -109877,7 +112535,7 @@ paths: url: https://docs.github.com/rest/projects/fields#add-field-to-user-owned-project parameters: - *69 - - *265 + - *264 requestBody: required: true content: @@ -109915,7 +112573,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: *687 + items: *686 required: - name - data_type @@ -109931,7 +112589,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: *688 + iteration_configuration: *687 required: - name - data_type @@ -109953,20 +112611,20 @@ paths: value: name: Due date data_type: date - single_select_field: *689 - iteration_field: *690 + single_select_field: *688 + iteration_field: *689 responses: '201': description: Response content: application/json: - schema: *268 + schema: *267 examples: - text_field: *691 - number_field: *692 - date_field: *693 - single_select_field: *694 - iteration_field: *695 + text_field: *690 + number_field: *691 + date_field: *692 + single_select_field: *693 + iteration_field: *694 '304': *35 '403': *27 '401': *23 @@ -109987,17 +112645,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#get-project-field-for-user parameters: - - *265 - - *696 + - *264 + - *695 - *69 responses: '200': description: Response content: application/json: - schema: *268 + schema: *267 examples: - default: *697 + default: *696 headers: Link: *65 '304': *35 @@ -110020,7 +112678,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-a-user-owned-project parameters: - - *265 + - *264 - *69 - *45 - *46 @@ -110053,9 +112711,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -110077,7 +112735,7 @@ paths: url: https://docs.github.com/rest/projects/items#add-item-to-user-owned-project parameters: - *69 - - *265 + - *264 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -110147,22 +112805,22 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *271 + value: *270 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *271 + value: *270 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *271 + value: *270 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *271 + value: *270 '304': *35 '403': *27 '401': *23 @@ -110182,9 +112840,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#get-an-item-for-a-user-owned-project parameters: - - *265 + - *264 - *69 - - *274 + - *273 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the title field will be returned. @@ -110204,9 +112862,9 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -110227,9 +112885,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#update-project-item-for-user parameters: - - *265 + - *264 - *69 - - *274 + - *273 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -110302,13 +112960,13 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - text_field: *273 - number_field: *273 - date_field: *273 - single_select_field: *273 - iteration_field: *273 + text_field: *272 + number_field: *272 + date_field: *272 + single_select_field: *272 + iteration_field: *272 '401': *23 '403': *27 '404': *6 @@ -110328,9 +112986,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#delete-project-item-for-user parameters: - - *265 + - *264 - *69 - - *274 + - *273 responses: '204': description: Response @@ -110352,9 +113010,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-a-user-project-view parameters: - - *265 + - *264 - *69 - - *698 + - *697 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the @@ -110380,9 +113038,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -110601,9 +113259,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -110629,7 +113287,7 @@ paths: - *115 - *117 - *116 - - *699 + - *698 - *118 responses: '200': @@ -110760,7 +113418,7 @@ paths: parameters: - *69 - *115 - - *700 + - *699 - *116 responses: '200': @@ -110859,9 +113517,9 @@ paths: - *115 - *117 - *116 - - *701 + - *700 - *118 - - *702 + - *701 responses: '200': description: Response when getting a billing usage summary @@ -110995,9 +113653,9 @@ paths: application/json: schema: type: array - items: *670 + items: *669 examples: - default: *671 + default: *670 headers: Link: *65 x-github: @@ -111027,9 +113685,9 @@ paths: application/json: schema: type: array - items: *672 + items: *671 examples: - default: *703 + default: *702 headers: Link: *65 x-github: @@ -111054,7 +113712,7 @@ paths: url: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-a-user parameters: - *69 - - *704 + - *703 - *59 - *17 - *19 @@ -111066,11 +113724,11 @@ paths: schema: anyOf: - type: array - items: *705 + items: *704 - type: array items: *77 examples: - default-response: *675 + default-response: *674 headers: Link: *65 x-github: @@ -111099,9 +113757,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -111230,7 +113888,7 @@ webhooks: type: string enum: - disabled - enterprise: &706 + enterprise: &705 title: Enterprise description: |- An enterprise on GitHub. Webhook payloads contain the `enterprise` property when the webhook is configured @@ -111299,7 +113957,7 @@ webhooks: - created_at - updated_at - avatar_url - installation: &707 + installation: &706 title: Simple Installation description: |- The GitHub App installation. Webhook payloads contain the `installation` property when the event is configured @@ -111320,7 +113978,7 @@ webhooks: required: - id - node_id - organization: &708 + organization: &707 title: Organization Simple description: |- A GitHub organization. Webhook payloads contain the `organization` property when the webhook is configured for an @@ -111393,7 +114051,7 @@ webhooks: - public_members_url - avatar_url - description - repository: &709 + repository: &708 title: Repository description: |- The repository on GitHub where the event occurred. Webhook payloads contain the `repository` property @@ -112319,10 +114977,10 @@ webhooks: type: string enum: - enabled - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -112398,11 +115056,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: &710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: &709 title: branch protection rule description: The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) @@ -112625,11 +115283,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: *710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: *709 sender: *4 required: - action @@ -112817,11 +115475,11 @@ webhooks: - everyone required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: *710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: *709 sender: *4 required: - action @@ -112905,7 +115563,7 @@ webhooks: type: string enum: - completed - check_run: &712 + check_run: &711 title: CheckRun description: A check performed on the code of a given code change type: object @@ -112971,7 +115629,7 @@ webhooks: pull_requests: type: array items: *84 - repository: *153 + repository: *152 status: type: string enum: @@ -113015,7 +115673,7 @@ webhooks: - examples: - neutral - deployment: *711 + deployment: *710 details_url: type: string examples: @@ -113113,10 +115771,10 @@ webhooks: - output - app - pull_requests - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -113507,11 +116165,11 @@ webhooks: type: string enum: - created - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -113905,11 +116563,11 @@ webhooks: type: string enum: - requested_action - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 requested_action: description: The action requested by the user. type: object @@ -114312,11 +116970,11 @@ webhooks: type: string enum: - rerequested - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -115301,10 +117959,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -116008,10 +118666,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -116709,10 +119367,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -116881,7 +119539,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -117033,20 +119691,20 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: &713 + commit_oid: &712 description: The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - enterprise: *706 - installation: *707 - organization: *708 - ref: &714 + enterprise: *705 + installation: *706 + organization: *707 + ref: &713 description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -117213,7 +119871,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -117454,12 +120112,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -117557,7 +120215,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -117742,12 +120400,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -117916,7 +120574,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -118093,12 +120751,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -118199,7 +120857,7 @@ webhooks: type: - object - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -118388,9 +121046,9 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 ref: description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event @@ -118398,7 +121056,7 @@ webhooks: type: - string - 'null' - repository: *709 + repository: *708 sender: *4 required: - action @@ -118497,7 +121155,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -118644,12 +121302,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -118818,7 +121476,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -118970,10 +121628,10 @@ webhooks: - dismissed_reason - rule - tool - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -119233,10 +121891,10 @@ webhooks: - updated_at - author_association - body - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -119317,18 +121975,18 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 master_branch: description: The name of the repository's default branch (usually `main`). type: string - organization: *708 - pusher_type: &715 + organization: *707 + pusher_type: &714 description: The pusher type for the event. Can be either `user` or a deploy key. type: string - ref: &716 + ref: &715 description: The [`git ref`](https://docs.github.com/rest/git/refs#get-a-reference) resource. type: string @@ -119338,7 +121996,7 @@ webhooks: enum: - tag - branch - repository: *709 + repository: *708 sender: *4 required: - ref @@ -119420,10 +122078,10 @@ webhooks: type: string enum: - created - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119508,9 +122166,9 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119587,10 +122245,10 @@ webhooks: type: string enum: - promote_to_enterprise - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119667,10 +122325,10 @@ webhooks: type: string enum: - updated - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119747,19 +122405,19 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - repository: *709 - organization: *708 + enterprise: *705 + installation: *706 + repository: *708 + organization: *707 sender: *4 new_property_values: type: array description: The new custom property values for the repository. - items: *280 + items: *279 old_property_values: type: array description: The old custom property values for the repository. - items: *280 + items: *279 required: - action - repository @@ -119835,18 +122493,18 @@ webhooks: title: delete event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - pusher_type: *715 - ref: *716 + enterprise: *705 + installation: *706 + organization: *707 + pusher_type: *714 + ref: *715 ref_type: description: The type of Git ref object deleted in the repository. type: string enum: - tag - branch - repository: *709 + repository: *708 sender: *4 required: - ref @@ -119926,11 +122584,11 @@ webhooks: type: string enum: - assignees_changed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120010,11 +122668,11 @@ webhooks: type: string enum: - auto_dismissed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120095,11 +122753,11 @@ webhooks: type: string enum: - auto_reopened - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120180,11 +122838,11 @@ webhooks: type: string enum: - created - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120263,11 +122921,11 @@ webhooks: type: string enum: - dismissed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120346,11 +123004,11 @@ webhooks: type: string enum: - fixed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120430,11 +123088,11 @@ webhooks: type: string enum: - reintroduced - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120513,11 +123171,11 @@ webhooks: type: string enum: - reopened - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120594,9 +123252,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - key: &717 + enterprise: *705 + installation: *706 + key: &716 description: The [`deploy key`](https://docs.github.com/rest/deploy-keys/deploy-keys#get-a-deploy-key) resource. type: object @@ -120634,8 +123292,8 @@ webhooks: - verified - created_at - read_only - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -120712,11 +123370,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - key: *717 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + key: *716 + organization: *707 + repository: *708 sender: *4 required: - action @@ -121283,12 +123941,12 @@ webhooks: - updated_at - statuses_url - repository_url - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: &721 + workflow: &720 title: Workflow type: - object @@ -122039,13 +124697,13 @@ webhooks: deployment: anyOf: - type: 'null' - - *481 + - *480 pull_requests: type: array - items: *565 - repository: *709 - organization: *708 - installation: *707 + items: *564 + repository: *708 + organization: *707 + installation: *706 sender: *4 responses: '200': @@ -122116,7 +124774,7 @@ webhooks: type: string enum: - approved - approver: &718 + approver: &717 type: object properties: avatar_url: @@ -122159,11 +124817,11 @@ webhooks: type: string comment: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - reviewers: &719 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + reviewers: &718 type: array items: type: object @@ -122244,7 +124902,7 @@ webhooks: sender: *4 since: type: string - workflow_job_run: &720 + workflow_job_run: &719 type: object properties: conclusion: @@ -122990,18 +125648,18 @@ webhooks: type: string enum: - rejected - approver: *718 + approver: *717 comment: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - reviewers: *719 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + reviewers: *718 sender: *4 since: type: string - workflow_job_run: *720 + workflow_job_run: *719 workflow_job_runs: type: array items: @@ -123718,13 +126376,13 @@ webhooks: type: string enum: - requested - enterprise: *706 + enterprise: *705 environment: type: string - installation: *707 - organization: *708 - repository: *709 - requestor: &726 + installation: *706 + organization: *707 + repository: *708 + requestor: &725 title: User type: - object @@ -125657,12 +128315,12 @@ webhooks: - updated_at - deployment_url - repository_url - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Deployment Workflow Run type: @@ -126353,7 +129011,7 @@ webhooks: type: string enum: - answered - answer: &724 + answer: &723 type: object properties: author_association: @@ -126513,11 +129171,11 @@ webhooks: - created_at - updated_at - body - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126644,11 +129302,11 @@ webhooks: - from required: - category - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126731,11 +129389,11 @@ webhooks: type: string enum: - closed - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126817,7 +129475,7 @@ webhooks: type: string enum: - created - comment: &723 + comment: &722 type: object properties: author_association: @@ -126977,11 +129635,11 @@ webhooks: - updated_at - body - reactions - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127064,12 +129722,12 @@ webhooks: type: string enum: - deleted - comment: *723 - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + comment: *722 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127164,12 +129822,12 @@ webhooks: - from required: - body - comment: *723 - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + comment: *722 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127253,11 +129911,11 @@ webhooks: type: string enum: - created - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127339,11 +129997,11 @@ webhooks: type: string enum: - deleted - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127443,11 +130101,11 @@ webhooks: type: string required: - from - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127529,10 +130187,10 @@ webhooks: type: string enum: - labeled - discussion: *722 - enterprise: *706 - installation: *707 - label: &725 + discussion: *721 + enterprise: *705 + installation: *706 + label: &724 title: Label type: object properties: @@ -127565,8 +130223,8 @@ webhooks: - color - default - description - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127649,11 +130307,11 @@ webhooks: type: string enum: - locked - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127735,11 +130393,11 @@ webhooks: type: string enum: - pinned - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127821,11 +130479,11 @@ webhooks: type: string enum: - reopened - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127910,16 +130568,16 @@ webhooks: changes: type: object properties: - new_discussion: *722 - new_repository: *709 + new_discussion: *721 + new_repository: *708 required: - new_discussion - new_repository - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128002,10 +130660,10 @@ webhooks: type: string enum: - unanswered - discussion: *722 - old_answer: *724 - organization: *708 - repository: *709 + discussion: *721 + old_answer: *723 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128087,12 +130745,12 @@ webhooks: type: string enum: - unlabeled - discussion: *722 - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128175,11 +130833,11 @@ webhooks: type: string enum: - unlocked - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128261,11 +130919,11 @@ webhooks: type: string enum: - unpinned - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128338,7 +130996,7 @@ webhooks: description: A user forks a repository. type: object properties: - enterprise: *706 + enterprise: *705 forkee: description: The created [`repository`](https://docs.github.com/rest/repos/repos#get-a-repository) resource. @@ -129016,9 +131674,9 @@ webhooks: type: integer watchers_count: type: integer - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - forkee @@ -129164,9 +131822,9 @@ webhooks: title: gollum event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pages: description: The pages that were updated. type: array @@ -129204,7 +131862,7 @@ webhooks: - action - sha - html_url - repository: *709 + repository: *708 sender: *4 required: - pages @@ -129280,10 +131938,10 @@ webhooks: type: string enum: - created - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: &727 + organization: *707 + repositories: &726 description: An array of repository objects that the installation can access. type: array @@ -129309,8 +131967,8 @@ webhooks: - name - full_name - private - repository: *709 - requester: *726 + repository: *708 + requester: *725 sender: *4 required: - action @@ -129385,11 +132043,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129466,11 +132124,11 @@ webhooks: type: string enum: - new_permissions_accepted - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129547,10 +132205,10 @@ webhooks: type: string enum: - added - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories_added: &728 + organization: *707 + repositories_added: &727 description: An array of repository objects, which were added to the installation. type: array @@ -129596,15 +132254,15 @@ webhooks: private: description: Whether the repository is private or public. type: boolean - repository: *709 - repository_selection: &729 + repository: *708 + repository_selection: &728 description: Describe whether all repositories have been selected or there's a selection involved type: string enum: - all - selected - requester: *726 + requester: *725 sender: *4 required: - action @@ -129683,10 +132341,10 @@ webhooks: type: string enum: - removed - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories_added: *728 + organization: *707 + repositories_added: *727 repositories_removed: description: An array of repository objects, which were removed from the installation. @@ -129713,9 +132371,9 @@ webhooks: - name - full_name - private - repository: *709 - repository_selection: *729 - requester: *726 + repository: *708 + repository_selection: *728 + requester: *725 sender: *4 required: - action @@ -129794,11 +132452,11 @@ webhooks: type: string enum: - suspend - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129980,10 +132638,10 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 target_type: type: string @@ -130062,11 +132720,11 @@ webhooks: type: string enum: - unsuspend - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -130232,7 +132890,7 @@ webhooks: pin: anyOf: - type: 'null' - - *544 + - *543 user: title: User type: @@ -130318,8 +132976,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -131131,8 +133789,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -131149,7 +133807,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -131493,8 +134151,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -131574,7 +134232,7 @@ webhooks: type: string enum: - deleted - comment: &730 + comment: &729 title: issue comment description: The [comment](https://docs.github.com/rest/issues/comments#get-an-issue-comment) itself. @@ -131731,7 +134389,7 @@ webhooks: pin: anyOf: - type: 'null' - - *544 + - *543 required: - url - html_url @@ -131745,8 +134403,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -132554,8 +135212,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -132572,7 +135230,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -132918,8 +135576,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -132999,7 +135657,7 @@ webhooks: type: string enum: - edited - changes: &754 + changes: &753 description: The changes to the comment. type: object properties: @@ -133011,9 +135669,9 @@ webhooks: type: string required: - from - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -133824,8 +136482,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -133842,7 +136500,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -134186,8 +136844,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -134268,9 +136926,9 @@ webhooks: type: string enum: - pinned - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -135083,8 +137741,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -135101,7 +137759,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -135447,8 +138105,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -135528,9 +138186,9 @@ webhooks: type: string enum: - unpinned - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -136343,8 +139001,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -136361,7 +139019,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -136707,8 +139365,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136797,9 +139455,9 @@ webhooks: type: number blocking_issue: *81 blocking_issue_repo: *77 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136888,9 +139546,9 @@ webhooks: type: number blocking_issue: *81 blocking_issue_repo: *77 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136978,9 +139636,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137069,9 +139727,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137151,10 +139809,10 @@ webhooks: type: string enum: - assigned - assignee: *726 - enterprise: *706 - installation: *707 - issue: &733 + assignee: *725 + enterprise: *705 + installation: *706 + issue: &732 title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -137965,11 +140623,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -137986,7 +140644,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -138089,8 +140747,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -138170,8 +140828,8 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -138987,11 +141645,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -139008,7 +141666,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -139254,8 +141912,8 @@ webhooks: required: - state - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -139334,8 +141992,8 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -140142,11 +142800,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -140163,7 +142821,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -140265,8 +142923,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -140345,8 +143003,8 @@ webhooks: type: string enum: - demilestoned - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -141176,11 +143834,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -141197,7 +143855,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -141278,7 +143936,7 @@ webhooks: format: uri user_view_type: type: string - milestone: &731 + milestone: &730 title: Milestone description: A collection of related issues and pull requests. type: object @@ -141421,8 +144079,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -141521,8 +144179,8 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -142333,11 +144991,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -142351,7 +145009,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -142457,9 +145115,9 @@ webhooks: - active_lock_reason - body - reactions - label: *725 - organization: *708 - repository: *709 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -142539,8 +145197,8 @@ webhooks: type: string enum: - labeled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -143350,11 +146008,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -143368,7 +146026,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -143474,9 +146132,9 @@ webhooks: - active_lock_reason - body - reactions - label: *725 - organization: *708 - repository: *709 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -143556,8 +146214,8 @@ webhooks: type: string enum: - locked - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -144392,11 +147050,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -144410,7 +147068,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -144493,8 +147151,8 @@ webhooks: format: uri user_view_type: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -144573,8 +147231,8 @@ webhooks: type: string enum: - milestoned - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -145403,11 +148061,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -145424,7 +148082,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -145504,9 +148162,9 @@ webhooks: format: uri user_view_type: type: string - milestone: *731 - organization: *708 - repository: *709 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -146393,11 +149051,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -146497,7 +149155,7 @@ webhooks: required: - login - id - type: *230 + type: *229 required: - id - number @@ -146989,8 +149647,8 @@ webhooks: required: - old_issue - old_repository - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -147797,11 +150455,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -147818,7 +150476,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -147924,8 +150582,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -148005,9 +150663,9 @@ webhooks: type: string enum: - pinned - enterprise: *706 - installation: *707 - issue: &732 + enterprise: *705 + installation: *706 + issue: &731 title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -148812,11 +151470,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -148833,7 +151491,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -148935,8 +151593,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -149015,8 +151673,8 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -149849,11 +152507,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -149950,9 +152608,9 @@ webhooks: format: uri user_view_type: type: string - type: *230 - organization: *708 - repository: *709 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -150840,11 +153498,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -150861,7 +153519,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -151454,11 +154112,11 @@ webhooks: required: - new_issue - new_repository - enterprise: *706 - installation: *707 - issue: *732 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *731 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151538,12 +154196,12 @@ webhooks: type: string enum: - typed - enterprise: *706 - installation: *707 - issue: *733 - type: *230 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151624,7 +154282,7 @@ webhooks: type: string enum: - unassigned - assignee: &757 + assignee: &756 title: User type: - object @@ -151696,11 +154354,11 @@ webhooks: required: - login - id - enterprise: *706 - installation: *707 - issue: *733 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151779,12 +154437,12 @@ webhooks: type: string enum: - unlabeled - enterprise: *706 - installation: *707 - issue: *733 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151864,8 +154522,8 @@ webhooks: type: string enum: - unlocked - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -152698,11 +155356,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -152719,7 +155377,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -152799,8 +155457,8 @@ webhooks: format: uri user_view_type: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152880,11 +155538,11 @@ webhooks: type: string enum: - unpinned - enterprise: *706 - installation: *707 - issue: *732 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *731 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152963,12 +155621,12 @@ webhooks: type: string enum: - untyped - enterprise: *706 - installation: *707 - issue: *733 - type: *230 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153048,11 +155706,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153130,11 +155788,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153244,11 +155902,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153330,9 +155988,9 @@ webhooks: - cancelled effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: &734 + enterprise: *705 + installation: *706 + marketplace_purchase: &733 title: Marketplace Purchase type: object required: @@ -153420,8 +156078,8 @@ webhooks: type: integer unit_count: type: integer - organization: *708 - previous_marketplace_purchase: &735 + organization: *707 + previous_marketplace_purchase: &734 title: Marketplace Purchase type: object properties: @@ -153505,7 +156163,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -153585,10 +156243,10 @@ webhooks: - changed effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -153676,7 +156334,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -153758,10 +156416,10 @@ webhooks: - pending_change effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -153847,7 +156505,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -153928,8 +156586,8 @@ webhooks: - pending_change_cancelled effective_date: type: string - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 marketplace_purchase: title: Marketplace Purchase type: object @@ -154015,9 +156673,9 @@ webhooks: type: integer unit_count: type: integer - organization: *708 - previous_marketplace_purchase: *735 - repository: *709 + organization: *707 + previous_marketplace_purchase: *734 + repository: *708 sender: *4 required: - action @@ -154097,12 +156755,12 @@ webhooks: - purchased effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 - previous_marketplace_purchase: *735 - repository: *709 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 + previous_marketplace_purchase: *734 + repository: *708 sender: *4 required: - action @@ -154204,11 +156862,11 @@ webhooks: type: string required: - to - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154310,11 +156968,11 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154393,11 +157051,11 @@ webhooks: type: string enum: - removed - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154475,11 +157133,11 @@ webhooks: type: string enum: - added - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 scope: description: The scope of the membership. Currently, can only be `team`. @@ -154557,7 +157215,7 @@ webhooks: required: - login - id - team: &736 + team: &735 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -154787,11 +157445,11 @@ webhooks: type: string enum: - removed - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 scope: description: The scope of the membership. Currently, can only be `team`. @@ -154870,7 +157528,7 @@ webhooks: required: - login - id - team: *736 + team: *735 required: - action - scope @@ -154952,8 +157610,8 @@ webhooks: type: string enum: - checks_requested - installation: *707 - merge_group: &737 + installation: *706 + merge_group: &736 type: object title: Merge Group description: A group of pull requests that the merge queue has grouped @@ -154972,15 +157630,15 @@ webhooks: description: The full ref of the branch the merge group will be merged into. type: string - head_commit: *406 + head_commit: *405 required: - head_sha - head_ref - base_sha - base_ref - head_commit - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155066,10 +157724,10 @@ webhooks: - merged - invalidated - dequeued - installation: *707 - merge_group: *737 - organization: *708 - repository: *709 + installation: *706 + merge_group: *736 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155142,7 +157800,7 @@ webhooks: type: string enum: - deleted - enterprise: *706 + enterprise: *705 hook: description: 'The deleted webhook. This will contain different keys based on the type of webhook it is: repository, organization, @@ -155251,12 +157909,12 @@ webhooks: hook_id: description: The id of the modified webhook. type: integer - installation: *707 - organization: *708 + installation: *706 + organization: *707 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -155336,11 +157994,11 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155419,9 +158077,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - milestone: &738 + enterprise: *705 + installation: *706 + milestone: &737 title: Milestone description: A collection of related issues and pull requests. type: object @@ -155563,8 +158221,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155643,11 +158301,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155757,11 +158415,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155841,11 +158499,11 @@ webhooks: type: string enum: - opened - enterprise: *706 - installation: *707 - milestone: *738 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *737 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155924,11 +158582,11 @@ webhooks: type: string enum: - blocked - blocked_user: *726 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + blocked_user: *725 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156007,11 +158665,11 @@ webhooks: type: string enum: - unblocked - blocked_user: *726 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + blocked_user: *725 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156090,9 +158748,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - membership: &739 + enterprise: *705 + installation: *706 + membership: &738 title: Membership description: The membership between the user and the organization. Not present when the action is `member_invited`. @@ -156202,8 +158860,8 @@ webhooks: - role - organization_url - user - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156281,11 +158939,11 @@ webhooks: type: string enum: - member_added - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156364,8 +159022,8 @@ webhooks: type: string enum: - member_invited - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 invitation: description: The invitation for the user or email if the action is `member_invited`. @@ -156487,10 +159145,10 @@ webhooks: - inviter - team_count - invitation_teams_url - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 - user: *726 + user: *725 required: - action - invitation @@ -156568,11 +159226,11 @@ webhooks: type: string enum: - member_removed - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156659,11 +159317,11 @@ webhooks: properties: from: type: string - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156740,9 +159398,9 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 package: description: Information about the package. type: object @@ -157265,7 +159923,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: &740 + items: &739 title: Ruby Gems metadata type: object properties: @@ -157362,7 +160020,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -157438,9 +160096,9 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 package: description: Information about the package. type: object @@ -157802,7 +160460,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *740 + items: *739 source_url: type: string format: uri @@ -157873,7 +160531,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -158053,12 +160711,12 @@ webhooks: - duration - created_at - updated_at - enterprise: *706 + enterprise: *705 id: type: integer - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - id @@ -158135,7 +160793,7 @@ webhooks: type: string enum: - approved - personal_access_token_request: &741 + personal_access_token_request: &740 title: Personal Access Token Request description: Details of a Personal Access Token Request. type: object @@ -158285,10 +160943,10 @@ webhooks: - token_expired - token_expires_at - token_last_used_at - enterprise: *706 - organization: *708 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158365,11 +161023,11 @@ webhooks: type: string enum: - cancelled - personal_access_token_request: *741 - enterprise: *706 - organization: *708 + personal_access_token_request: *740 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158445,11 +161103,11 @@ webhooks: type: string enum: - created - personal_access_token_request: *741 - enterprise: *706 - organization: *708 + personal_access_token_request: *740 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158524,11 +161182,11 @@ webhooks: type: string enum: - denied - personal_access_token_request: *741 - organization: *708 - enterprise: *706 + personal_access_token_request: *740 + organization: *707 + enterprise: *705 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158633,7 +161291,7 @@ webhooks: id: description: Unique identifier of the webhook. type: integer - last_response: *742 + last_response: *741 name: description: The type of webhook. The only valid value is 'web'. type: string @@ -158665,8 +161323,8 @@ webhooks: hook_id: description: The ID of the webhook that triggered the ping. type: integer - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 zen: description: Random string of GitHub zen. @@ -158911,10 +161569,10 @@ webhooks: - from required: - note - enterprise: *706 - installation: *707 - organization: *708 - project_card: &743 + enterprise: *705 + installation: *706 + organization: *707 + project_card: &742 title: Project Card type: object properties: @@ -159037,7 +161695,7 @@ webhooks: - creator - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -159118,11 +161776,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project_card: *743 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_card: *742 + repository: *708 sender: *4 required: - action @@ -159202,9 +161860,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 project_card: title: Project Card type: object @@ -159334,7 +161992,7 @@ webhooks: repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -159428,11 +162086,11 @@ webhooks: - from required: - note - enterprise: *706 - installation: *707 - organization: *708 - project_card: *743 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_card: *742 + repository: *708 sender: *4 required: - action @@ -159526,9 +162184,9 @@ webhooks: - from required: - column_id - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 project_card: allOf: - title: Project Card @@ -159725,7 +162383,7 @@ webhooks: type: string required: - after_id - repository: *709 + repository: *708 sender: *4 required: - action @@ -159805,10 +162463,10 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - organization: *708 - project: &745 + enterprise: *705 + installation: *706 + organization: *707 + project: &744 title: Project type: object properties: @@ -159935,7 +162593,7 @@ webhooks: - creator - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -160015,10 +162673,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project_column: &744 + enterprise: *705 + installation: *706 + organization: *707 + project_column: &743 title: Project Column type: object properties: @@ -160058,7 +162716,7 @@ webhooks: - name - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -160137,14 +162795,14 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -160233,11 +162891,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 + repository: *708 sender: *4 required: - action @@ -160317,11 +162975,11 @@ webhooks: type: string enum: - moved - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 + repository: *708 sender: *4 required: - action @@ -160401,11 +163059,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -160485,14 +163143,14 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - project: *745 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -160593,11 +163251,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -160676,11 +163334,11 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -160761,9 +163419,9 @@ webhooks: type: string enum: - closed - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -160844,9 +163502,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -160927,9 +163585,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161050,9 +163708,9 @@ webhooks: type: string to: type: string - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161135,7 +163793,7 @@ webhooks: type: string enum: - archived - changes: &749 + changes: &748 type: object properties: archived_at: @@ -161151,9 +163809,9 @@ webhooks: - string - 'null' format: date-time - installation: *707 - organization: *708 - projects_v2_item: &746 + installation: *706 + organization: *707 + projects_v2_item: &745 title: Projects v2 Item description: An item belonging to a project type: object @@ -161171,7 +163829,7 @@ webhooks: type: string description: The node ID of the content represented by this item. - content_type: *269 + content_type: *268 creator: *4 created_at: type: string @@ -161293,9 +163951,9 @@ webhooks: - 'null' to: type: string - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161377,9 +164035,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161460,9 +164118,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161567,7 +164225,7 @@ webhooks: oneOf: - type: string - type: integer - - &747 + - &746 title: Projects v2 Single Select Option description: An option for a single select field type: object @@ -161591,7 +164249,7 @@ webhooks: required: - id - name - - &748 + - &747 title: Projects v2 Iteration Setting description: An iteration setting for an iteration field type: object @@ -161631,8 +164289,8 @@ webhooks: oneOf: - type: string - type: integer + - *746 - *747 - - *748 type: - 'null' - string @@ -161655,9 +164313,9 @@ webhooks: - 'null' required: - body - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161754,9 +164412,9 @@ webhooks: type: - string - 'null' - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161839,10 +164497,10 @@ webhooks: type: string enum: - restored - changes: *749 - installation: *707 - organization: *708 - projects_v2_item: *746 + changes: *748 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161924,9 +164582,9 @@ webhooks: type: string enum: - reopened - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -162007,9 +164665,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -162090,9 +164748,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -162238,9 +164896,9 @@ webhooks: - string - 'null' format: date - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -162311,10 +164969,10 @@ webhooks: title: public event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - repository @@ -162391,13 +165049,13 @@ webhooks: type: string enum: - assigned - assignee: *726 - enterprise: *706 - installation: *707 - number: &751 + assignee: *725 + enterprise: *705 + installation: *706 + number: &750 description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -164768,7 +167426,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -164850,11 +167508,11 @@ webhooks: type: string enum: - auto_merge_disabled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -167218,7 +169876,7 @@ webhooks: - draft reason: type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -167300,11 +169958,11 @@ webhooks: type: string enum: - auto_merge_enabled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -169668,7 +172326,7 @@ webhooks: - draft reason: type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -169750,13 +172408,13 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: &752 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: &751 allOf: - - *565 + - *564 - type: object properties: allow_auto_merge: @@ -169818,7 +172476,7 @@ webhooks: Please use `squash_merge_commit_title` instead.** type: boolean default: false - repository: *709 + repository: *708 sender: *4 required: - action @@ -169899,12 +172557,12 @@ webhooks: type: string enum: - converted_to_draft - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -169984,11 +172642,11 @@ webhooks: type: string enum: - demilestoned - enterprise: *706 - milestone: *266 - number: *751 - organization: *708 - pull_request: &753 + enterprise: *705 + milestone: *265 + number: *750 + organization: *707 + pull_request: &752 title: Pull Request type: object properties: @@ -172337,7 +174995,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -172416,11 +175074,11 @@ webhooks: type: string enum: - dequeued - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -174788,7 +177446,7 @@ webhooks: - BRANCH_PROTECTIONS - GIT_TREE_INVALID - INVALID_MERGE_COMMIT - repository: *709 + repository: *708 sender: *4 required: - action @@ -174912,12 +177570,12 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -174997,11 +177655,11 @@ webhooks: type: string enum: - enqueued - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -177354,7 +180012,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -177434,11 +180092,11 @@ webhooks: type: string enum: - labeled - enterprise: *706 - installation: *707 - label: *725 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + label: *724 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -179808,7 +182466,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -179889,10 +182547,10 @@ webhooks: type: string enum: - locked - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -182260,7 +184918,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -182340,12 +184998,12 @@ webhooks: type: string enum: - milestoned - enterprise: *706 - milestone: *266 - number: *751 - organization: *708 - pull_request: *753 - repository: *709 + enterprise: *705 + milestone: *265 + number: *750 + organization: *707 + pull_request: *752 + repository: *708 sender: *4 required: - action @@ -182424,12 +185082,12 @@ webhooks: type: string enum: - opened - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -182510,12 +185168,12 @@ webhooks: type: string enum: - ready_for_review - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -182595,12 +185253,12 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -182975,9 +185633,9 @@ webhooks: - start_side - side - reactions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -185229,7 +187887,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -185309,7 +187967,7 @@ webhooks: type: string enum: - deleted - comment: &755 + comment: &754 title: Pull Request Review Comment description: The [comment](https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request) itself. @@ -185602,9 +188260,9 @@ webhooks: - start_side - side - reactions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -187844,7 +190502,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -187924,11 +190582,11 @@ webhooks: type: string enum: - edited - changes: *754 - comment: *755 - enterprise: *706 - installation: *707 - organization: *708 + changes: *753 + comment: *754 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -190171,7 +192829,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -190252,9 +192910,9 @@ webhooks: type: string enum: - dismissed - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -192509,7 +195167,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 review: description: The review that was affected. type: object @@ -192760,9 +195418,9 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -194876,8 +197534,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 - review: &756 + repository: *708 + review: &755 description: The review that was affected. type: object properties: @@ -195115,12 +197773,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -197489,7 +200147,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_reviewer: title: User type: @@ -197575,12 +200233,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -199956,7 +202614,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_team: title: Team description: Groups of organization members that gives permissions @@ -200151,12 +202809,12 @@ webhooks: type: string enum: - review_requested - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -202527,7 +205185,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_reviewer: title: User type: @@ -202614,12 +205272,12 @@ webhooks: type: string enum: - review_requested - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -204981,7 +207639,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_team: title: Team description: Groups of organization members that gives permissions @@ -205165,9 +207823,9 @@ webhooks: type: string enum: - submitted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -207425,8 +210083,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 - review: *756 + repository: *708 + review: *755 sender: *4 required: - action @@ -207506,9 +210164,9 @@ webhooks: type: string enum: - resolved - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -209661,7 +212319,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 sender: *4 thread: type: object @@ -210058,9 +212716,9 @@ webhooks: type: string enum: - unresolved - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -212196,7 +214854,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 sender: *4 thread: type: object @@ -212595,10 +215253,10 @@ webhooks: type: string before: type: string - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -214955,7 +217613,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -215037,11 +217695,11 @@ webhooks: type: string enum: - unassigned - assignee: *757 - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + assignee: *756 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -217413,7 +220071,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -217492,11 +220150,11 @@ webhooks: type: string enum: - unlabeled - enterprise: *706 - installation: *707 - label: *725 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + label: *724 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -219857,7 +222515,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -219938,10 +222596,10 @@ webhooks: type: string enum: - unlocked - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -222292,7 +224950,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -222495,7 +225153,7 @@ webhooks: deleted: description: Whether this push deleted the `ref`. type: boolean - enterprise: *706 + enterprise: *705 forced: description: Whether this push was a force push of the `ref`. type: boolean @@ -222590,8 +225248,8 @@ webhooks: - url - author - committer - installation: *707 - organization: *708 + installation: *706 + organization: *707 pusher: title: Committer description: Metaproperties for Git author/committer information. @@ -223190,9 +225848,9 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 registry_package: type: object properties: @@ -223669,7 +226327,7 @@ webhooks: type: string rubygems_metadata: type: array - items: *740 + items: *739 summary: type: string tag_name: @@ -223725,7 +226383,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -223803,9 +226461,9 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 registry_package: type: object properties: @@ -224117,7 +226775,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *740 + items: *739 summary: type: string tag_name: @@ -224167,7 +226825,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -224244,10 +226902,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - release: &758 + enterprise: *705 + installation: *706 + organization: *707 + release: &757 title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) object. @@ -224578,7 +227236,7 @@ webhooks: - updated_at - zipball_url - body - repository: *709 + repository: *708 sender: *4 required: - action @@ -224655,11 +227313,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -224776,11 +227434,11 @@ webhooks: type: boolean required: - to - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -224858,9 +227516,9 @@ webhooks: type: string enum: - prereleased - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 release: title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) @@ -225196,7 +227854,7 @@ webhooks: - string - 'null' format: uri - repository: *709 + repository: *708 sender: *4 required: - action @@ -225272,10 +227930,10 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - release: &759 + enterprise: *705 + installation: *706 + organization: *707 + release: &758 title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) object. @@ -225608,7 +228266,7 @@ webhooks: - string - 'null' format: uri - repository: *709 + repository: *708 sender: *4 required: - action @@ -225684,11 +228342,11 @@ webhooks: type: string enum: - released - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -225764,11 +228422,11 @@ webhooks: type: string enum: - unpublished - enterprise: *706 - installation: *707 - organization: *708 - release: *759 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *758 + repository: *708 sender: *4 required: - action @@ -225844,11 +228502,11 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_advisory: *629 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_advisory: *628 sender: *4 required: - action @@ -225924,11 +228582,11 @@ webhooks: type: string enum: - reported - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_advisory: *629 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_advisory: *628 sender: *4 required: - action @@ -226004,10 +228662,10 @@ webhooks: type: string enum: - archived - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226084,10 +228742,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226165,10 +228823,10 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226253,10 +228911,10 @@ webhooks: additionalProperties: true description: The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body. - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226371,10 +229029,10 @@ webhooks: - 'null' items: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226446,10 +229104,10 @@ webhooks: title: repository_import event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 status: type: string @@ -226530,10 +229188,10 @@ webhooks: type: string enum: - privatized - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226610,10 +229268,10 @@ webhooks: type: string enum: - publicized - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226707,10 +229365,10 @@ webhooks: - name required: - repository - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226790,11 +229448,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 sender: *4 required: - action @@ -226872,11 +229530,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 sender: *4 required: - action @@ -226954,11 +229612,11 @@ webhooks: type: string enum: - edited - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 changes: type: object properties: @@ -226977,16 +229635,16 @@ webhooks: properties: added: type: array - items: *282 + items: *281 deleted: type: array - items: *282 + items: *281 updated: type: array items: type: object properties: - condition: *282 + condition: *281 changes: type: object properties: @@ -227019,16 +229677,16 @@ webhooks: properties: added: type: array - items: *585 + items: *584 deleted: type: array - items: *585 + items: *584 updated: type: array items: type: object properties: - rule: *585 + rule: *584 changes: type: object properties: @@ -227265,10 +229923,10 @@ webhooks: - from required: - owner - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227346,10 +230004,10 @@ webhooks: type: string enum: - unarchived - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227427,7 +230085,7 @@ webhooks: type: string enum: - create - alert: &760 + alert: &759 title: Repository Vulnerability Alert Alert description: The security alert of the vulnerable dependency. type: object @@ -227552,10 +230210,10 @@ webhooks: enum: - auto_dismissed - open - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227765,10 +230423,10 @@ webhooks: type: string enum: - dismissed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227846,11 +230504,11 @@ webhooks: type: string enum: - reopen - alert: *760 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *759 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228052,10 +230710,10 @@ webhooks: enum: - fixed - open - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228133,17 +230791,17 @@ webhooks: type: string enum: - assigned - alert: &761 + alert: &760 type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri @@ -228248,10 +230906,10 @@ webhooks: - type: 'null' - *4 assignee: *4 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228329,11 +230987,11 @@ webhooks: type: string enum: - created - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228414,11 +231072,11 @@ webhooks: type: string enum: - created - alert: *761 - installation: *707 - location: *762 - organization: *708 - repository: *709 + alert: *760 + installation: *706 + location: *761 + organization: *707 + repository: *708 sender: *4 required: - location @@ -228656,11 +231314,11 @@ webhooks: type: string enum: - publicly_leaked - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228738,11 +231396,11 @@ webhooks: type: string enum: - reopened - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228820,11 +231478,11 @@ webhooks: type: string enum: - resolved - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228902,12 +231560,12 @@ webhooks: type: string enum: - unassigned - alert: *761 + alert: *760 assignee: *4 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228985,11 +231643,11 @@ webhooks: type: string enum: - validated - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229119,10 +231777,10 @@ webhooks: - organization - enterprise - - repository: *709 - enterprise: *706 - installation: *707 - organization: *708 + repository: *708 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -229200,11 +231858,11 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - security_advisory: &763 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + security_advisory: &762 description: The details of the security advisory, including summary, description, and severity. type: object @@ -229390,11 +232048,11 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - security_advisory: *763 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + security_advisory: *762 sender: *4 required: - action @@ -229467,10 +232125,10 @@ webhooks: type: string enum: - withdrawn - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 security_advisory: description: The details of the security advisory, including summary, description, and severity. @@ -229656,11 +232314,11 @@ webhooks: from: type: object properties: - security_and_analysis: *281 - enterprise: *706 - installation: *707 - organization: *708 - repository: *328 + security_and_analysis: *280 + enterprise: *705 + installation: *706 + organization: *707 + repository: *327 sender: *4 required: - changes @@ -229738,12 +232396,12 @@ webhooks: type: string enum: - cancelled - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: &764 + sponsorship: &763 type: object properties: created_at: @@ -230048,12 +232706,12 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - sponsorship @@ -230141,12 +232799,12 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -230223,17 +232881,17 @@ webhooks: type: string enum: - pending_cancellation - effective_date: &765 + effective_date: &764 description: The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - sponsorship @@ -230307,7 +232965,7 @@ webhooks: type: string enum: - pending_tier_change - changes: &766 + changes: &765 type: object properties: tier: @@ -230351,13 +233009,13 @@ webhooks: - from required: - tier - effective_date: *765 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + effective_date: *764 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -230434,13 +233092,13 @@ webhooks: type: string enum: - tier_changed - changes: *766 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + changes: *765 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -230514,10 +233172,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -230601,10 +233259,10 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -231038,15 +233696,15 @@ webhooks: type: - string - 'null' - enterprise: *706 + enterprise: *705 id: description: The unique identifier of the status. type: integer - installation: *707 + installation: *706 name: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 sha: description: The Commit SHA. @@ -231162,9 +233820,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -231254,9 +233912,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -231346,9 +234004,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -231438,9 +234096,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -231517,12 +234175,12 @@ webhooks: title: team_add event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - team: &767 + team: &766 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -231752,9 +234410,9 @@ webhooks: type: string enum: - added_to_repository - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -232224,7 +234882,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -232300,9 +234958,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -232772,7 +235430,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -232849,9 +235507,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -233321,7 +235979,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -233465,9 +236123,9 @@ webhooks: - from required: - permissions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -233937,7 +236595,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - changes @@ -234015,9 +236673,9 @@ webhooks: type: string enum: - removed_from_repository - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -234487,7 +237145,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -234563,10 +237221,10 @@ webhooks: type: string enum: - started - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -234639,17 +237297,17 @@ webhooks: title: workflow_dispatch event type: object properties: - enterprise: *706 + enterprise: *705 inputs: type: - object - 'null' additionalProperties: true - installation: *707 - organization: *708 + installation: *706 + organization: *707 ref: type: string - repository: *709 + repository: *708 sender: *4 workflow: type: string @@ -234731,10 +237389,10 @@ webhooks: type: string enum: - completed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: allOf: @@ -234990,7 +237648,7 @@ webhooks: type: string required: - conclusion - deployment: *481 + deployment: *480 required: - action - repository @@ -235069,10 +237727,10 @@ webhooks: type: string enum: - in_progress - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: allOf: @@ -235354,7 +238012,7 @@ webhooks: required: - status - steps - deployment: *481 + deployment: *480 required: - action - repository @@ -235433,10 +238091,10 @@ webhooks: type: string enum: - queued - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: type: object @@ -235582,7 +238240,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *481 + deployment: *480 required: - action - repository @@ -235661,10 +238319,10 @@ webhooks: type: string enum: - waiting - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: type: object @@ -235811,7 +238469,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *481 + deployment: *480 required: - action - repository @@ -235891,12 +238549,12 @@ webhooks: type: string enum: - completed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object @@ -236915,12 +239573,12 @@ webhooks: type: string enum: - in_progress - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object @@ -237924,12 +240582,12 @@ webhooks: type: string enum: - requested - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json index 536b5e0266..591abf09fb 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json @@ -195,6 +195,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -1310,12 +1314,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -2146,6 +2148,3298 @@ } } }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks": { + "get": { + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks/{task_id}": { + "get": { + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, "/app": { "get": { "summary": "Get the authenticated app", @@ -24830,6 +28124,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -26326,12 +29621,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -86834,10 +90127,7 @@ "type": "string" } } - }, - "required": [ - "include_claim_keys" - ] + } }, "examples": { "default": { @@ -102332,6 +105622,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -102435,8 +105730,347 @@ } } } + }, + "required": [ + "total_count" + ] + }, + "examples": { + "default": { + "value": { + "total_count": 1, + "deployment_records": [ + { + "id": 123, + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "logical_environment": "prod", + "physical_environment": "pacific-east", + "cluster": "moda-1", + "deployment_name": "prod-deployment", + "tags": { + "data": "sensitive" + }, + "created": "2011-01-26T19:14:43Z", + "updated_at": "2011-01-26T19:14:43Z", + "attestation_id": 456 + } + ] + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "artifact-metadata" + } + } + }, + "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { + "post": { + "summary": "Set cluster deployment records", + "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", + "tags": [ + "orgs" + ], + "operationId": "orgs/set-cluster-deployment-records", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "cluster", + "in": "path", + "description": "The cluster name.", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 128, + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "logical_environment": { + "type": "string", + "description": "The stage of the deployment.", + "minLength": 1, + "maxLength": 128 + }, + "physical_environment": { + "type": "string", + "description": "The physical region of the deployment.", + "maxLength": 128 + }, + "deployments": { + "type": "array", + "description": "The list of deployments to record.", + "maxItems": 1000, + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", + "minLength": 1, + "maxLength": 256 + }, + "digest": { + "type": "string", + "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", + "minLength": 71, + "maxLength": 71, + "pattern": "^sha256:[a-f0-9]{64}$" + }, + "version": { + "type": "string", + "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", + "maxLength": 100, + "x-multi-segment": true, + "examples": [ + "1.2.3" + ] + }, + "status": { + "type": "string", + "description": "The deployment status of the artifact.", + "default": "deployed", + "enum": [ + "deployed", + "decommissioned" + ] + }, + "deployment_name": { + "type": "string", + "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", + "minLength": 1, + "maxLength": 256 + }, + "github_repository": { + "type": "string", + "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", + "maxLength": 100, + "pattern": "^[A-Za-z0-9.\\-_]+$", + "examples": [ + "my-github-repo" + ] + }, + "tags": { + "type": "object", + "description": "Key-value pairs to tag the deployment record.", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + } + }, + "required": [ + "name", + "deployment_name", + "digest" + ] + } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, + "required": [ + "logical_environment", + "deployments" + ] + }, + "examples": { + "default": { + "value": { + "logical_environment": "prod", + "physical_environment": "pacific-east", + "deployments": [ + { + "name": "awesome-image", + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "version": "2.1.0", + "status": "deployed", + "deployment_name": "deployment-pod", + "tags": { + "runtime-risk": "sensitive-data" + } + } + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Deployment records created or updated successfully.\n", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "total_count": { + "description": "The number of deployment records created", + "type": "integer" + }, + "deployment_records": { + "type": "array", + "items": { + "title": "Artifact Deployment Record", + "description": "Artifact Metadata Deployment Record", + "type": "object", + "properties": { + "id": { + "type": "integer" + }, + "digest": { + "type": "string" + }, + "logical_environment": { + "type": "string" + }, + "physical_environment": { + "type": "string" + }, + "cluster": { + "type": "string" + }, + "deployment_name": { + "type": "string" + }, + "tags": { + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + }, + "created_at": { + "type": "string" + }, + "updated_at": { + "type": "string" + }, + "attestation_id": { + "type": [ + "integer", + "null" + ], + "description": "The ID of the provenance attestation associated with the deployment record." + } + } + } + } + }, + "required": [ + "total_count" + ] + }, "examples": { "default": { "value": { @@ -102485,332 +106119,17 @@ "type": "string" } } - } - } - } - }, - "404": { - "description": "Resource not found", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "artifact-metadata" - } - } - }, - "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { - "post": { - "summary": "Set cluster deployment records", - "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", - "tags": [ - "orgs" - ], - "operationId": "orgs/set-cluster-deployment-records", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "cluster", - "in": "path", - "description": "The cluster name.", - "required": true, - "schema": { - "type": "string", - "minLength": 1, - "maxLength": 128, - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "logical_environment": { - "type": "string", - "description": "The stage of the deployment.", - "minLength": 1, - "maxLength": 128 - }, - "physical_environment": { - "type": "string", - "description": "The physical region of the deployment.", - "maxLength": 128 - }, - "deployments": { - "type": "array", - "description": "The list of deployments to record.", - "maxItems": 1000, - "items": { - "type": "object", - "properties": { - "name": { - "type": "string", - "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", - "minLength": 1, - "maxLength": 256 - }, - "digest": { - "type": "string", - "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", - "minLength": 71, - "maxLength": 71, - "pattern": "^sha256:[a-f0-9]{64}$" - }, - "version": { - "type": "string", - "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", - "maxLength": 100, - "x-multi-segment": true, - "examples": [ - "1.2.3" - ] - }, - "status": { - "type": "string", - "description": "The deployment status of the artifact.", - "default": "deployed", - "enum": [ - "deployed", - "decommissioned" - ] - }, - "deployment_name": { - "type": "string", - "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", - "minLength": 1, - "maxLength": 256 - }, - "github_repository": { - "type": "string", - "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", - "maxLength": 100, - "pattern": "^[A-Za-z0-9.\\-_]+$", - "examples": [ - "my-github-repo" - ] - }, - "tags": { - "type": "object", - "description": "Key-value pairs to tag the deployment record.", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - } - }, - "required": [ - "name", - "deployment_name", - "digest" - ] - } - } - }, - "required": [ - "logical_environment", - "deployments" - ] - }, - "examples": { - "default": { - "value": { - "logical_environment": "prod", - "physical_environment": "pacific-east", - "deployments": [ - { - "name": "awesome-image", - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "version": "2.1.0", - "status": "deployed", - "deployment_name": "deployment-pod", - "tags": { - "runtime-risk": "sensitive-data" - } - } - ] - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Deployment records created or updated successfully.\n", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "total_count": { - "description": "The number of deployment records created", - "type": "integer" - }, - "deployment_records": { - "type": "array", - "items": { - "title": "Artifact Deployment Record", - "description": "Artifact Metadata Deployment Record", - "type": "object", - "properties": { - "id": { - "type": "integer" - }, - "digest": { - "type": "string" - }, - "logical_environment": { - "type": "string" - }, - "physical_environment": { - "type": "string" - }, - "cluster": { - "type": "string" - }, - "deployment_name": { - "type": "string" - }, - "tags": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - }, - "created_at": { - "type": "string" - }, - "updated_at": { - "type": "string" - }, - "attestation_id": { - "type": [ - "integer", - "null" - ], - "description": "The ID of the provenance attestation associated with the deployment record." - } - } - } - } - } }, "examples": { - "default": { + "insufficient_repo_permissions": { "value": { - "total_count": 1, - "deployment_records": [ - { - "id": 123, - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "logical_environment": "prod", - "physical_environment": "pacific-east", - "cluster": "moda-1", - "deployment_name": "prod-deployment", - "tags": { - "data": "sensitive" - }, - "created": "2011-01-26T19:14:43Z", - "updated_at": "2011-01-26T19:14:43Z", - "attestation_id": 456 - } - ] - } - } - } - } - } - }, - "403": { - "description": "Forbidden", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } } } } @@ -102967,6 +106286,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -103046,7 +106370,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -126056,6 +129383,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -127552,12 +130880,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -169467,7 +172793,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -170258,7 +173584,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -230783,6 +234109,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -230876,6 +234210,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -230893,6 +234235,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -230910,6 +234260,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -230978,6 +234336,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -230995,6 +234361,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -231012,6 +234386,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -231029,6 +234411,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -231046,6 +234436,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -236667,338 +240065,364 @@ }, "network_settings_ids": { "type": "array", - "minItems": 1, + "minItems": 1, + "maxItems": 1, + "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." + } + }, + "required": [ + "name", + "network_settings_ids" + ] + }, + "examples": { + "default": { + "value": { + "name": "my-network-configuration", + "network_settings_ids": [ + "23456789ABDCEF1" + ], + "compute_service": "actions" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "network-configurations" + } + } + }, + "/orgs/{org}/settings/network-configurations/{network_configuration_id}": { + "get": { + "summary": "Get a hosted compute network configuration for an organization", + "description": "Gets a hosted compute network configuration configured in an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `read:network_configurations` scope to use this endpoint.", + "tags": [ + "hosted-compute" + ], + "operationId": "hosted-compute/get-network-configuration-for-org", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + }, + "headers": { + "Link": { + "example": "; rel=\"next\", ; rel=\"last\"", + "schema": { + "type": "string" + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "network-configurations" + } + }, + "patch": { + "summary": "Update a hosted compute network configuration for an organization", + "description": "Updates a hosted compute network configuration for an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `write:network_configurations` scope to use this endpoint.", + "tags": [ + "hosted-compute" + ], + "operationId": "hosted-compute/update-network-configuration-for-org", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.", + "type": "string" + }, + "compute_service": { + "description": "The hosted compute service to use for the network configuration.", + "type": "string", + "enum": [ + "none", + "actions" + ] + }, + "network_settings_ids": { + "type": "array", + "minItems": 0, "maxItems": 1, "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } - } - }, - "required": [ - "name", - "network_settings_ids" - ] - }, - "examples": { - "default": { - "value": { - "name": "my-network-configuration", - "network_settings_ids": [ - "23456789ABDCEF1" - ], - "compute_service": "actions" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "network-configurations" - } - } - }, - "/orgs/{org}/settings/network-configurations/{network_configuration_id}": { - "get": { - "summary": "Get a hosted compute network configuration for an organization", - "description": "Gets a hosted compute network configuration configured in an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `read:network_configurations` scope to use this endpoint.", - "tags": [ - "hosted-compute" - ], - "operationId": "hosted-compute/get-network-configuration-for-org", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } - }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - }, - "headers": { - "Link": { - "example": "; rel=\"next\", ; rel=\"last\"", - "schema": { - "type": "string" - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "network-configurations" - } - }, - "patch": { - "summary": "Update a hosted compute network configuration for an organization", - "description": "Updates a hosted compute network configuration for an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `write:network_configurations` scope to use this endpoint.", - "tags": [ - "hosted-compute" - ], - "operationId": "hosted-compute/update-network-configuration-for-org", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "name": { - "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.", - "type": "string" - }, - "compute_service": { - "description": "The hosted compute service to use for the network configuration.", - "type": "string", - "enum": [ - "none", - "actions" - ] - }, - "network_settings_ids": { + "failover_network_settings_ids": { "type": "array", "minItems": 0, "maxItems": 1, - "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -370490,6 +373914,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -371434,12 +374859,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -371951,6 +375374,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -372904,12 +376328,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", @@ -373241,6 +376663,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -607941,6 +611364,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -608034,6 +611465,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -608051,6 +611490,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -608068,6 +611515,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -608136,6 +611591,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -608153,6 +611616,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -608170,6 +611641,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -608187,6 +611666,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -608204,6 +611691,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -609352,6 +612847,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -609445,6 +612948,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -609462,6 +612973,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -609479,6 +612998,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -609547,6 +613074,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -609564,6 +613099,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -609581,6 +613124,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -609598,6 +613149,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -609615,6 +613174,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -610746,6 +614313,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -610839,6 +614414,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -610856,6 +614439,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -610873,6 +614464,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -610941,6 +614540,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -610958,6 +614565,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -610975,6 +614590,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -610992,6 +614615,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -611009,6 +614640,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -611454,6 +615093,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -611547,6 +615194,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -611564,6 +615219,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -611581,6 +615244,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -611649,6 +615320,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -611666,6 +615345,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -611683,6 +615370,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -611700,6 +615395,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -611717,6 +615420,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -898670,6 +902381,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -901614,6 +905326,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -904558,6 +908271,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -907502,6 +911216,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -910446,6 +914161,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -913390,6 +917106,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -916334,6 +920051,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -919278,6 +922996,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1542309,6 +1546028,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -1542402,6 +1546129,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1542419,6 +1546154,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1542436,6 +1546179,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -1542504,6 +1546255,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1542521,6 +1546280,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1542538,6 +1546305,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -1542555,6 +1546330,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -1542572,6 +1546355,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml index 5da299486f..0c8ad7301c 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml @@ -103,6 +103,8 @@ tags: description: Endpoints to manage campaigns via the REST API. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -874,7 +876,7 @@ paths: - subscriptions_url - type - url - type: &314 + type: &313 type: string description: The type of credit the user is receiving. enum: @@ -962,7 +964,7 @@ paths: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -1039,7 +1041,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory parameters: - - &631 + - &630 name: ghsa_id description: The GHSA (GitHub Security Advisory) identifier of the advisory. in: path @@ -1129,6 +1131,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -1624,7 +4141,7 @@ paths: schema: type: integer default: 30 - - &204 + - &203 name: cursor description: 'Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the `link` header for the next and previous @@ -1633,7 +4150,7 @@ paths: required: false schema: type: string - - &205 + - &204 name: status description: Returns webhook deliveries filtered by delivery outcome classification based on `status_code` range. A `status` of `success` returns deliveries @@ -1653,7 +4170,7 @@ paths: application/json: schema: type: array - items: &206 + items: &205 title: Simple webhook delivery description: Delivery made by a webhook, without request and response information. @@ -1749,7 +4266,7 @@ paths: - installation_id - repository_id examples: - default: &207 + default: &206 value: - id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -1884,7 +4401,7 @@ paths: description: Response content: application/json: - schema: &208 + schema: &207 title: Webhook delivery description: Delivery made by a webhook. type: object @@ -2019,7 +4536,7 @@ paths: - request - response examples: - default: &209 + default: &208 value: id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -8274,7 +10791,7 @@ paths: description: Response content: application/json: - schema: &182 + schema: &181 type: array description: A list of default code security configurations items: @@ -8290,7 +10807,7 @@ paths: default configuration: *47 examples: - default: &183 + default: &182 value: - default_for_new_repos: public configuration: @@ -8630,7 +11147,7 @@ paths: - *38 - *49 responses: - '204': &184 + '204': &183 description: A header with no content is returned. '400': *14 '403': *27 @@ -8757,7 +11274,7 @@ paths: default: value: default_for_new_repos: all - configuration: &181 + configuration: &180 value: id: 1325 target_type: organization @@ -8842,7 +11359,7 @@ paths: application/json: schema: type: array - items: &185 + items: &184 type: object description: Repositories associated with a code security configuration and attachment status @@ -9187,7 +11704,7 @@ paths: summary: Example of code security configuration repositories value: - status: attached - repository: &186 + repository: &185 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -9488,7 +12005,7 @@ paths: url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-an-enterprise parameters: - *38 - - &190 + - &189 name: state in: query description: |- @@ -9497,7 +12014,7 @@ paths: Can be: `auto_dismissed`, `dismissed`, `fixed`, `open` schema: type: string - - &191 + - &190 name: severity in: query description: |- @@ -9506,7 +12023,7 @@ paths: Can be: `low`, `medium`, `high`, `critical` schema: type: string - - &192 + - &191 name: ecosystem in: query description: |- @@ -9515,14 +12032,14 @@ paths: Can be: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust` schema: type: string - - &193 + - &192 name: package in: query description: A comma-separated list of package names. If specified, only alerts for these packages will be returned. schema: type: string - - &194 + - &193 name: epss_percentage in: query description: |- @@ -9534,7 +12051,7 @@ paths: Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. schema: type: string - - &471 + - &470 name: has in: query description: |- @@ -9548,7 +12065,7 @@ paths: type: string enum: - patch - - &195 + - &194 name: assignee in: query description: |- @@ -9557,7 +12074,7 @@ paths: Use `*` to list alerts with at least one assignee or `none` to list alerts with no assignees. schema: type: string - - &196 + - &195 name: scope in: query description: The scope of the vulnerable dependency. If specified, only alerts @@ -9567,7 +12084,7 @@ paths: enum: - development - runtime - - &197 + - &196 name: sort in: query description: |- @@ -9593,11 +12110,11 @@ paths: application/json: schema: type: array - items: &198 + items: &197 type: object description: A Dependabot alert. properties: - number: &171 + number: &170 type: integer description: The security alert number. readOnly: true @@ -9662,8 +12179,9 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: &472 + security_advisory: &471 type: object description: Details for the GitHub Security Advisory. readOnly: true @@ -9847,29 +12365,29 @@ paths: - withdrawn_at additionalProperties: false security_vulnerability: *63 - url: &174 + url: &173 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &175 + html_url: &174 type: string description: The GitHub URL of the alert resource. format: uri readOnly: true - created_at: &172 + created_at: &171 type: string description: 'The time that the alert was created in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - updated_at: &173 + updated_at: &172 type: string description: 'The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissed_at: &177 + dismissed_at: &176 type: - string - 'null' @@ -9900,7 +12418,7 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: &176 + fixed_at: &175 type: - string - 'null' @@ -9908,7 +12426,7 @@ paths: and was considered fixed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - auto_dismissed_at: &473 + auto_dismissed_at: &472 type: - string - 'null' @@ -9916,7 +12434,7 @@ paths: ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissal_request: &474 + dismissal_request: &473 title: Dependabot alert dismissal request description: Information about an active dismissal request for this Dependabot alert. @@ -9979,7 +12497,7 @@ paths: - repository additionalProperties: false examples: - default: &199 + default: &198 value: - number: 2 state: dismissed @@ -10028,7 +12546,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -11343,7 +13861,7 @@ paths: properties: action: type: string - discussion: &722 + discussion: &721 title: Discussion description: A Discussion in a repository. type: object @@ -11840,7 +14358,7 @@ paths: milestone: anyOf: - type: 'null' - - &266 + - &265 title: Milestone description: A collection of related issues and pull requests. @@ -12017,7 +14535,7 @@ paths: timeline_url: type: string format: uri - type: &230 + type: &229 title: Issue Type description: The type of issue. type: @@ -12128,7 +14646,7 @@ paths: - hooray - eyes - rocket - sub_issues_summary: &643 + sub_issues_summary: &642 title: Sub-issues Summary type: object properties: @@ -12212,7 +14730,7 @@ paths: pin: anyOf: - type: 'null' - - &544 + - &543 title: Pinned Issue Comment description: Context around who pinned an issue comment and when it was pinned. @@ -12239,7 +14757,7 @@ paths: - url - created_at - updated_at - issue_dependencies_summary: &644 + issue_dependencies_summary: &643 title: Issue Dependencies Summary type: object properties: @@ -12258,7 +14776,7 @@ paths: - total_blocking issue_field_values: type: array - items: &529 + items: &528 title: Issue Field Value description: A value assigned to an issue field type: object @@ -13038,7 +15556,7 @@ paths: type: string release: allOf: - - &576 + - &575 title: Release description: A release. type: object @@ -13120,7 +15638,7 @@ paths: author: *4 assets: type: array - items: &577 + items: &576 title: Release Asset description: Data related to a release. type: object @@ -15384,7 +17902,7 @@ paths: - closed - all default: open - - &233 + - &232 name: labels description: 'A list of comma separated label names. Example: `bug,ui,@high`' in: query @@ -15435,7 +17953,7 @@ paths: type: array items: *81 examples: - default: &234 + default: &233 value: - id: 1 node_id: MDU6SXNzdWUx @@ -16847,14 +19365,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/events#list-public-events-for-a-network-of-repositories parameters: - - &325 + - &324 name: owner description: The account owner of the repository. The name is not case sensitive. in: path required: true schema: type: string - - &326 + - &325 name: repo description: The name of the repository without the `.git` extension. The name is not case sensitive. @@ -16916,7 +19434,7 @@ paths: '404': *6 '403': *27 '304': *35 - '301': &329 + '301': &328 description: Moved permanently content: application/json: @@ -16938,7 +19456,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#list-notifications-for-the-authenticated-user parameters: - - &552 + - &551 name: all description: If `true`, show notifications marked as read. in: query @@ -16946,7 +19464,7 @@ paths: schema: type: boolean default: false - - &553 + - &552 name: participating description: If `true`, only shows notifications in which the user is directly participating or mentioned. @@ -16956,7 +19474,7 @@ paths: type: boolean default: false - *86 - - &554 + - &553 name: before description: 'Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: @@ -16988,7 +19506,7 @@ paths: properties: id: type: string - repository: &153 + repository: &152 title: Minimal Repository description: Minimal Repository type: object @@ -17336,7 +19854,7 @@ paths: type: boolean examples: - false - security_and_analysis: &281 + security_and_analysis: &280 type: - object - 'null' @@ -17540,7 +20058,7 @@ paths: - url - subscription_url examples: - default: &555 + default: &554 value: - id: '1' repository: @@ -19110,7 +21628,7 @@ paths: required: false schema: type: string - - &699 + - &698 name: model description: The model name to query usage for. The name is not case sensitive. in: query @@ -19256,7 +21774,7 @@ paths: parameters: - *73 - *115 - - &700 + - &699 name: month description: If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the @@ -19368,7 +21886,7 @@ paths: - *115 - *117 - *116 - - &701 + - &700 name: repository description: The repository name to query for usage in the format owner/repository. in: query @@ -19376,7 +21894,7 @@ paths: schema: type: string - *118 - - &702 + - &701 name: sku description: The SKU to query for usage. in: query @@ -20345,7 +22863,7 @@ paths: type: integer repository_cache_usages: type: array - items: &336 + items: &335 title: Actions Cache Usage by repository description: GitHub Actions Cache Usage by repository. type: object @@ -20593,7 +23111,7 @@ paths: - public_ip_enabled - platform examples: - default: &152 + default: &151 value: total_count: 2 runners: @@ -21588,7 +24106,7 @@ paths: description: A JSON serialized template for OIDC subject claim customization content: application/json: - schema: &135 + schema: title: Actions OIDC Subject customization description: Actions OIDC Subject customization type: object @@ -21602,7 +24120,7 @@ paths: required: - include_claim_keys examples: - default: &136 + default: &135 value: include_claim_keys: - repo @@ -21629,15 +24147,25 @@ paths: required: true content: application/json: - schema: *135 + schema: + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: - default: *136 + default: *135 responses: '201': description: Empty response content: application/json: - schema: &162 + schema: &161 title: Empty Object description: An object without any properties. type: object @@ -21676,7 +24204,7 @@ paths: schema: type: object properties: - enabled_repositories: &137 + enabled_repositories: &136 type: string description: The policy that controls the repositories in the organization that are allowed to run GitHub Actions. @@ -21689,7 +24217,7 @@ paths: description: The API URL to use to get or set the selected repositories that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`. - allowed_actions: &138 + allowed_actions: &137 type: string description: The permissions policy that controls the actions and reusable workflows that are allowed to run. @@ -21697,12 +24225,12 @@ paths: - all - local_only - selected - selected_actions_url: &342 + selected_actions_url: &341 type: string description: The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` is set to `selected`. - sha_pinning_required: &139 + sha_pinning_required: &138 type: boolean description: Whether actions must be pinned to a full-length commit SHA. @@ -21744,9 +24272,9 @@ paths: schema: type: object properties: - enabled_repositories: *137 - allowed_actions: *138 - sha_pinning_required: *139 + enabled_repositories: *136 + allowed_actions: *137 + sha_pinning_required: *138 required: - enabled_repositories examples: @@ -21780,7 +24308,7 @@ paths: description: Response content: application/json: - schema: &346 + schema: &345 type: object properties: days: @@ -21822,7 +24350,7 @@ paths: required: true content: application/json: - schema: &347 + schema: &346 type: object properties: days: @@ -21865,7 +24393,7 @@ paths: description: Response content: application/json: - schema: &140 + schema: &139 type: object properties: approval_policy: @@ -21879,7 +24407,7 @@ paths: required: - approval_policy examples: - default: &348 + default: &347 value: approval_policy: first_time_contributors '404': *6 @@ -21910,7 +24438,7 @@ paths: required: true content: application/json: - schema: *140 + schema: *139 examples: default: summary: Set approval policy to first time contributors @@ -21938,7 +24466,7 @@ paths: description: Response content: application/json: - schema: &349 + schema: &348 type: object required: - run_workflows_from_fork_pull_requests @@ -21964,7 +24492,7 @@ paths: description: Whether workflows triggered by pull requests from forks require approval from a repository administrator to run. examples: - default: &141 + default: &140 value: run_workflows_from_fork_pull_requests: true send_write_tokens_to_workflows: false @@ -21992,7 +24520,7 @@ paths: required: true content: application/json: - schema: &350 + schema: &349 type: object required: - run_workflows_from_fork_pull_requests @@ -22015,7 +24543,7 @@ paths: description: Whether workflows triggered by pull requests from forks require approval from a repository administrator to run. examples: - default: *141 + default: *140 responses: '204': description: Empty response for successful settings update @@ -22065,7 +24593,7 @@ paths: type: array items: *77 examples: - default: &145 + default: &144 value: total_count: 1 repositories: @@ -22250,7 +24778,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization parameters: - *73 - - &142 + - &141 name: repository_id description: The unique identifier of the repository. in: path @@ -22279,7 +24807,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -22308,7 +24836,7 @@ paths: description: Response content: application/json: - schema: &143 + schema: &142 type: object properties: github_owned_allowed: @@ -22330,7 +24858,7 @@ paths: items: type: string examples: - default: &144 + default: &143 value: github_owned_allowed: true verified_allowed: false @@ -22363,9 +24891,9 @@ paths: required: false content: application/json: - schema: *143 + schema: *142 examples: - selected_actions: *144 + selected_actions: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -22497,7 +25025,7 @@ paths: type: array items: *77 examples: - default: *145 + default: *144 '403': *27 '404': *6 x-github: @@ -22566,7 +25094,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#add-a-repository-to-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No content @@ -22593,7 +25121,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#remove-a-repository-from-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No content @@ -22627,17 +25155,17 @@ paths: description: Response content: application/json: - schema: &351 + schema: &350 type: object properties: - default_workflow_permissions: &146 + default_workflow_permissions: &145 type: string description: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. enum: - read - write - can_approve_pull_request_reviews: &147 + can_approve_pull_request_reviews: &146 type: boolean description: Whether GitHub Actions can approve pull requests. Enabling this can be a security risk. @@ -22645,7 +25173,7 @@ paths: - default_workflow_permissions - can_approve_pull_request_reviews examples: - default: &148 + default: &147 summary: Give read-only permission, and allow approving PRs. value: default_workflow_permissions: read @@ -22678,13 +25206,13 @@ paths: required: false content: application/json: - schema: &352 + schema: &351 type: object properties: - default_workflow_permissions: *146 - can_approve_pull_request_reviews: *147 + default_workflow_permissions: *145 + can_approve_pull_request_reviews: *146 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -22729,7 +25257,7 @@ paths: type: number runner_groups: type: array - items: &149 + items: &148 type: object properties: id: @@ -22919,9 +25447,9 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: - default: &151 + default: &150 value: id: 2 name: octo-runner-group @@ -22957,7 +25485,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#get-a-self-hosted-runner-group-for-an-organization parameters: - *73 - - &150 + - &149 name: runner_group_id description: Unique identifier of the self-hosted runner group. in: path @@ -22969,7 +25497,7 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: default: value: @@ -23006,7 +25534,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#update-a-self-hosted-runner-group-for-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -23062,9 +25590,9 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: - default: *151 + default: *150 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -23084,7 +25612,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#delete-a-self-hosted-runner-group-from-an-organization parameters: - *73 - - *150 + - *149 responses: '204': description: Response @@ -23108,7 +25636,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-github-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 - *17 - *19 responses: @@ -23128,7 +25656,7 @@ paths: type: array items: *123 examples: - default: *152 + default: *151 headers: Link: *65 x-github: @@ -23151,7 +25679,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 + - *149 - *19 - *17 responses: @@ -23169,9 +25697,9 @@ paths: type: number repositories: type: array - items: *153 + items: *152 examples: - default: &189 + default: &188 value: total_count: 1 repositories: @@ -23424,7 +25952,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#set-repository-access-for-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -23469,8 +25997,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#add-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 - - *142 + - *149 + - *141 responses: '204': description: Response @@ -23493,8 +26021,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#remove-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 - - *142 + - *149 + - *141 responses: '204': description: Response @@ -23518,7 +26046,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-self-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 - *17 - *19 responses: @@ -23536,7 +26064,7 @@ paths: type: number runners: type: array - items: &155 + items: &154 title: Self hosted runners description: A self hosted runner type: object @@ -23570,7 +26098,7 @@ paths: type: boolean labels: type: array - items: &158 + items: &157 title: Self hosted runner label description: A label for a self hosted runner type: object @@ -23600,7 +26128,7 @@ paths: - busy - labels examples: - default: &156 + default: &155 value: total_count: 2 runners: @@ -23660,7 +26188,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#set-self-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -23705,8 +26233,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#add-a-self-hosted-runner-to-a-group-for-an-organization parameters: - *73 - - *150 - - &154 + - *149 + - &153 name: runner_id description: Unique identifier of the self-hosted runner. in: path @@ -23735,8 +26263,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#remove-a-self-hosted-runner-from-a-group-for-an-organization parameters: - *73 - - *150 - - *154 + - *149 + - *153 responses: '204': description: Response @@ -23784,9 +26312,9 @@ paths: type: integer runners: type: array - items: *155 + items: *154 examples: - default: *156 + default: *155 headers: Link: *65 x-github: @@ -23818,7 +26346,7 @@ paths: application/json: schema: type: array - items: &353 + items: &352 title: Runner Application description: Runner Application type: object @@ -23843,7 +26371,7 @@ paths: - download_url - filename examples: - default: &354 + default: &353 value: - os: osx architecture: x64 @@ -23929,7 +26457,7 @@ paths: - no-gpu work_folder: _work responses: - '201': &355 + '201': &354 description: Response content: application/json: @@ -23939,7 +26467,7 @@ paths: - runner - encoded_jit_config properties: - runner: *155 + runner: *154 encoded_jit_config: type: string description: The base64 encoded runner configuration. @@ -24002,7 +26530,7 @@ paths: description: Response content: application/json: - schema: &157 + schema: &156 title: Authentication Token description: Authentication Token type: object @@ -24044,7 +26572,7 @@ paths: - token - expires_at examples: - default: &356 + default: &355 value: token: LLBF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-22T12:13:35.123-08:00' @@ -24081,9 +26609,9 @@ paths: description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: &357 + default: &356 value: token: AABF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-29T12:13:35.123-08:00' @@ -24109,15 +26637,15 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: '200': description: Response content: application/json: - schema: *155 + schema: *154 examples: - default: &358 + default: &357 value: id: 23 name: MBP @@ -24159,7 +26687,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-an-organization parameters: - *73 - - *154 + - *153 responses: '204': description: Response @@ -24186,9 +26714,9 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: - '200': &159 + '200': &158 description: Response content: application/json: @@ -24202,7 +26730,7 @@ paths: type: integer labels: type: array - items: *158 + items: *157 examples: default: value: @@ -24242,7 +26770,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 requestBody: required: true content: @@ -24266,7 +26794,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24291,7 +26819,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 requestBody: required: true content: @@ -24316,7 +26844,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24341,9 +26869,9 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: - '200': &359 + '200': &358 description: Response content: application/json: @@ -24357,7 +26885,7 @@ paths: type: integer labels: type: array - items: *158 + items: *157 examples: default: value: @@ -24399,8 +26927,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 - - &360 + - *153 + - &359 name: name description: The name of a self-hosted runner's custom label. in: path @@ -24408,7 +26936,7 @@ paths: schema: type: string responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24451,7 +26979,7 @@ paths: type: integer secrets: type: array - items: &160 + items: &159 title: Actions Secret for an Organization description: Secrets for GitHub Actions for an organization. type: object @@ -24532,7 +27060,7 @@ paths: description: Response content: application/json: - schema: &372 + schema: &371 title: ActionsPublicKey description: The public key used for setting Actions Secrets. type: object @@ -24567,7 +27095,7 @@ paths: - key_id - key examples: - default: &373 + default: &372 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -24593,7 +27121,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#get-an-organization-secret parameters: - *73 - - &161 + - &160 name: secret_name description: The name of the secret. in: path @@ -24605,7 +27133,7 @@ paths: description: Response content: application/json: - schema: *160 + schema: *159 examples: default: value: @@ -24636,7 +27164,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -24693,7 +27221,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -24720,7 +27248,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -24747,7 +27275,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -24765,9 +27293,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: &165 + default: &164 value: total_count: 1 repositories: @@ -24860,7 +27388,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -24913,7 +27441,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -24947,7 +27475,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -24980,7 +27508,7 @@ paths: url: https://docs.github.com/rest/actions/variables#list-organization-variables parameters: - *73 - - &341 + - &340 name: per_page description: The number of results per page (max 30). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -25004,7 +27532,7 @@ paths: type: integer variables: type: array - items: &163 + items: &162 title: Actions Variable for an Organization description: Organization variable for GitHub Actions. type: object @@ -25142,7 +27670,7 @@ paths: description: Response when creating a variable content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -25168,7 +27696,7 @@ paths: url: https://docs.github.com/rest/actions/variables#get-an-organization-variable parameters: - *73 - - &164 + - &163 name: name description: The name of the variable. in: path @@ -25180,7 +27708,7 @@ paths: description: Response content: application/json: - schema: *163 + schema: *162 examples: default: value: @@ -25211,7 +27739,7 @@ paths: url: https://docs.github.com/rest/actions/variables#update-an-organization-variable parameters: - *73 - - *164 + - *163 requestBody: required: true content: @@ -25274,7 +27802,7 @@ paths: url: https://docs.github.com/rest/actions/variables#delete-an-organization-variable parameters: - *73 - - *164 + - *163 responses: '204': description: Response @@ -25301,7 +27829,7 @@ paths: url: https://docs.github.com/rest/actions/variables#list-selected-repositories-for-an-organization-variable parameters: - *73 - - *164 + - *163 - *19 - *17 responses: @@ -25319,9 +27847,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 '409': description: Response when the visibility of the variable is not set to `selected` @@ -25348,7 +27876,7 @@ paths: url: https://docs.github.com/rest/actions/variables#set-selected-repositories-for-an-organization-variable parameters: - *73 - - *164 + - *163 requestBody: required: true content: @@ -25398,7 +27926,7 @@ paths: url: https://docs.github.com/rest/actions/variables#add-selected-repository-to-an-organization-variable parameters: - *73 - - *164 + - *163 - name: repository_id in: path required: true @@ -25433,7 +27961,7 @@ paths: url: https://docs.github.com/rest/actions/variables#remove-selected-repository-from-an-organization-variable parameters: - *73 - - *164 + - *163 - name: repository_id in: path required: true @@ -25562,6 +28090,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -25593,7 +28128,7 @@ paths: type: integer deployment_records: type: array - items: &166 + items: &165 title: Artifact Deployment Record description: Artifact Metadata Deployment Record type: object @@ -25637,8 +28172,10 @@ paths: - 'null' description: The ID of the provenance attestation associated with the deployment record. + required: + - total_count examples: - default: &167 + default: &166 value: total_count: 1 deployment_records: @@ -25782,6 +28319,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -25813,10 +28357,25 @@ paths: type: integer deployment_records: type: array - items: *166 + items: *165 + required: + - total_count examples: - default: *167 - '403': *27 + default: *166 + '403': + description: Forbidden + content: + application/json: + schema: *3 + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': *6 x-github: githubCloudOnly: false @@ -25918,6 +28477,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -25971,6 +28537,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -26029,9 +28597,9 @@ paths: - 3 deployment_records: type: array - items: *166 + items: *165 examples: - default: *167 + default: *166 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -26161,12 +28729,12 @@ paths: required: - subject_digests examples: - default: &681 + default: &680 value: subject_digests: - sha256:abc123 - sha512:def456 - withPredicateType: &682 + withPredicateType: &681 value: subject_digests: - sha256:abc123 @@ -26211,7 +28779,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: &683 + default: &682 value: attestations_subject_digests: - sha256:abc: @@ -26544,7 +29112,7 @@ paths: initiator: type: string examples: - default: &386 + default: &385 value: attestations: - bundle: @@ -26763,7 +29331,7 @@ paths: description: If specified, only campaigns with this state will be returned. in: query required: false - schema: &168 + schema: &167 title: Campaign state description: Indicates whether a campaign is open or closed type: string @@ -26789,7 +29357,7 @@ paths: application/json: schema: type: array - items: &169 + items: &168 title: Campaign summary description: The campaign metadata and alert stats. type: object @@ -26820,7 +29388,7 @@ paths: team_managers: description: The campaign team managers type: array - items: &188 + items: &187 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -26897,7 +29465,7 @@ paths: parent: anyOf: - type: 'null' - - &245 + - &244 title: Team Simple description: Groups of organization members that gives permissions on specified repositories. @@ -27033,7 +29601,7 @@ paths: - string - 'null' format: date-time - state: *168 + state: *167 contact_link: description: The contact link of the campaign. type: @@ -27256,9 +29824,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: &170 + default: &169 value: number: 3 created_at: '2024-02-14T12:29:18Z' @@ -27341,9 +29909,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: *170 + default: *169 '404': *6 '422': description: Unprocessable Entity @@ -27421,7 +29989,7 @@ paths: - string - 'null' format: uri - state: *168 + state: *167 examples: default: value: @@ -27431,9 +29999,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: *170 + default: *169 '400': description: Bad Request content: @@ -27500,17 +30068,17 @@ paths: url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization parameters: - *73 - - &410 + - &409 name: tool_name description: The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either `tool_name` or `tool_guid`, but not both. in: query required: false - schema: &178 + schema: &177 type: string description: The name of the tool used to generate the code scanning analysis. - - &411 + - &410 name: tool_guid description: The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in @@ -27518,7 +30086,7 @@ paths: or `tool_name`, but not both. in: query required: false - schema: &179 + schema: &178 type: - string - 'null' @@ -27534,7 +30102,7 @@ paths: be returned. in: query required: false - schema: &413 + schema: &412 type: string description: State of a code scanning alert. enum: @@ -27557,7 +30125,7 @@ paths: be returned. in: query required: false - schema: &414 + schema: &413 type: string description: Severity of a code scanning alert. enum: @@ -27586,18 +30154,18 @@ paths: items: type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: &415 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: &414 type: string description: The REST API URL for fetching the list of instances for an alert. format: uri readOnly: true - state: &180 + state: &179 type: - string - 'null' @@ -27607,13 +30175,13 @@ paths: - dismissed - fixed - - fixed_at: *176 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: &416 + dismissed_at: *176 + dismissed_reason: &415 type: - string - 'null' @@ -27624,14 +30192,14 @@ paths: - won't fix - used in tests - - dismissed_comment: &417 + dismissed_comment: &416 type: - string - 'null' description: The dismissal comment associated with the dismissal of the alert. maxLength: 280 - rule: &418 + rule: &417 type: object properties: id: @@ -27692,43 +30260,43 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: &419 + tool: &418 type: object properties: - name: *178 + name: *177 version: type: - string - 'null' description: The version of the tool used to generate the code scanning analysis. - guid: *179 - most_recent_instance: &420 + guid: *178 + most_recent_instance: &419 type: object properties: - ref: &412 + ref: &411 type: string description: |- The Git reference, formatted as `refs/pull//merge`, `refs/pull//head`, `refs/heads/` or simply ``. - analysis_key: &430 + analysis_key: &429 type: string description: Identifies the configuration under which the analysis was executed. For example, in GitHub Actions this includes the workflow filename and job name. - environment: &431 + environment: &430 type: string description: Identifies the variable values associated with the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed. - category: &432 + category: &431 type: string description: Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. - state: *180 + state: *179 commit_sha: type: string message: @@ -27742,7 +30310,7 @@ paths: with placeholder links for related locations replaced by links to the relevant code. Only populated when related locations are available for the alert instance. - location: &433 + location: &432 type: object description: Describe a region within a file for the alert. properties: @@ -27763,7 +30331,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: &434 + items: &433 type: - string - 'null' @@ -28399,7 +30967,7 @@ paths: application/json: schema: *47 examples: - default: *181 + default: *180 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -28427,9 +30995,9 @@ paths: description: Response content: application/json: - schema: *182 + schema: *181 examples: - default: *183 + default: *182 '304': *35 '403': *27 '404': *6 @@ -28481,7 +31049,7 @@ paths: - 32 - 91 responses: - '204': *184 + '204': *183 '400': *14 '403': *27 '404': *6 @@ -28516,7 +31084,7 @@ paths: application/json: schema: *47 examples: - default: *181 + default: *180 '304': *35 '403': *27 '404': *6 @@ -28816,7 +31384,7 @@ paths: - *73 - *49 responses: - '204': *184 + '204': *183 '400': *14 '403': *27 '404': *6 @@ -28954,7 +31522,7 @@ paths: default: value: default_for_new_repos: all - configuration: *181 + configuration: *180 '403': *27 '404': *6 x-github: @@ -29007,13 +31575,13 @@ paths: application/json: schema: type: array - items: *185 + items: *184 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: *186 + repository: *185 '403': *27 '404': *6 x-github: @@ -29053,7 +31621,7 @@ paths: type: integer codespaces: type: array - items: &235 + items: &234 type: object title: Codespace description: A codespace. @@ -29084,11 +31652,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *153 + repository: *152 machine: anyOf: - type: 'null' - - &446 + - &445 type: object title: Codespace machine description: A description of the machine powering a codespace. @@ -29375,7 +31943,7 @@ paths: - pulls_url - recent_folders examples: - default: &236 + default: &235 value: total_count: 3 codespaces: @@ -29999,7 +32567,7 @@ paths: type: integer secrets: type: array - items: &187 + items: &186 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -30040,7 +32608,7 @@ paths: - updated_at - visibility examples: - default: &447 + default: &446 value: total_count: 2 secrets: @@ -30078,7 +32646,7 @@ paths: description: Response content: application/json: - schema: &448 + schema: &447 title: CodespacesPublicKey description: The public key used for setting Codespaces secrets. type: object @@ -30113,7 +32681,7 @@ paths: - key_id - key examples: - default: &449 + default: &448 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -30137,15 +32705,15 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#get-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *187 + schema: *186 examples: - default: &451 + default: &450 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -30173,7 +32741,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -30228,7 +32796,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -30255,7 +32823,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -30281,7 +32849,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -30299,9 +32867,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 '404': *6 x-github: githubCloudOnly: false @@ -30324,7 +32892,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -30375,7 +32943,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -30409,7 +32977,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -30612,7 +33180,7 @@ paths: currently being billed. seats: type: array - items: &238 + items: &237 title: Copilot Business Seat Detail description: Information about a Copilot Business seat assignment for a user, team, or organization. @@ -30630,7 +33198,7 @@ paths: description: The team through which the assignee is granted access to GitHub Copilot, if applicable. oneOf: - - *188 + - *187 - *66 type: - 'null' @@ -31243,12 +33811,12 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 required: - total_count - repositories examples: - default: *189 + default: *188 '500': *53 '401': *23 '403': *27 @@ -31334,7 +33902,7 @@ paths: url: https://docs.github.com/rest/copilot/copilot-coding-agent-management#enable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No Content @@ -31368,7 +33936,7 @@ paths: url: https://docs.github.com/rest/copilot/copilot-coding-agent-management#disable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No Content @@ -31583,7 +34151,7 @@ paths: application/json: schema: type: array - items: &318 + items: &317 title: Copilot Usage Metrics description: Copilot usage metrics for a given day. type: object @@ -31898,7 +34466,7 @@ paths: - date additionalProperties: true examples: - default: &319 + default: &318 value: - date: '2024-06-24' total_active_users: 24 @@ -32000,7 +34568,7 @@ paths: '500': *53 '403': *27 '404': *6 - '422': &320 + '422': &319 description: Copilot Usage Metrics API setting is disabled at the organization or enterprise level. content: @@ -32041,7 +34609,7 @@ paths: schema: *55 examples: default: *56 - '204': *184 + '204': *183 '500': *53 '403': *27 '404': *6 @@ -32117,7 +34685,7 @@ paths: schema: *55 examples: default: *56 - '204': *184 + '204': *183 '500': *53 '403': *27 '404': *6 @@ -32180,11 +34748,11 @@ paths: url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-an-organization parameters: - *73 + - *189 - *190 - *191 - *192 - *193 - - *194 - name: artifact_registry_url in: query description: A comma-separated list of artifact registry URLs. If specified, @@ -32214,7 +34782,7 @@ paths: enum: - patch - deployment - - *195 + - *194 - name: runtime_risk in: query description: |- @@ -32223,8 +34791,8 @@ paths: Can be: `critical-resource`, `internet-exposed`, `sensitive-data`, `lateral-movement` schema: type: string + - *195 - *196 - - *197 - *59 - *45 - *46 @@ -32236,9 +34804,9 @@ paths: application/json: schema: type: array - items: *198 + items: *197 examples: - default: *199 + default: *198 '304': *35 '400': *14 '403': *27 @@ -32282,7 +34850,7 @@ paths: type: integer secrets: type: array - items: &200 + items: &199 title: Dependabot Secret for an Organization description: Secrets for GitHub Dependabot for an organization. type: object @@ -32361,7 +34929,7 @@ paths: description: Response content: application/json: - schema: &477 + schema: &476 title: DependabotPublicKey description: The public key used for setting Dependabot Secrets. type: object @@ -32380,7 +34948,7 @@ paths: - key_id - key examples: - default: &478 + default: &477 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -32404,13 +34972,13 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#get-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *200 + schema: *199 examples: default: value: @@ -32439,7 +35007,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -32494,7 +35062,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -32519,7 +35087,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -32544,7 +35112,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -32562,9 +35130,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -32586,7 +35154,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -32637,7 +35205,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -32669,7 +35237,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -32707,7 +35275,7 @@ paths: application/json: schema: type: array - items: &247 + items: &246 title: Package description: A software package type: object @@ -32760,7 +35328,7 @@ paths: repository: anyOf: - type: 'null' - - *153 + - *152 created_at: type: string format: date-time @@ -32778,7 +35346,7 @@ paths: - created_at - updated_at examples: - default: &248 + default: &247 value: - id: 197 name: hello_docker @@ -32948,7 +35516,7 @@ paths: application/json: schema: type: array - items: &224 + items: &223 title: Organization Invitation description: Organization Invitation type: object @@ -33002,7 +35570,7 @@ paths: - invitation_teams_url - node_id examples: - default: &225 + default: &224 value: - id: 1 login: monalisa @@ -33069,7 +35637,7 @@ paths: application/json: schema: type: array - items: &201 + items: &200 title: Org Hook description: Org Hook type: object @@ -33254,9 +35822,9 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: - default: &202 + default: &201 value: id: 1 url: https://api.github.com/orgs/octocat/hooks/1 @@ -33304,7 +35872,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook parameters: - *73 - - &203 + - &202 name: hook_id description: The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery. @@ -33317,9 +35885,9 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: - default: *202 + default: *201 '404': *6 x-github: githubCloudOnly: false @@ -33347,7 +35915,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook parameters: - *73 - - *203 + - *202 requestBody: required: false content: @@ -33393,7 +35961,7 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: default: value: @@ -33435,7 +36003,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook parameters: - *73 - - *203 + - *202 responses: '204': description: Response @@ -33463,7 +36031,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization parameters: - *73 - - *203 + - *202 responses: '200': description: Response @@ -33494,7 +36062,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization parameters: - *73 - - *203 + - *202 requestBody: required: false content: @@ -33545,10 +36113,10 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *17 + - *203 - *204 - - *205 responses: '200': description: Response @@ -33556,9 +36124,9 @@ paths: application/json: schema: type: array - items: *206 + items: *205 examples: - default: *207 + default: *206 '400': *14 '422': *15 x-github: @@ -33584,16 +36152,16 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *16 responses: '200': description: Response content: application/json: - schema: *208 + schema: *207 examples: - default: *209 + default: *208 '400': *14 '422': *15 x-github: @@ -33619,7 +36187,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *16 responses: '202': *37 @@ -33649,7 +36217,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook parameters: - *73 - - *203 + - *202 responses: '204': description: Response @@ -33672,7 +36240,7 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor parameters: - *73 - - &214 + - &213 name: actor_type in: path description: The type of the actor @@ -33685,14 +36253,14 @@ paths: - fine_grained_pat - oauth_app - github_app_user_to_server - - &215 + - &214 name: actor_id in: path description: The ID of the actor required: true schema: type: integer - - &210 + - &209 name: min_timestamp description: 'The minimum timestamp to query for stats. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -33700,7 +36268,7 @@ paths: required: true schema: type: string - - &211 + - &210 name: max_timestamp description: 'The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -33795,12 +36363,12 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-subject-stats parameters: - *73 + - *209 - *210 - - *211 - *19 - *17 - *59 - - &220 + - &219 name: sort description: The property to sort the results by. in: query @@ -33879,14 +36447,14 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats parameters: - *73 + - *209 - *210 - - *211 responses: '200': description: Response content: application/json: - schema: &212 + schema: &211 title: Summary Stats description: API Insights usage summary stats for an organization type: object @@ -33902,7 +36470,7 @@ paths: type: integer format: int64 examples: - default: &213 + default: &212 value: total_request_count: 34225 rate_limited_request_count: 23 @@ -33923,23 +36491,23 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user parameters: - *73 - - &216 + - &215 name: user_id in: path description: The ID of the user to query for stats required: true schema: type: string + - *209 - *210 - - *211 responses: '200': description: Response content: application/json: - schema: *212 + schema: *211 examples: - default: *213 + default: *212 x-github: enabledForGitHubApps: true category: orgs @@ -33958,18 +36526,18 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor parameters: - *73 + - *209 - *210 - - *211 + - *213 - *214 - - *215 responses: '200': description: Response content: application/json: - schema: *212 + schema: *211 examples: - default: *213 + default: *212 x-github: enabledForGitHubApps: true category: orgs @@ -33987,9 +36555,9 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats parameters: - *73 + - *209 - *210 - - *211 - - &217 + - &216 name: timestamp_increment description: The increment of time used to breakdown the query results (5m, 10m, 1h, etc.) @@ -34002,7 +36570,7 @@ paths: description: Response content: application/json: - schema: &218 + schema: &217 title: Time Stats description: API Insights usage time stats for an organization type: array @@ -34018,7 +36586,7 @@ paths: type: integer format: int64 examples: - default: &219 + default: &218 value: - timestamp: '2024-09-11T15:00:00Z' total_request_count: 34225 @@ -34055,18 +36623,18 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user parameters: - *73 - - *216 + - *215 + - *209 - *210 - - *211 - - *217 + - *216 responses: '200': description: Response content: application/json: - schema: *218 + schema: *217 examples: - default: *219 + default: *218 x-github: enabledForGitHubApps: true category: orgs @@ -34084,19 +36652,19 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor parameters: - *73 + - *213 - *214 - - *215 + - *209 - *210 - - *211 - - *217 + - *216 responses: '200': description: Response content: application/json: - schema: *218 + schema: *217 examples: - default: *219 + default: *218 x-github: enabledForGitHubApps: true category: orgs @@ -34114,13 +36682,13 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-user-stats parameters: - *73 - - *216 + - *215 + - *209 - *210 - - *211 - *19 - *17 - *59 - - *220 + - *219 - name: actor_name_substring in: query description: Providing a substring will filter results where the actor name @@ -34204,7 +36772,7 @@ paths: application/json: schema: *20 examples: - default: &516 + default: &515 value: id: 1 account: @@ -34370,12 +36938,12 @@ paths: application/json: schema: anyOf: - - &222 + - &221 title: Interaction Limits description: Interaction limit settings. type: object properties: - limit: &221 + limit: &220 type: string description: The type of GitHub user that can comment, open issues, or create pull requests while the interaction limit @@ -34403,7 +36971,7 @@ paths: properties: {} additionalProperties: false examples: - default: &223 + default: &222 value: limit: collaborators_only origin: organization @@ -34432,13 +37000,13 @@ paths: required: true content: application/json: - schema: &517 + schema: &516 title: Interaction Restrictions description: Limit interactions to a specific type of user for a specified duration type: object properties: - limit: *221 + limit: *220 expiry: type: string description: 'The duration of the interaction restriction. Default: @@ -34463,9 +37031,9 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: - default: *223 + default: *222 '422': *15 x-github: githubCloudOnly: false @@ -34541,9 +37109,9 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 '404': *6 @@ -34620,7 +37188,7 @@ paths: description: Response content: application/json: - schema: *224 + schema: *223 examples: default: value: @@ -34675,7 +37243,7 @@ paths: url: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation parameters: - *73 - - &226 + - &225 name: invitation_id description: The unique identifier of the invitation. in: path @@ -34706,7 +37274,7 @@ paths: url: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams parameters: - *73 - - *226 + - *225 - *17 - *19 responses: @@ -34716,9 +37284,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: &246 + default: &245 value: - id: 1 node_id: MDQ6VGVhbTE= @@ -34761,7 +37329,7 @@ paths: application/json: schema: type: array - items: &227 + items: &226 title: Issue Field description: A custom attribute defined at the organization level for attaching structured data to issues. @@ -35004,9 +37572,9 @@ paths: description: Response content: application/json: - schema: *227 + schema: *226 examples: - default: &228 + default: &227 value: id: 512 node_id: IF_kwDNAd3NAZr @@ -35062,7 +37630,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-fields#update-issue-field-for-an-organization parameters: - *73 - - &229 + - &228 name: issue_field_id description: The unique identifier of the issue field. in: path @@ -35163,9 +37731,9 @@ paths: description: Response content: application/json: - schema: *227 + schema: *226 examples: - default: *228 + default: *227 '404': *6 '422': *7 x-github: @@ -35190,9 +37758,9 @@ paths: url: https://docs.github.com/rest/orgs/issue-fields#delete-issue-field-for-an-organization parameters: - *73 - - *229 + - *228 responses: - '204': *184 + '204': *183 '404': *6 '422': *7 x-github: @@ -35220,7 +37788,7 @@ paths: application/json: schema: type: array - items: *230 + items: *229 examples: default: value: @@ -35308,9 +37876,9 @@ paths: description: Response content: application/json: - schema: *230 + schema: *229 examples: - default: &231 + default: &230 value: id: 410 node_id: IT_kwDNAd3NAZo @@ -35343,7 +37911,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization parameters: - *73 - - &232 + - &231 name: issue_type_id description: The unique identifier of the issue type. in: path @@ -35399,9 +37967,9 @@ paths: description: Response content: application/json: - schema: *230 + schema: *229 examples: - default: *231 + default: *230 '404': *6 '422': *7 x-github: @@ -35426,7 +37994,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization parameters: - *73 - - *232 + - *231 responses: '204': description: Response @@ -35489,7 +38057,7 @@ paths: - closed - all default: open - - *233 + - *232 - name: type description: Can be the name of an issue type. in: query @@ -35520,7 +38088,7 @@ paths: type: array items: *81 examples: - default: *234 + default: *233 headers: Link: *65 '404': *6 @@ -35680,9 +38248,9 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: - default: *236 + default: *235 '304': *35 '500': *53 '401': *23 @@ -35709,7 +38277,7 @@ paths: parameters: - *73 - *69 - - &237 + - &236 name: codespace_name in: path required: true @@ -35744,15 +38312,15 @@ paths: parameters: - *73 - *69 - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: &445 + default: &444 value: id: 1 name: monalisa-octocat-hello-world-g4wpq6h95q @@ -35932,7 +38500,7 @@ paths: description: The user's GitHub Copilot seat details, including usage. content: application/json: - schema: *238 + schema: *237 examples: default: value: @@ -36008,7 +38576,7 @@ paths: description: Response content: application/json: - schema: &239 + schema: &238 title: Org Membership description: Org Membership type: object @@ -36077,7 +38645,7 @@ paths: - organization - user examples: - response-if-user-has-an-active-admin-membership-with-organization: &240 + response-if-user-has-an-active-admin-membership-with-organization: &239 summary: Response if user has an active admin membership with organization value: url: https://api.github.com/orgs/octocat/memberships/defunkt @@ -36178,9 +38746,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: - response-if-user-already-had-membership-with-organization: *240 + response-if-user-already-had-membership-with-organization: *239 '422': *15 '403': *27 '451': *15 @@ -36253,7 +38821,7 @@ paths: application/json: schema: type: array - items: &241 + items: &240 title: Migration description: A migration. type: object @@ -36591,7 +39159,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -36770,7 +39338,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#get-an-organization-migration-status parameters: - *73 - - &242 + - &241 name: migration_id description: The unique identifier of the migration. in: path @@ -36798,7 +39366,7 @@ paths: * `failed`, which means the migration failed. content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -36968,7 +39536,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#download-an-organization-migration-archive parameters: - *73 - - *242 + - *241 responses: '302': description: Response @@ -36990,7 +39558,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#delete-an-organization-migration-archive parameters: - *73 - - *242 + - *241 responses: '204': description: Response @@ -37014,8 +39582,8 @@ paths: url: https://docs.github.com/rest/migrations/orgs#unlock-an-organization-repository parameters: - *73 - - *242 - - &663 + - *241 + - &662 name: repo_name description: repo_name parameter in: path @@ -37043,7 +39611,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#list-repositories-in-an-organization-migration parameters: - *73 - - *242 + - *241 - *17 - *19 responses: @@ -37071,7 +39639,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -37097,7 +39665,7 @@ paths: roles: type: array description: The list of organization roles available to the organization. - items: &244 + items: &243 title: Organization Role description: Organization roles type: object @@ -37274,7 +39842,7 @@ paths: parameters: - *73 - *75 - - &243 + - &242 name: role_id description: The unique identifier of the role. in: path @@ -37311,7 +39879,7 @@ paths: parameters: - *73 - *75 - - *243 + - *242 responses: '204': description: Response @@ -37364,7 +39932,7 @@ paths: parameters: - *73 - *69 - - *243 + - *242 responses: '204': description: Response @@ -37396,7 +39964,7 @@ paths: parameters: - *73 - *69 - - *243 + - *242 responses: '204': description: Response @@ -37414,7 +39982,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -37425,13 +39993,13 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role parameters: - *73 - - *243 + - *242 responses: '200': description: Response content: application/json: - schema: *244 + schema: *243 examples: default: value: @@ -37482,7 +40050,7 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - *73 - - *243 + - *242 - *17 - *19 responses: @@ -37561,7 +40129,7 @@ paths: parent: anyOf: - type: 'null' - - *245 + - *244 type: description: The ownership type of the team type: string @@ -37594,7 +40162,7 @@ paths: - type - parent examples: - default: *246 + default: *245 headers: Link: *65 '404': @@ -37624,7 +40192,7 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - *73 - - *243 + - *242 - *17 - *19 responses: @@ -37653,7 +40221,7 @@ paths: inherited_from: description: Team the user has gotten the role through type: array - items: *245 + items: *244 name: type: - string @@ -37963,7 +40531,7 @@ paths: - nuget - container - *73 - - &664 + - &663 name: visibility description: |- The selected visibility of the packages. This parameter is optional and only filters an existing result set. @@ -37999,12 +40567,12 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *248 + default: *247 '403': *27 '401': *23 - '400': &666 + '400': &665 description: The value of `per_page` multiplied by `page` cannot be greater than 10000. x-github: @@ -38026,7 +40594,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-an-organization parameters: - - &249 + - &248 name: package_type description: The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry @@ -38044,7 +40612,7 @@ paths: - docker - nuget - container - - &250 + - &249 name: package_name description: The name of the package. in: path @@ -38057,7 +40625,7 @@ paths: description: Response content: application/json: - schema: *247 + schema: *246 examples: default: value: @@ -38109,8 +40677,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-an-organization parameters: + - *248 - *249 - - *250 - *73 responses: '204': @@ -38143,8 +40711,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - name: token description: package token @@ -38177,8 +40745,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-an-organization parameters: + - *248 - *249 - - *250 - *73 - *19 - *17 @@ -38199,7 +40767,7 @@ paths: application/json: schema: type: array - items: &251 + items: &250 title: Package Version description: A version of a software package type: object @@ -38334,10 +40902,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - &252 + - &251 name: package_version_id description: Unique identifier of the package version. in: path @@ -38349,7 +40917,7 @@ paths: description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -38385,10 +40953,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - *252 + - *251 responses: '204': description: Response @@ -38420,10 +40988,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - *252 + - *251 responses: '204': description: Response @@ -38453,7 +41021,7 @@ paths: - *73 - *17 - *19 - - &253 + - &252 name: sort description: The property by which to sort the results. in: query @@ -38464,7 +41032,7 @@ paths: - created_at default: created_at - *59 - - &254 + - &253 name: owner description: A list of owner usernames to use to filter the results. in: query @@ -38476,7 +41044,7 @@ paths: type: string examples: - owner[]=octocat1,owner[]=octocat2 - - &255 + - &254 name: repository description: The name of the repository to use to filter the results. in: query @@ -38485,7 +41053,7 @@ paths: type: string examples: - Hello-World - - &256 + - &255 name: permission description: The permission to use to filter the results. in: query @@ -38494,7 +41062,7 @@ paths: type: string examples: - issues_read - - &257 + - &256 name: last_used_before description: 'Only show fine-grained personal access tokens used before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -38504,7 +41072,7 @@ paths: schema: type: string format: date-time - - &258 + - &257 name: last_used_after description: 'Only show fine-grained personal access tokens used after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -38514,7 +41082,7 @@ paths: schema: type: string format: date-time - - &259 + - &258 name: token_id description: The ID of the token in: query @@ -38790,7 +41358,7 @@ paths: '422': *15 '404': *6 '403': *27 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -38831,9 +41399,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: &260 + default: &259 value: - id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -38970,14 +41538,14 @@ paths: - *73 - *17 - *19 - - *253 + - *252 - *59 + - *253 - *254 - *255 - *256 - *257 - *258 - - *259 responses: '500': *53 '422': *15 @@ -39218,7 +41786,7 @@ paths: responses: '500': *53 '404': *6 - '204': *184 + '204': *183 '403': *27 '422': *15 x-github: @@ -39259,9 +41827,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 x-github: @@ -39303,7 +41871,7 @@ paths: type: integer configurations: type: array - items: &261 + items: &260 title: Organization private registry description: Private registry configuration for an organization type: object @@ -39737,7 +42305,7 @@ paths: - created_at - updated_at examples: - org-private-registry-with-selected-visibility: &262 + org-private-registry-with-selected-visibility: &261 value: name: MAVEN_REPOSITORY_SECRET registry_type: maven_repository @@ -39829,15 +42397,15 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#get-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 responses: '200': description: The specified private registry configuration for the organization content: application/json: - schema: *261 + schema: *260 examples: - default: *262 + default: *261 '404': *6 x-github: githubCloudOnly: false @@ -39860,7 +42428,7 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#update-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -40025,7 +42593,7 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#delete-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -40065,7 +42633,7 @@ paths: application/json: schema: type: array - items: &263 + items: &262 title: Projects v2 Project description: A projects v2 project type: object @@ -40139,7 +42707,7 @@ paths: latest_status_update: anyOf: - type: 'null' - - &750 + - &749 title: Projects v2 Status Update description: An status update belonging to a project type: object @@ -40224,7 +42792,7 @@ paths: - deleted_at - deleted_by examples: - default: &264 + default: &263 value: id: 2 node_id: MDc6UHJvamVjdDEwMDI2MDM= @@ -40327,7 +42895,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/projects#get-project-for-organization parameters: - - &265 + - &264 name: project_number description: The project's number. in: path @@ -40340,9 +42908,9 @@ paths: description: Response content: application/json: - schema: *263 + schema: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -40365,7 +42933,7 @@ paths: url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true description: Details of the draft item to create in the project. @@ -40399,7 +42967,7 @@ paths: description: Response content: application/json: - schema: &270 + schema: &269 title: Projects v2 Item description: An item belonging to a project type: object @@ -40413,7 +42981,7 @@ paths: content: oneOf: - *81 - - &460 + - &459 title: Pull Request Simple description: Pull Request Simple type: object @@ -40533,7 +43101,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 active_lock_reason: type: - string @@ -40572,7 +43140,7 @@ paths: items: *4 requested_teams: type: array - items: *188 + items: *187 head: type: object properties: @@ -40616,7 +43184,7 @@ paths: _links: type: object properties: - comments: &267 + comments: &266 title: Link description: Hypermedia Link type: object @@ -40625,13 +43193,13 @@ paths: type: string required: - href - commits: *267 - statuses: *267 - html: *267 - issue: *267 - review_comments: *267 - review_comment: *267 - self: *267 + commits: *266 + statuses: *266 + html: *266 + issue: *266 + review_comments: *266 + review_comment: *266 + self: *266 required: - comments - commits @@ -40642,7 +43210,7 @@ paths: - review_comment - self author_association: *78 - auto_merge: &562 + auto_merge: &561 title: Auto merge description: The status of auto merging a pull request. type: @@ -40742,7 +43310,7 @@ paths: - created_at - updated_at description: The content represented by the item. - content_type: &269 + content_type: &268 title: Projects v2 Item Content Type description: The type of content tracked in a project item type: string @@ -40786,7 +43354,7 @@ paths: - updated_at - archived_at examples: - draft_issue: &271 + draft_issue: &270 value: id: 17 node_id: PVTI_lADOANN5s84ACbL0zgBueEI @@ -40860,7 +43428,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#list-project-fields-for-organization parameters: - - *265 + - *264 - *73 - *17 - *45 @@ -40872,7 +43440,7 @@ paths: application/json: schema: type: array - items: &268 + items: &267 title: Projects v2 Field description: A field inside a projects v2 project type: object @@ -41025,7 +43593,7 @@ paths: - updated_at - project_url examples: - default: &686 + default: &685 value: - id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41155,7 +43723,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#add-a-field-to-an-organization-owned-project parameters: - - *265 + - *264 - *73 requestBody: required: true @@ -41202,7 +43770,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: &687 + items: &686 type: object properties: name: @@ -41239,7 +43807,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: &688 + iteration_configuration: &687 type: object description: The configuration for iteration fields. properties: @@ -41289,7 +43857,7 @@ paths: value: name: Due date data_type: date - single_select_field: &689 + single_select_field: &688 summary: Create a single select field value: name: Priority @@ -41316,7 +43884,7 @@ paths: description: raw: High priority items html: High priority items - iteration_field: &690 + iteration_field: &689 summary: Create an iteration field value: name: Sprint @@ -41340,9 +43908,9 @@ paths: description: Response for adding a field to an organization-owned project. content: application/json: - schema: *268 + schema: *267 examples: - text_field: &691 + text_field: &690 value: id: 24680 node_id: PVTF_lADOABCD2468024680 @@ -41351,7 +43919,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-05-15T08:00:00Z' updated_at: '2022-05-15T08:00:00Z' - number_field: &692 + number_field: &691 value: id: 13579 node_id: PVTF_lADOABCD1357913579 @@ -41360,7 +43928,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-01T14:30:00Z' updated_at: '2022-06-01T14:30:00Z' - date_field: &693 + date_field: &692 value: id: 98765 node_id: PVTF_lADOABCD9876598765 @@ -41369,7 +43937,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-10T09:15:00Z' updated_at: '2022-06-10T09:15:00Z' - single_select_field: &694 + single_select_field: &693 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41403,7 +43971,7 @@ paths: raw: High priority items created_at: '2022-04-28T12:00:00Z' updated_at: '2022-04-28T12:00:00Z' - iteration_field: &695 + iteration_field: &694 value: id: 11223 node_id: PVTF_lADOABCD1122311223 @@ -41448,8 +44016,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#get-project-field-for-organization parameters: - - *265 - - &696 + - *264 + - &695 name: field_id description: The unique identifier of the field. in: path @@ -41462,9 +44030,9 @@ paths: description: Response content: application/json: - schema: *268 + schema: *267 examples: - default: &697 + default: &696 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41520,7 +44088,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-an-organization-owned-project parameters: - - *265 + - *264 - *73 - name: q description: Search query to filter items, see [Filtering projects](https://docs.github.com/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects) @@ -41553,7 +44121,7 @@ paths: application/json: schema: type: array - items: &272 + items: &271 title: Projects v2 Item description: An item belonging to a project type: object @@ -41570,7 +44138,7 @@ paths: description: The API URL of the project that contains this item. examples: - https://api.github.com/users/monalisa/2/projectsV2/3 - content_type: *269 + content_type: *268 content: type: - object @@ -41620,7 +44188,7 @@ paths: - updated_at - archived_at examples: - default: &273 + default: &272 value: id: 13 node_id: PVTI_lAAFAQ0 @@ -42318,7 +44886,7 @@ paths: url: https://docs.github.com/rest/projects/items#add-item-to-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -42388,22 +44956,22 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *271 + value: *270 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *271 + value: *270 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *271 + value: *270 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *271 + value: *270 '304': *35 '403': *27 '401': *23 @@ -42423,9 +44991,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#get-an-item-for-an-organization-owned-project parameters: - - *265 + - *264 - *73 - - &274 + - &273 name: item_id description: The unique identifier of the project item. in: path @@ -42451,9 +45019,9 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -42474,9 +45042,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#update-project-item-for-organization parameters: - - *265 + - *264 - *73 - - *274 + - *273 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -42549,13 +45117,13 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - text_field: *273 - number_field: *273 - date_field: *273 - single_select_field: *273 - iteration_field: *273 + text_field: *272 + number_field: *272 + date_field: *272 + single_select_field: *272 + iteration_field: *272 '401': *23 '403': *27 '404': *6 @@ -42575,9 +45143,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#delete-project-item-for-organization parameters: - - *265 + - *264 - *73 - - *274 + - *273 responses: '204': description: Response @@ -42601,7 +45169,7 @@ paths: url: https://docs.github.com/rest/projects/views#create-a-view-for-an-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true content: @@ -42675,7 +45243,7 @@ paths: description: Response for creating a view in an organization-owned project. content: application/json: - schema: &678 + schema: &677 title: Projects v2 View description: A view inside a projects v2 project type: object @@ -42779,7 +45347,7 @@ paths: examples: table_view: summary: Response for creating a table view - value: &275 + value: &274 value: id: 1 number: 1 @@ -42825,10 +45393,10 @@ paths: - 456 board_view: summary: Response for creating a board view with filter - value: *275 + value: *274 roadmap_view: summary: Response for creating a roadmap view - value: *275 + value: *274 '304': *35 '403': *27 '401': *23 @@ -42856,9 +45424,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-an-organization-project-view parameters: - - *265 + - *264 - *73 - - &698 + - &697 name: view_number description: The number that identifies the project view. in: path @@ -42890,9 +45458,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -42925,7 +45493,7 @@ paths: application/json: schema: type: array - items: &276 + items: &275 title: Organization Custom Property description: Custom property defined on an organization type: object @@ -43003,7 +45571,7 @@ paths: - property_name - value_type examples: - default: &277 + default: &276 value: - property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -43063,7 +45631,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *276 + items: *275 minItems: 1 maxItems: 100 required: @@ -43093,9 +45661,9 @@ paths: application/json: schema: type: array - items: *276 + items: *275 examples: - default: *277 + default: *276 '403': *27 '404': *6 x-github: @@ -43117,7 +45685,7 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization parameters: - *73 - - &278 + - &277 name: custom_property_name description: The custom property name in: path @@ -43129,9 +45697,9 @@ paths: description: Response content: application/json: - schema: *276 + schema: *275 examples: - default: &279 + default: &278 value: property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -43166,7 +45734,7 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization parameters: - *73 - - *278 + - *277 requestBody: required: true content: @@ -43246,9 +45814,9 @@ paths: description: Response content: application/json: - schema: *276 + schema: *275 examples: - default: *279 + default: *278 '403': *27 '404': *6 x-github: @@ -43272,9 +45840,9 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization parameters: - *73 - - *278 + - *277 responses: - '204': *184 + '204': *183 '403': *27 '404': *6 x-github: @@ -43336,7 +45904,7 @@ paths: - octocat/Hello-World properties: type: array - items: &280 + items: &279 title: Custom Property Value description: Custom property name and associated value type: object @@ -43426,7 +45994,7 @@ paths: type: array description: List of custom property names and associated values to apply to the repositories. - items: *280 + items: *279 required: - repository_names - properties @@ -43616,9 +46184,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 x-github: @@ -43821,7 +46389,7 @@ paths: description: Response content: application/json: - schema: &328 + schema: &327 title: Full Repository description: Full Repository type: object @@ -44291,7 +46859,7 @@ paths: description: Whether anonymous git access is allowed. default: true type: boolean - code_of_conduct: &465 + code_of_conduct: &464 title: Code Of Conduct Simple description: Code of Conduct Simple type: object @@ -44321,7 +46889,7 @@ paths: - key - name - html_url - security_and_analysis: *281 + security_and_analysis: *280 custom_properties: type: object description: The custom properties that were defined for the repository. @@ -44405,7 +46973,7 @@ paths: - network_count - subscribers_count examples: - default: &330 + default: &329 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -44927,7 +47495,7 @@ paths: - *73 - *17 - *19 - - &584 + - &583 name: targets description: | A comma-separated list of rule targets to filter by. @@ -44946,7 +47514,7 @@ paths: application/json: schema: type: array - items: &308 + items: &307 title: Repository ruleset type: object description: A set of rules to apply when specified conditions are @@ -44981,7 +47549,7 @@ paths: source: type: string description: The name of the source - enforcement: &284 + enforcement: &283 type: string description: The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins @@ -44994,7 +47562,7 @@ paths: bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: &285 + items: &284 title: Repository Ruleset Bypass Actor type: object description: An actor that can bypass rules in a ruleset @@ -45065,7 +47633,7 @@ paths: description: The html URL of the ruleset conditions: anyOf: - - &282 + - &281 title: Repository ruleset conditions for ref names type: object description: Parameters for a repository ruleset ref name @@ -45089,7 +47657,7 @@ paths: match. items: type: string - - &286 + - &285 title: Organization ruleset conditions type: object description: |- @@ -45103,7 +47671,7 @@ paths: description: Conditions to target repositories by name and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository names type: object description: Parameters for a repository name condition @@ -45137,7 +47705,7 @@ paths: description: Conditions to target repositories by id and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository IDs type: object description: Parameters for a repository ID condition @@ -45159,7 +47727,7 @@ paths: description: Conditions to target repositories by property and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository properties type: object description: Parameters for a repository property condition @@ -45172,7 +47740,7 @@ paths: description: The repository properties and values to include. All of these properties must match for the condition to pass. - items: &283 + items: &282 title: Repository ruleset property targeting definition type: object @@ -45205,7 +47773,7 @@ paths: description: The repository properties and values to exclude. The condition will not pass if any of these properties match. - items: *283 + items: *282 required: - repository_property type: @@ -45213,12 +47781,12 @@ paths: - object rules: type: array - items: &585 + items: &584 title: Repository Rule type: object description: A repository rule. oneOf: - - &287 + - &286 title: creation description: Only allow users with bypass permission to create matching refs. @@ -45230,7 +47798,7 @@ paths: type: string enum: - creation - - &288 + - &287 title: update description: Only allow users with bypass permission to update matching refs. @@ -45251,7 +47819,7 @@ paths: repository required: - update_allows_fetch_and_merge - - &289 + - &288 title: deletion description: Only allow users with bypass permissions to delete matching refs. @@ -45263,7 +47831,7 @@ paths: type: string enum: - deletion - - &290 + - &289 title: required_linear_history description: Prevent merge commits from being pushed to matching refs. @@ -45275,7 +47843,7 @@ paths: type: string enum: - required_linear_history - - &583 + - &582 title: merge_queue description: Merges must be performed via a merge queue. type: object @@ -45353,7 +47921,7 @@ paths: - merge_method - min_entries_to_merge - min_entries_to_merge_wait_minutes - - &291 + - &290 title: required_deployments description: Choose which environments must be successfully deployed to before refs can be pushed into a ref that @@ -45377,7 +47945,7 @@ paths: type: string required: - required_deployment_environments - - &292 + - &291 title: required_signatures description: Commits pushed to matching refs must have verified signatures. @@ -45389,7 +47957,7 @@ paths: type: string enum: - required_signatures - - &293 + - &292 title: pull_request description: Require all commits be made to a non-target branch and submitted via a pull request before they can @@ -45495,7 +48063,7 @@ paths: - require_last_push_approval - required_approving_review_count - required_review_thread_resolution - - &294 + - &293 title: required_status_checks description: Choose which status checks must pass before the ref is updated. When enabled, commits must first be @@ -45543,7 +48111,7 @@ paths: required: - required_status_checks - strict_required_status_checks_policy - - &295 + - &294 title: non_fast_forward description: Prevent users with push access from force pushing to refs. @@ -45555,7 +48123,7 @@ paths: type: string enum: - non_fast_forward - - &296 + - &295 title: commit_message_pattern description: Parameters to be used for the commit_message_pattern rule @@ -45592,7 +48160,7 @@ paths: required: - operator - pattern - - &297 + - &296 title: commit_author_email_pattern description: Parameters to be used for the commit_author_email_pattern rule @@ -45629,7 +48197,7 @@ paths: required: - operator - pattern - - &298 + - &297 title: committer_email_pattern description: Parameters to be used for the committer_email_pattern rule @@ -45666,7 +48234,7 @@ paths: required: - operator - pattern - - &299 + - &298 title: branch_name_pattern description: Parameters to be used for the branch_name_pattern rule @@ -45703,7 +48271,7 @@ paths: required: - operator - pattern - - &300 + - &299 title: tag_name_pattern description: Parameters to be used for the tag_name_pattern rule @@ -45740,7 +48308,7 @@ paths: required: - operator - pattern - - &301 + - &300 title: file_path_restriction description: Prevent commits that include changes in specified file and folder paths from being pushed to the commit @@ -45765,7 +48333,7 @@ paths: type: string required: - restricted_file_paths - - &302 + - &301 title: max_file_path_length description: Prevent commits that include file paths that exceed the specified character limit from being pushed @@ -45789,7 +48357,7 @@ paths: maximum: 32767 required: - max_file_path_length - - &303 + - &302 title: file_extension_restriction description: Prevent commits that include files with specified file extensions from being pushed to the commit graph. @@ -45812,7 +48380,7 @@ paths: type: string required: - restricted_file_extensions - - &304 + - &303 title: max_file_size description: Prevent commits with individual files that exceed the specified limit from being pushed to the commit @@ -45837,7 +48405,7 @@ paths: maximum: 100 required: - max_file_size - - &305 + - &304 title: workflows description: Require all changes made to a targeted branch to pass the specified workflows before they can be merged. @@ -45887,7 +48455,7 @@ paths: - repository_id required: - workflows - - &306 + - &305 title: code_scanning description: Choose which tools must provide code scanning results before the reference is updated. When configured, @@ -45948,7 +48516,7 @@ paths: - tool required: - code_scanning_tools - - &307 + - &306 title: copilot_code_review description: Request Copilot code review for new pull requests automatically if the author has access to Copilot code @@ -46047,20 +48615,21 @@ paths: - push - repository default: branch - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *286 + items: *284 + conditions: *285 rules: type: array description: An array of rules within the ruleset. - items: &310 + items: &309 title: Repository Rule type: object description: A repository rule. oneOf: + - *286 - *287 - *288 - *289 @@ -46081,7 +48650,6 @@ paths: - *304 - *305 - *306 - - *307 required: - name - enforcement @@ -46119,9 +48687,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: &309 + default: &308 value: id: 21 name: super cool ruleset @@ -46177,7 +48745,7 @@ paths: url: https://docs.github.com/rest/orgs/rule-suites#list-organization-rule-suites parameters: - *73 - - &586 + - &585 name: ref description: The name of the ref. Cannot contain wildcard characters. Optionally prefix with `refs/heads/` to limit to branches or `refs/tags/` to limit @@ -46192,7 +48760,7 @@ paths: in: query schema: type: string - - &587 + - &586 name: time_period description: |- The time period to filter by. @@ -46208,14 +48776,14 @@ paths: - week - month default: day - - &588 + - &587 name: actor_name description: The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned. in: query schema: type: string - - &589 + - &588 name: rule_suite_result description: The rule suite results to filter on. When specified, only suites with this result will be returned. @@ -46235,7 +48803,7 @@ paths: description: Response content: application/json: - schema: &590 + schema: &589 title: Rule Suites description: Response type: array @@ -46291,7 +48859,7 @@ paths: whether rules would pass or fail if all rules in the rule suite were `active`. examples: - default: &591 + default: &590 value: - id: 21 actor_id: 12 @@ -46335,7 +48903,7 @@ paths: url: https://docs.github.com/rest/orgs/rule-suites#get-an-organization-rule-suite parameters: - *73 - - &592 + - &591 name: rule_suite_id description: |- The unique identifier of the rule suite result. @@ -46351,7 +48919,7 @@ paths: description: Response content: application/json: - schema: &593 + schema: &592 title: Rule Suite description: Response type: object @@ -46458,7 +49026,7 @@ paths: description: The detailed failure message for the rule. Null if the rule passed. examples: - default: &594 + default: &593 value: id: 21 actor_id: 12 @@ -46531,9 +49099,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *309 + default: *308 '404': *6 '500': *53 put: @@ -46577,16 +49145,16 @@ paths: - tag - push - repository - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *286 + items: *284 + conditions: *285 rules: description: An array of rules within the ruleset. type: array - items: *310 + items: *309 examples: default: value: @@ -46621,9 +49189,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *309 + default: *308 '404': *6 '422': *15 '500': *53 @@ -46681,7 +49249,7 @@ paths: application/json: schema: type: array - items: &311 + items: &310 title: Ruleset version type: object description: The historical version of a ruleset @@ -46705,7 +49273,7 @@ paths: type: string format: date-time examples: - default: &596 + default: &595 value: - version_id: 3 actor: @@ -46758,9 +49326,9 @@ paths: description: Response content: application/json: - schema: &597 + schema: &596 allOf: - - *311 + - *310 - type: object required: - state @@ -46830,7 +49398,7 @@ paths: url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization parameters: - *73 - - &598 + - &597 name: state in: query description: Set to `open` or `resolved` to only list secret scanning alerts @@ -46841,7 +49409,7 @@ paths: enum: - open - resolved - - &599 + - &598 name: secret_type in: query description: A comma-separated list of secret types to return. All default @@ -46851,7 +49419,7 @@ paths: required: false schema: type: string - - &600 + - &599 name: resolution in: query description: A comma-separated list of resolutions. Only secret scanning alerts @@ -46860,7 +49428,7 @@ paths: required: false schema: type: string - - &601 + - &600 name: assignee in: query description: Filters alerts by assignee. Use `*` to get all assigned alerts, @@ -46879,7 +49447,7 @@ paths: all-unassigned: value: none summary: Filter for all unassigned alerts - - &602 + - &601 name: sort description: The property to sort the results by. `created` means when the alert was created. `updated` means when the alert was updated or resolved. @@ -46894,7 +49462,7 @@ paths: - *59 - *19 - *17 - - &603 + - &602 name: before description: A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. To @@ -46904,7 +49472,7 @@ paths: required: false schema: type: string - - &604 + - &603 name: after description: A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. To @@ -46914,7 +49482,7 @@ paths: required: false schema: type: string - - &605 + - &604 name: validity in: query description: A comma-separated list of validities that, when present, will @@ -46923,7 +49491,7 @@ paths: required: false schema: type: string - - &606 + - &605 name: is_publicly_leaked in: query description: A boolean value representing whether or not to filter alerts @@ -46932,7 +49500,7 @@ paths: schema: type: boolean default: false - - &607 + - &606 name: is_multi_repo in: query description: A boolean value representing whether or not to filter alerts @@ -46941,7 +49509,7 @@ paths: schema: type: boolean default: false - - &608 + - &607 name: hide_secret in: query description: A boolean value representing whether or not to hide literal secrets @@ -46960,27 +49528,27 @@ paths: items: type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: &609 + state: &608 description: Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`. type: string enum: - open - resolved - resolution: &610 + resolution: &609 type: - string - 'null' @@ -47087,14 +49655,14 @@ paths: first_location_detected: anyOf: - type: 'null' - - &611 + - &610 description: 'Details on the location where the token was initially detected. This can be a commit, wiki commit, issue, discussion, pull request. ' oneOf: - - &613 + - &612 description: Represents a 'commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository. @@ -47141,6 +49709,13 @@ paths: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit + resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -47151,7 +49726,7 @@ paths: - blob_url - commit_sha - commit_url - - &614 + - &613 description: Represents a 'wiki_commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository wiki. @@ -47212,7 +49787,7 @@ paths: - page_url - commit_sha - commit_url - - &615 + - &614 description: Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue. @@ -47225,9 +49800,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url - - &616 + - &615 description: Represents an 'issue_body' secret scanning location type. This location type shows that a secret was detected in the body of an issue. @@ -47240,9 +49822,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url - - &617 + - &616 description: Represents an 'issue_comment' secret scanning location type. This location type shows that a secret was detected in a comment on an issue. @@ -47255,9 +49844,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url - - &618 + - &617 description: Represents a 'discussion_title' secret scanning location type. This location type shows that a secret was detected in the title of a discussion. @@ -47272,7 +49868,7 @@ paths: - https://github.com/community/community/discussions/39082 required: - discussion_title_url - - &619 + - &618 description: Represents a 'discussion_body' secret scanning location type. This location type shows that a secret was detected in the body of a discussion. @@ -47287,7 +49883,7 @@ paths: - https://github.com/community/community/discussions/39082#discussion-4566270 required: - discussion_body_url - - &620 + - &619 description: Represents a 'discussion_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a discussion. @@ -47302,7 +49898,7 @@ paths: - https://github.com/community/community/discussions/39082#discussioncomment-4158232 required: - discussion_comment_url - - &621 + - &620 description: Represents a 'pull_request_title' secret scanning location type. This location type shows that a secret was detected in the title of a pull request. @@ -47315,9 +49911,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url - - &622 + - &621 description: Represents a 'pull_request_body' secret scanning location type. This location type shows that a secret was detected in the body of a pull request. @@ -47330,9 +49933,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url - - &623 + - &622 description: Represents a 'pull_request_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a pull request. @@ -47345,9 +49955,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url - - &624 + - &623 description: Represents a 'pull_request_review' secret scanning location type. This location type shows that a secret was detected in a review on a pull request. @@ -47360,9 +49977,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url - - &625 + - &624 description: Represents a 'pull_request_review_comment' secret scanning location type. This location type shows that a secret was detected in a review comment on a pull @@ -47376,6 +50000,13 @@ paths: comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url has_more_locations: @@ -47602,7 +50233,7 @@ paths: related to push protection. type: object properties: - pattern_config_version: &313 + pattern_config_version: &312 type: - string - 'null' @@ -47612,7 +50243,7 @@ paths: provider_pattern_overrides: type: array description: Overrides for partner patterns. - items: &312 + items: &311 type: object properties: token_type: @@ -47681,7 +50312,7 @@ paths: custom_pattern_overrides: type: array description: Overrides for custom patterns defined by the organization. - items: *312 + items: *311 examples: default: value: @@ -47738,7 +50369,7 @@ paths: schema: type: object properties: - pattern_config_version: *313 + pattern_config_version: *312 provider_pattern_settings: type: array description: Pattern settings for provider patterns. @@ -47764,7 +50395,7 @@ paths: token_type: type: string description: The ID of the pattern to configure. - custom_pattern_version: *313 + custom_pattern_version: *312 push_protection_setting: type: string description: Push protection setting to set for the pattern. @@ -47862,7 +50493,7 @@ paths: application/json: schema: type: array - items: &629 + items: &628 description: A repository security advisory. type: object properties: @@ -48085,7 +50716,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 credits_detailed: type: - array @@ -48096,7 +50727,7 @@ paths: type: object properties: user: *4 - type: *314 + type: *313 state: type: string description: The state of the user's acceptance of the @@ -48122,7 +50753,7 @@ paths: - array - 'null' description: A list of teams that collaborate on the advisory. - items: *188 + items: *187 private_fork: readOnly: true description: A temporary private fork of the advisory's repository @@ -48159,7 +50790,7 @@ paths: - private_fork additionalProperties: false examples: - default: &630 + default: &629 value: - ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -48546,7 +51177,7 @@ paths: application/json: schema: type: array - items: *245 + items: *244 examples: default: value: @@ -48766,9 +51397,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -48837,7 +51468,7 @@ paths: url: https://docs.github.com/rest/orgs/orgs#enable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -48860,7 +51491,7 @@ paths: url: https://docs.github.com/rest/orgs/orgs#disable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -48901,7 +51532,7 @@ paths: type: integer network_configurations: type: array - items: &315 + items: &314 title: Hosted compute network configuration description: A hosted compute network configuration. type: object @@ -49026,6 +51657,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -49041,9 +51685,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: &316 + default: &315 value: id: 123456789ABCDEF name: My network configuration @@ -49072,7 +51716,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization parameters: - *73 - - &317 + - &316 name: network_configuration_id description: Unique identifier of the hosted compute network configuration. in: path @@ -49084,9 +51728,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: *316 + default: *315 headers: Link: *65 x-github: @@ -49108,7 +51752,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization parameters: - *73 - - *317 + - *316 requestBody: required: true content: @@ -49136,6 +51780,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -49148,9 +51805,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: *316 + default: *315 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49170,7 +51827,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#delete-a-hosted-compute-network-configuration-from-an-organization parameters: - *73 - - *317 + - *316 responses: '204': description: Response @@ -49315,13 +51972,13 @@ paths: application/json: schema: type: array - items: *318 + items: *317 examples: - default: *319 + default: *318 '500': *53 '403': *27 '404': *6 - '422': *320 + '422': *319 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49361,9 +52018,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 headers: Link: *65 '403': *27 @@ -49449,7 +52106,7 @@ paths: description: Response content: application/json: - schema: &321 + schema: &320 title: Full Team description: Groups of organization members that gives permissions on specified repositories. @@ -49523,7 +52180,7 @@ paths: parent: anyOf: - type: 'null' - - *245 + - *244 members_count: type: integer examples: @@ -49848,7 +52505,7 @@ paths: - repos_count - organization examples: - default: &322 + default: &321 value: id: 1 node_id: MDQ6VGVhbTE= @@ -49925,9 +52582,9 @@ paths: description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 x-github: githubCloudOnly: false @@ -50012,16 +52669,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '201': description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 '422': *15 '403': *27 @@ -50051,7 +52708,7 @@ paths: responses: '204': description: Response - '422': &323 + '422': &322 description: Unprocessable entity if you attempt to modify an enterprise team at the organization level. x-github: @@ -50085,12 +52742,12 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 - '422': *323 + '422': *322 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -50172,7 +52829,7 @@ paths: description: Response content: application/json: - schema: &324 + schema: &323 title: Team Membership description: Team Membership type: object @@ -50200,7 +52857,7 @@ paths: - state - url examples: - response-if-user-is-a-team-maintainer: &646 + response-if-user-is-a-team-maintainer: &645 summary: Response if user is a team maintainer value: url: https://api.github.com/teams/1/memberships/octocat @@ -50263,9 +52920,9 @@ paths: description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-users-membership-with-team-is-now-pending: &647 + response-if-users-membership-with-team-is-now-pending: &646 summary: Response if user's membership with team is now pending value: url: https://api.github.com/teams/1/memberships/octocat @@ -50339,9 +52996,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 x-github: @@ -50372,14 +53029,14 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 responses: '200': description: Alternative response with repository permissions content: application/json: - schema: &648 + schema: &647 title: Team Repository description: A team's access to a repository. type: object @@ -51015,8 +53672,8 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 requestBody: required: false content: @@ -51063,8 +53720,8 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 responses: '204': description: Response @@ -51099,9 +53756,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - response-if-child-teams-exist: &649 + response-if-child-teams-exist: &648 value: - id: 2 node_id: MDQ6VGVhbTI= @@ -51255,7 +53912,7 @@ paths: resources: type: object properties: - core: &327 + core: &326 title: Rate Limit type: object properties: @@ -51272,17 +53929,17 @@ paths: - remaining - reset - used - graphql: *327 - search: *327 - code_search: *327 - source_import: *327 - integration_manifest: *327 - code_scanning_upload: *327 - actions_runner_registration: *327 - scim: *327 - dependency_snapshots: *327 - dependency_sbom: *327 - code_scanning_autofix: *327 + graphql: *326 + search: *326 + code_search: *326 + source_import: *326 + integration_manifest: *326 + code_scanning_upload: *326 + actions_runner_registration: *326 + scim: *326 + dependency_snapshots: *326 + dependency_sbom: *326 + code_scanning_autofix: *326 required: - core - search @@ -51389,14 +54046,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#get-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *328 + schema: *327 examples: default-response: summary: Default response @@ -51901,7 +54558,7 @@ paths: status: disabled '403': *27 '404': *6 - '301': *329 + '301': *328 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -51919,8 +54576,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#update-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -52212,10 +54869,10 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 - '307': &331 + default: *329 + '307': &330 description: Temporary Redirect content: application/json: @@ -52244,8 +54901,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#delete-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -52267,7 +54924,7 @@ paths: value: message: Organization members cannot delete repositories. documentation_url: https://docs.github.com/rest/repos/repos#delete-a-repository - '307': *331 + '307': *330 '404': *6 '409': *52 x-github: @@ -52291,11 +54948,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#list-artifacts-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 - - &364 + - &363 name: name description: The name field of an artifact. When specified, only artifacts with this name will be returned. @@ -52318,7 +54975,7 @@ paths: type: integer artifacts: type: array - items: &332 + items: &331 title: Artifact description: An artifact type: object @@ -52413,7 +55070,7 @@ paths: - expires_at - updated_at examples: - default: &365 + default: &364 value: total_count: 2 artifacts: @@ -52474,9 +55131,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#get-an-artifact parameters: + - *324 - *325 - - *326 - - &333 + - &332 name: artifact_id description: The unique identifier of the artifact. in: path @@ -52488,7 +55145,7 @@ paths: description: Response content: application/json: - schema: *332 + schema: *331 examples: default: value: @@ -52526,9 +55183,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#delete-an-artifact parameters: + - *324 - *325 - - *326 - - *333 + - *332 responses: '204': description: Response @@ -52552,9 +55209,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#download-an-artifact parameters: + - *324 - *325 - - *326 - - *333 + - *332 - name: archive_format in: path required: true @@ -52568,7 +55225,7 @@ paths: example: https://pipelines.actions.githubusercontent.com/OhgS4QRKqmgx7bKC27GKU83jnQjyeqG8oIMTge8eqtheppcmw8/_apis/pipelines/1/runs/176/signedlogcontent?urlExpires=2020-01-24T18%3A10%3A31.5729946Z&urlSigningMethod=HMACV1&urlSignature=agG73JakPYkHrh06seAkvmH7rBR4Ji4c2%2B6a2ejYh3E%3D schema: type: string - '410': &520 + '410': &519 description: Gone content: application/json: @@ -52593,14 +55250,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-retention-limit-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &334 + schema: &333 title: Actions cache retention limit for a repository description: GitHub Actions cache retention policy for a repository. type: object @@ -52634,13 +55291,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#set-github-actions-cache-retention-limit-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *334 + schema: *333 examples: selected_actions: *40 responses: @@ -52669,14 +55326,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-storage-limit-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &335 + schema: &334 title: Actions cache storage limit for a repository description: GitHub Actions cache storage policy for a repository. type: object @@ -52710,13 +55367,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#set-github-actions-cache-storage-limit-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *335 + schema: *334 examples: selected_actions: *42 responses: @@ -52747,14 +55404,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-usage-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *336 + schema: *335 examples: default: value: @@ -52780,11 +55437,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#list-github-actions-caches-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 - - &337 + - &336 name: ref description: The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/`. To reference @@ -52818,7 +55475,7 @@ paths: description: Response content: application/json: - schema: &338 + schema: &337 title: Repository actions caches description: Repository actions caches type: object @@ -52868,7 +55525,7 @@ paths: - total_count - actions_caches examples: - default: &339 + default: &338 value: total_count: 1 actions_caches: @@ -52900,23 +55557,23 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#delete-github-actions-caches-for-a-repository-using-a-cache-key parameters: + - *324 - *325 - - *326 - name: key description: A key for identifying the cache. in: query required: true schema: type: string - - *337 + - *336 responses: '200': description: Response content: application/json: - schema: *338 + schema: *337 examples: - default: *339 + default: *338 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -52936,8 +55593,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#delete-a-github-actions-cache-for-a-repository-using-a-cache-id parameters: + - *324 - *325 - - *326 - name: cache_id description: The unique identifier of the GitHub Actions cache. in: path @@ -52968,9 +55625,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#get-a-job-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - &340 + - &339 name: job_id description: The unique identifier of the job. in: path @@ -52982,7 +55639,7 @@ paths: description: Response content: application/json: - schema: &368 + schema: &367 title: Job description: Information of a job execution in a workflow run type: object @@ -53329,9 +55986,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *340 + - *339 responses: '302': description: Response @@ -53359,9 +56016,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run parameters: + - *324 - *325 - - *326 - - *340 + - *339 requestBody: required: false content: @@ -53383,7 +56040,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -53407,8 +56064,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Status response @@ -53458,8 +56115,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -53493,7 +56150,7 @@ paths: description: Empty response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -53522,8 +56179,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-repository-organization-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -53541,7 +56198,7 @@ paths: type: integer secrets: type: array - items: &370 + items: &369 title: Actions Secret description: Set secrets for GitHub Actions. type: object @@ -53562,7 +56219,7 @@ paths: - created_at - updated_at examples: - default: &371 + default: &370 value: total_count: 2 secrets: @@ -53595,9 +56252,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-repository-organization-variables parameters: + - *324 - *325 - - *326 - - *341 + - *340 - *19 responses: '200': @@ -53614,7 +56271,7 @@ paths: type: integer variables: type: array - items: &374 + items: &373 title: Actions Variable type: object properties: @@ -53648,7 +56305,7 @@ paths: - created_at - updated_at examples: - default: &375 + default: &374 value: total_count: 2 variables: @@ -53681,8 +56338,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-github-actions-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -53691,12 +56348,12 @@ paths: schema: type: object properties: - enabled: &343 + enabled: &342 type: boolean description: Whether GitHub Actions is enabled on the repository. - allowed_actions: *138 - selected_actions_url: *342 - sha_pinning_required: *139 + allowed_actions: *137 + selected_actions_url: *341 + sha_pinning_required: *138 required: - enabled examples: @@ -53724,8 +56381,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-github-actions-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -53736,9 +56393,9 @@ paths: schema: type: object properties: - enabled: *343 - allowed_actions: *138 - sha_pinning_required: *139 + enabled: *342 + allowed_actions: *137 + sha_pinning_required: *138 required: - enabled examples: @@ -53768,14 +56425,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &344 + schema: &343 type: object properties: access_level: @@ -53792,7 +56449,7 @@ paths: required: - access_level examples: - default: &345 + default: &344 value: access_level: organization x-github: @@ -53816,15 +56473,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *344 + schema: *343 examples: - default: *345 + default: *344 responses: '204': description: Response @@ -53848,14 +56505,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-artifact-and-log-retention-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *346 + schema: *345 examples: default: value: @@ -53879,8 +56536,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-artifact-and-log-retention-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Empty response for successful settings update @@ -53890,7 +56547,7 @@ paths: required: true content: application/json: - schema: *347 + schema: *346 examples: default: summary: Set retention days @@ -53914,16 +56571,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *140 + schema: *139 examples: - default: *348 + default: *347 '404': *6 x-github: enabledForGitHubApps: true @@ -53942,8 +56599,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -53953,7 +56610,7 @@ paths: required: true content: application/json: - schema: *140 + schema: *139 examples: default: summary: Set approval policy to first time contributors @@ -53977,16 +56634,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *349 + schema: *348 examples: - default: *141 + default: *140 '403': *27 '404': *6 x-github: @@ -54006,15 +56663,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *350 + schema: *349 examples: - default: *141 + default: *140 responses: '204': description: Empty response for successful settings update @@ -54038,16 +56695,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *143 + schema: *142 examples: - default: *144 + default: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -54066,8 +56723,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -54075,9 +56732,9 @@ paths: required: false content: application/json: - schema: *143 + schema: *142 examples: - selected_actions: *144 + selected_actions: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -54099,16 +56756,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-default-workflow-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *351 + schema: *350 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54129,8 +56786,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-default-workflow-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Success response @@ -54141,9 +56798,9 @@ paths: required: true content: application/json: - schema: *352 + schema: *351 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54170,8 +56827,8 @@ paths: in: query schema: type: string + - *324 - *325 - - *326 - *17 - *19 responses: @@ -54189,9 +56846,9 @@ paths: type: integer runners: type: array - items: *155 + items: *154 examples: - default: *156 + default: *155 headers: Link: *65 x-github: @@ -54215,8 +56872,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#list-runner-applications-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -54224,9 +56881,9 @@ paths: application/json: schema: type: array - items: *353 + items: *352 examples: - default: *354 + default: *353 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54248,8 +56905,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -54292,7 +56949,7 @@ paths: - no-gpu work_folder: _work responses: - '201': *355 + '201': *354 '404': *6 '422': *7 '409': *52 @@ -54323,16 +56980,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-a-registration-token-for-a-repository parameters: + - *324 - *325 - - *326 responses: '201': description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: *356 + default: *355 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54360,16 +57017,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-a-remove-token-for-a-repository parameters: + - *324 - *325 - - *326 responses: '201': description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: *357 + default: *356 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54391,17 +57048,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: '200': description: Response content: application/json: - schema: *155 + schema: *154 examples: - default: *358 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -54422,9 +57079,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: '204': description: Response @@ -54450,11 +57107,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: - '200': *159 + '200': *158 '404': *6 x-github: githubCloudOnly: false @@ -54476,9 +57133,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 requestBody: required: true content: @@ -54502,7 +57159,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -54526,9 +57183,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 requestBody: required: true content: @@ -54553,7 +57210,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -54577,11 +57234,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: - '200': *359 + '200': *358 '404': *6 x-github: githubCloudOnly: false @@ -54608,12 +57265,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 - - *360 + - *153 + - *359 responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -54639,9 +57296,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#list-workflow-runs-for-a-repository parameters: + - *324 - *325 - - *326 - - &378 + - &377 name: actor description: Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. @@ -54649,7 +57306,7 @@ paths: required: false schema: type: string - - &379 + - &378 name: branch description: Returns workflow runs associated with a branch. Use the name of the branch of the `push`. @@ -54657,7 +57314,7 @@ paths: required: false schema: type: string - - &380 + - &379 name: event description: Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events @@ -54666,7 +57323,7 @@ paths: required: false schema: type: string - - &381 + - &380 name: status description: Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status @@ -54693,7 +57350,7 @@ paths: - pending - *17 - *19 - - &382 + - &381 name: created description: Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." @@ -54702,7 +57359,7 @@ paths: schema: type: string format: date-time - - &361 + - &360 name: exclude_pull_requests description: If `true` pull requests are omitted from the response (empty array). @@ -54711,13 +57368,13 @@ paths: schema: type: boolean default: false - - &383 + - &382 name: check_suite_id description: Returns workflow runs with the `check_suite_id` that you specify. in: query schema: type: integer - - &384 + - &383 name: head_sha description: Only returns workflow runs that are associated with the specified `head_sha`. @@ -54740,7 +57397,7 @@ paths: type: integer workflow_runs: type: array - items: &362 + items: &361 title: Workflow Run description: An invocation of a workflow type: object @@ -54918,7 +57575,7 @@ paths: head_commit: anyOf: - type: 'null' - - &406 + - &405 title: Simple Commit description: A commit. type: object @@ -54992,8 +57649,8 @@ paths: - timestamp - author - committer - repository: *153 - head_repository: *153 + repository: *152 + head_repository: *152 head_repository_id: type: integer examples: @@ -55033,7 +57690,7 @@ paths: - workflow_url - pull_requests examples: - default: &385 + default: &384 value: total_count: 1 workflow_runs: @@ -55269,24 +57926,24 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-a-workflow-run parameters: + - *324 - *325 - - *326 - - &363 + - &362 name: run_id description: The unique identifier of the workflow run. in: path required: true schema: type: integer - - *361 + - *360 responses: '200': description: Response content: application/json: - schema: *362 + schema: *361 examples: - default: &366 + default: &365 value: id: 30433642 name: Build @@ -55527,9 +58184,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#delete-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '204': description: Response @@ -55552,9 +58209,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-the-review-history-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -55682,15 +58339,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#approve-a-workflow-run-for-a-fork-pull-request parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -55717,12 +58374,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#list-workflow-run-artifacts parameters: + - *324 - *325 - - *326 - - *363 + - *362 - *17 - *19 - - *364 + - *363 - *59 responses: '200': @@ -55739,9 +58396,9 @@ paths: type: integer artifacts: type: array - items: *332 + items: *331 examples: - default: *365 + default: *364 headers: Link: *65 x-github: @@ -55765,25 +58422,25 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-a-workflow-run-attempt parameters: + - *324 - *325 - - *326 - - *363 - - &367 + - *362 + - &366 name: attempt_number description: The attempt number of the workflow run. in: path required: true schema: type: integer - - *361 + - *360 responses: '200': description: Response content: application/json: - schema: *362 + schema: *361 examples: - default: *366 + default: *365 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55806,10 +58463,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run-attempt parameters: + - *324 - *325 - - *326 - - *363 - - *367 + - *362 + - *366 - *17 - *19 responses: @@ -55827,9 +58484,9 @@ paths: type: integer jobs: type: array - items: *368 + items: *367 examples: - default: &369 + default: &368 value: total_count: 1 jobs: @@ -55942,10 +58599,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#download-workflow-run-attempt-logs parameters: + - *324 - *325 - - *326 - - *363 - - *367 + - *362 + - *366 responses: '302': description: Response @@ -55973,15 +58630,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#cancel-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '202': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56008,9 +58665,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: true content: @@ -56077,15 +58734,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#force-cancel-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '202': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56112,9 +58769,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 - name: filter description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all @@ -56144,9 +58801,9 @@ paths: type: integer jobs: type: array - items: *368 + items: *367 examples: - default: *369 + default: *368 headers: Link: *65 x-github: @@ -56171,9 +58828,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#download-workflow-run-logs parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '302': description: Response @@ -56200,9 +58857,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#delete-workflow-run-logs parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '204': description: Response @@ -56229,9 +58886,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -56300,7 +58957,7 @@ paths: items: type: object properties: - type: &486 + type: &485 type: string description: The type of reviewer. enum: @@ -56311,7 +58968,7 @@ paths: reviewer: anyOf: - *4 - - *188 + - *187 required: - environment - wait_timer @@ -56386,9 +59043,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: true content: @@ -56438,7 +59095,7 @@ paths: application/json: schema: type: array - items: &481 + items: &480 title: Deployment description: A request for a specific ref(branch,sha,tag) to be deployed @@ -56550,7 +59207,7 @@ paths: - created_at - updated_at examples: - default: &482 + default: &481 value: - url: https://api.github.com/repos/octocat/example/deployments/1 id: 1 @@ -56606,9 +59263,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-a-workflow parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: false content: @@ -56630,7 +59287,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56653,9 +59310,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-failed-jobs-from-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: false content: @@ -56677,7 +59334,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56709,9 +59366,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-workflow-run-usage parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -56848,8 +59505,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -56867,9 +59524,9 @@ paths: type: integer secrets: type: array - items: *370 + items: *369 examples: - default: *371 + default: *370 headers: Link: *65 x-github: @@ -56894,16 +59551,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -56925,17 +59582,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *370 + schema: *369 examples: - default: &499 + default: &498 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -56961,9 +59618,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -56994,7 +59651,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57020,9 +59677,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -57047,9 +59704,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-repository-variables parameters: + - *324 - *325 - - *326 - - *341 + - *340 - *19 responses: '200': @@ -57066,9 +59723,9 @@ paths: type: integer variables: type: array - items: *374 + items: *373 examples: - default: *375 + default: *374 headers: Link: *65 x-github: @@ -57091,8 +59748,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#create-a-repository-variable parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -57119,7 +59776,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57144,17 +59801,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#get-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 responses: '200': description: Response content: application/json: - schema: *374 + schema: *373 examples: - default: &500 + default: &499 value: name: USERNAME value: octocat @@ -57180,9 +59837,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#update-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 requestBody: required: true content: @@ -57224,9 +59881,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#delete-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 responses: '204': description: Response @@ -57251,8 +59908,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#list-repository-workflows parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -57270,7 +59927,7 @@ paths: type: integer workflows: type: array - items: &376 + items: &375 title: Workflow description: A GitHub Actions workflow type: object @@ -57388,9 +60045,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#get-a-workflow parameters: + - *324 - *325 - - *326 - - &377 + - &376 name: workflow_id in: path description: The ID of the workflow. You can also pass the workflow file name @@ -57405,7 +60062,7 @@ paths: description: Response content: application/json: - schema: *376 + schema: *375 examples: default: value: @@ -57438,9 +60095,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#disable-a-workflow parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Response @@ -57465,9 +60122,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#create-a-workflow-dispatch-event parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '200': description: Response including the workflow run ID and URLs when `return_run_details` @@ -57548,9 +60205,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#enable-a-workflow parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Response @@ -57577,19 +60234,19 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#list-workflow-runs-for-a-workflow parameters: + - *324 - *325 - - *326 + - *376 - *377 - *378 - *379 - *380 - - *381 - *17 - *19 + - *381 + - *360 - *382 - - *361 - *383 - - *384 responses: '200': description: Response @@ -57605,9 +60262,9 @@ paths: type: integer workflow_runs: type: array - items: *362 + items: *361 examples: - default: *385 + default: *384 headers: Link: *65 x-github: @@ -57639,9 +60296,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#get-workflow-usage parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '200': description: Response @@ -57702,8 +60359,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-activities parameters: + - *324 - *325 - - *326 - *59 - *17 - *45 @@ -57871,8 +60528,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#list-assignees parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -57909,8 +60566,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#check-if-a-user-can-be-assigned parameters: + - *324 - *325 - - *326 - name: assignee in: path required: true @@ -57946,8 +60603,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/attestations#create-an-attestation parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -58057,8 +60714,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/attestations#list-attestations parameters: + - *324 - *325 - - *326 - *17 - *45 - *46 @@ -58099,7 +60756,7 @@ paths: initiator: type: string examples: - default: *386 + default: *385 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -58119,8 +60776,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#get-all-autolinks-of-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -58128,7 +60785,7 @@ paths: application/json: schema: type: array - items: &387 + items: &386 title: Autolink reference description: An autolink reference. type: object @@ -58187,8 +60844,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#create-an-autolink-reference-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -58227,9 +60884,9 @@ paths: description: response content: application/json: - schema: *387 + schema: *386 examples: - default: &388 + default: &387 value: id: 1 key_prefix: TICKET- @@ -58260,9 +60917,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#get-an-autolink-reference-of-a-repository parameters: + - *324 - *325 - - *326 - - &389 + - &388 name: autolink_id description: The unique identifier of the autolink. in: path @@ -58274,9 +60931,9 @@ paths: description: Response content: application/json: - schema: *387 + schema: *386 examples: - default: *388 + default: *387 '404': *6 x-github: githubCloudOnly: false @@ -58296,9 +60953,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#delete-an-autolink-reference-from-a-repository parameters: + - *324 - *325 - - *326 - - *389 + - *388 responses: '204': description: Response @@ -58322,8 +60979,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-dependabot-security-updates-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response if Dependabot is enabled @@ -58373,8 +61030,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-dependabot-security-updates parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -58395,8 +61052,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-dependabot-security-updates parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -58416,8 +61073,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#list-branches parameters: + - *324 - *325 - - *326 - name: protected description: Setting to `true` returns only branches protected by branch protections or rulesets. When set to `false`, only unprotected branches are returned. @@ -58455,7 +61112,7 @@ paths: - url protected: type: boolean - protection: &391 + protection: &390 title: Branch Protection description: Branch Protection type: object @@ -58498,7 +61155,7 @@ paths: required: - contexts - checks - enforce_admins: &394 + enforce_admins: &393 title: Protected Branch Admin Enforced description: Protected Branch Admin Enforced type: object @@ -58515,7 +61172,7 @@ paths: required: - url - enabled - required_pull_request_reviews: &396 + required_pull_request_reviews: &395 title: Protected Branch Pull Request Review description: Protected Branch Pull Request Review type: object @@ -58537,7 +61194,7 @@ paths: description: The list of teams with review dismissal access. type: array - items: *188 + items: *187 apps: description: The list of apps with review dismissal access. @@ -58569,7 +61226,7 @@ paths: description: The list of teams allowed to bypass pull request requirements. type: array - items: *188 + items: *187 apps: description: The list of apps allowed to bypass pull request requirements. @@ -58599,7 +61256,7 @@ paths: required: - dismiss_stale_reviews - require_code_owner_reviews - restrictions: &393 + restrictions: &392 title: Branch Restriction Policy description: Branch Restriction Policy type: object @@ -58662,7 +61319,7 @@ paths: type: string teams: type: array - items: *188 + items: *187 apps: type: array items: @@ -58892,9 +61549,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#get-a-branch parameters: + - *324 - *325 - - *326 - - &392 + - &391 name: branch description: The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use [the GraphQL API](https://docs.github.com/graphql). @@ -58908,14 +61565,14 @@ paths: description: Response content: application/json: - schema: &402 + schema: &401 title: Branch With Protection description: Branch With Protection type: object properties: name: type: string - commit: &456 + commit: &455 title: Commit description: Commit type: object @@ -58954,7 +61611,7 @@ paths: author: anyOf: - type: 'null' - - &390 + - &389 title: Git User description: Metaproperties for Git author/committer information. @@ -58976,7 +61633,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 message: type: string examples: @@ -59000,7 +61657,7 @@ paths: required: - sha - url - verification: &506 + verification: &505 title: Verification type: object properties: @@ -59036,14 +61693,14 @@ paths: author: oneOf: - *4 - - *162 + - *161 type: - 'null' - object committer: oneOf: - *4 - - *162 + - *161 type: - 'null' - object @@ -59080,7 +61737,7 @@ paths: type: integer files: type: array - items: &467 + items: &466 title: Diff Entry description: Diff Entry type: object @@ -59176,7 +61833,7 @@ paths: - self protected: type: boolean - protection: *391 + protection: *390 protection_url: type: string format: uri @@ -59285,7 +61942,7 @@ paths: contexts: [] checks: [] protection_url: https://api.github.com/repos/octocat/Hello-World/branches/main/protection - '301': *329 + '301': *328 '404': *6 x-github: githubCloudOnly: false @@ -59307,15 +61964,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *391 + schema: *390 examples: default: value: @@ -59509,9 +62166,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -59771,7 +62428,7 @@ paths: url: type: string format: uri - required_status_checks: &399 + required_status_checks: &398 title: Status Check Policy description: Status Check Policy type: object @@ -59852,7 +62509,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 apps: type: array items: *5 @@ -59870,7 +62527,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 apps: type: array items: *5 @@ -59930,7 +62587,7 @@ paths: additionalProperties: false required: - enabled - restrictions: *393 + restrictions: *392 required_conversation_resolution: type: object properties: @@ -60042,9 +62699,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60069,17 +62726,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: &395 + default: &394 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins enabled: true @@ -60101,17 +62758,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: *395 + default: *394 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -60130,9 +62787,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60157,17 +62814,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *396 + schema: *395 examples: - default: &397 + default: &396 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews dismissal_restrictions: @@ -60263,9 +62920,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -60363,9 +63020,9 @@ paths: description: Response content: application/json: - schema: *396 + schema: *395 examples: - default: *397 + default: *396 '422': *15 x-github: githubCloudOnly: false @@ -60386,9 +63043,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60415,17 +63072,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: &398 + default: &397 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_signatures enabled: true @@ -60448,17 +63105,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#create-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: *398 + default: *397 '404': *6 x-github: githubCloudOnly: false @@ -60478,9 +63135,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60505,17 +63162,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-status-checks-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *399 + schema: *398 examples: - default: &400 + default: &399 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks strict: true @@ -60541,9 +63198,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-status-check-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -60595,9 +63252,9 @@ paths: description: Response content: application/json: - schema: *399 + schema: *398 examples: - default: *400 + default: *399 '404': *6 '422': *15 x-github: @@ -60619,9 +63276,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-status-check-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -60645,9 +63302,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-all-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -60681,9 +63338,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -60750,9 +63407,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -60816,9 +63473,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: content: application/json: @@ -60884,15 +63541,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *393 + schema: *392 examples: default: value: @@ -60983,9 +63640,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61008,9 +63665,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-apps-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61020,7 +63677,7 @@ paths: type: array items: *5 examples: - default: &401 + default: &400 value: - id: 1 slug: octoapp @@ -61077,9 +63734,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61113,7 +63770,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -61134,9 +63791,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61170,7 +63827,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -61191,9 +63848,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61227,7 +63884,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -61249,9 +63906,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-teams-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61259,9 +63916,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '404': *6 x-github: githubCloudOnly: false @@ -61281,9 +63938,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61319,9 +63976,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -61342,9 +63999,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61380,9 +64037,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -61403,9 +64060,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: content: application/json: @@ -61440,9 +64097,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -61464,9 +64121,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-users-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61500,9 +64157,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61560,9 +64217,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61620,9 +64277,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61682,9 +64339,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#rename-a-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -61706,7 +64363,7 @@ paths: description: Response content: application/json: - schema: *402 + schema: *401 examples: default: value: @@ -61822,8 +64479,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#create-a-check-run parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -62102,7 +64759,7 @@ paths: description: Response content: application/json: - schema: &403 + schema: &402 title: CheckRun description: A check performed on the code of a given code change type: object @@ -62238,7 +64895,7 @@ paths: check. type: array items: *84 - deployment: &711 + deployment: &710 title: Deployment description: A deployment created as the result of an Actions check run from a workflow that references an environment @@ -62525,9 +65182,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#get-a-check-run parameters: + - *324 - *325 - - *326 - - &404 + - &403 name: check_run_id description: The unique identifier of the check run. in: path @@ -62539,9 +65196,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: &405 + default: &404 value: id: 4 head_sha: ce587453ced02b1526dfb4cb910479d431683101 @@ -62641,9 +65298,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#update-a-check-run parameters: + - *324 - *325 - - *326 - - *404 + - *403 requestBody: required: true content: @@ -62883,9 +65540,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: *405 + default: *404 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -62905,9 +65562,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-run-annotations parameters: + - *324 - *325 - - *326 - - *404 + - *403 - *17 - *19 responses: @@ -63017,15 +65674,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#rerequest-a-check-run parameters: + - *324 - *325 - - *326 - - *404 + - *403 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -63063,8 +65720,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#create-a-check-suite parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -63086,7 +65743,7 @@ paths: description: Response when the suite already exists content: application/json: - schema: &407 + schema: &406 title: CheckSuite description: A suite of checks performed on the code of a given code change @@ -63173,7 +65830,7 @@ paths: anyOf: - type: 'null' - *5 - repository: *153 + repository: *152 created_at: type: - string @@ -63184,7 +65841,7 @@ paths: - string - 'null' format: date-time - head_commit: *406 + head_commit: *405 latest_check_runs_count: type: integer check_runs_url: @@ -63212,7 +65869,7 @@ paths: - check_runs_url - pull_requests examples: - default: &408 + default: &407 value: id: 5 node_id: MDEwOkNoZWNrU3VpdGU1 @@ -63503,9 +66160,9 @@ paths: description: Response when the suite was created content: application/json: - schema: *407 + schema: *406 examples: - default: *408 + default: *407 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -63524,8 +66181,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#update-repository-preferences-for-check-suites parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -63586,7 +66243,7 @@ paths: required: - app_id - setting - repository: *153 + repository: *152 examples: default: value: @@ -63834,9 +66491,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#get-a-check-suite parameters: + - *324 - *325 - - *326 - - &409 + - &408 name: check_suite_id description: The unique identifier of the check suite. in: path @@ -63848,9 +66505,9 @@ paths: description: Response content: application/json: - schema: *407 + schema: *406 examples: - default: *408 + default: *407 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -63873,17 +66530,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-runs-in-a-check-suite parameters: + - *324 - *325 - - *326 - - *409 - - &462 + - *408 + - &461 name: check_name description: Returns check runs with the specified `name`. in: query required: false schema: type: string - - &463 + - &462 name: status description: Returns check runs with the specified `status`. in: query @@ -63922,9 +66579,9 @@ paths: type: integer check_runs: type: array - items: *403 + items: *402 examples: - default: &464 + default: &463 value: total_count: 1 check_runs: @@ -64026,15 +66683,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#rerequest-a-check-suite parameters: + - *324 - *325 - - *326 - - *409 + - *408 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -64061,21 +66718,21 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *409 - *410 - - *411 - *19 - *17 - - &428 + - &427 name: ref description: The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. in: query required: false - schema: *412 - - &429 + schema: *411 + - &428 name: pr description: The number of the pull request for the results you want to list. in: query @@ -64100,13 +66757,13 @@ paths: be returned. in: query required: false - schema: *413 + schema: *412 - name: severity description: If specified, only code scanning alerts with this severity will be returned. in: query required: false - schema: *414 + schema: *413 - name: assignees description: | Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., `octocat` or `octocat,hubot`). @@ -64125,24 +66782,24 @@ paths: items: type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: *415 - state: *180 - fixed_at: *176 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: *414 + state: *179 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: *416 - dismissed_comment: *417 - rule: *418 - tool: *419 - most_recent_instance: *420 + dismissed_at: *176 + dismissed_reason: *415 + dismissed_comment: *416 + rule: *417 + tool: *418 + most_recent_instance: *419 dismissal_approved_by: anyOf: - type: 'null' @@ -64265,7 +66922,7 @@ paths: classifications: [] instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/3/instances '304': *35 - '403': &421 + '403': &420 description: Response if GitHub Advanced Security is not enabled for this repository content: @@ -64292,9 +66949,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - &422 + - &421 name: alert_number in: path description: The number that identifies an alert. You can find this at the @@ -64302,30 +66959,30 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *171 + schema: *170 responses: '200': description: Response content: application/json: - schema: &423 + schema: &422 type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: *415 - state: *180 - fixed_at: *176 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: *414 + state: *179 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: *416 - dismissed_comment: *417 + dismissed_at: *176 + dismissed_reason: *415 + dismissed_comment: *416 rule: type: object properties: @@ -64387,8 +67044,8 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: *419 - most_recent_instance: *420 + tool: *418 + most_recent_instance: *419 dismissal_approved_by: anyOf: - type: 'null' @@ -64484,7 +67141,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '304': *35 - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -64504,9 +67161,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#update-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: true content: @@ -64521,8 +67178,8 @@ paths: enum: - open - dismissed - dismissed_reason: *416 - dismissed_comment: *417 + dismissed_reason: *415 + dismissed_comment: *416 create_request: type: boolean description: If `true`, attempt to create an alert dismissal request. @@ -64550,7 +67207,7 @@ paths: description: Response content: application/json: - schema: *423 + schema: *422 examples: default: value: @@ -64626,7 +67283,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '400': *14 - '403': &427 + '403': &426 description: Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository content: @@ -64653,15 +67310,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 responses: '200': description: Response content: application/json: - schema: &424 + schema: &423 type: object properties: status: @@ -64688,13 +67345,13 @@ paths: - description - started_at examples: - default: &425 + default: &424 value: status: success description: This fixes an XSS vulnerability by escaping the user input. started_at: '2024-02-14T12:29:18Z' - '400': &426 + '400': &425 description: Bad Request content: application/json: @@ -64705,7 +67362,7 @@ paths: message: The alert_number is not valid documentation_url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert status: '400' - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -64730,29 +67387,29 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 responses: '200': description: OK content: application/json: - schema: *424 + schema: *423 examples: - default: *425 + default: *424 '202': description: Accepted content: application/json: - schema: *424 + schema: *423 examples: default: value: status: pending description: started_at: '2024-02-14T12:29:18Z' - '400': *426 + '400': *425 '403': description: Response if the repository is archived, if GitHub Advanced Security is not enabled for this repository or if rate limit is exceeded @@ -64784,9 +67441,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: false content: @@ -64832,8 +67489,8 @@ paths: value: target_ref: refs/heads/main sha: 178f4f6090b3fccad4a65b3e83d076a622d59652 - '400': *426 - '403': *427 + '400': *425 + '403': *426 '404': *6 '422': description: Unprocessable Entity @@ -64857,13 +67514,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 - *19 - *17 + - *427 - *428 - - *429 responses: '200': description: Response @@ -64874,10 +67531,10 @@ paths: items: type: object properties: - ref: *412 - analysis_key: *430 - environment: *431 - category: *432 + ref: *411 + analysis_key: *429 + environment: *430 + category: *431 state: type: - string @@ -64894,7 +67551,7 @@ paths: properties: text: type: string - location: *433 + location: *432 html_url: type: string classifications: @@ -64902,7 +67559,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: *434 + items: *433 examples: default: value: @@ -64939,7 +67596,7 @@ paths: end_column: 50 classifications: - source - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -64973,25 +67630,25 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository parameters: + - *324 - *325 - - *326 + - *409 - *410 - - *411 - *19 - *17 - - *429 + - *428 - name: ref in: query description: The Git reference for the analyses you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. required: false - schema: *412 + schema: *411 - name: sarif_id in: query description: Filter analyses belonging to the same SARIF upload. required: false - schema: &435 + schema: &434 type: string description: An identifier for the upload. examples: @@ -65013,23 +67670,23 @@ paths: application/json: schema: type: array - items: &436 + items: &435 type: object properties: - ref: *412 - commit_sha: &444 + ref: *411 + commit_sha: &443 description: The SHA of the commit to which the analysis you are uploading relates. type: string minLength: 40 maxLength: 40 pattern: "^[0-9a-fA-F]+$" - analysis_key: *430 + analysis_key: *429 environment: type: string description: Identifies the variable values associated with the environment in which this analysis was performed. - category: *432 + category: *431 error: type: string examples: @@ -65054,8 +67711,8 @@ paths: description: The REST API URL of the analysis resource. format: uri readOnly: true - sarif_id: *435 - tool: *419 + sarif_id: *434 + tool: *418 deletable: type: boolean warning: @@ -65117,7 +67774,7 @@ paths: version: 1.2.0 deletable: true warning: '' - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65153,8 +67810,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository parameters: + - *324 - *325 - - *326 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -65167,7 +67824,7 @@ paths: description: Response content: application/json: - schema: *436 + schema: *435 examples: response: summary: application/json response @@ -65221,7 +67878,7 @@ paths: properties: - github/alertNumber: 2 - github/alertUrl: https://api.github.com/repos/monalisa/monalisa/code-scanning/alerts/2 - '403': *421 + '403': *420 '404': *6 '422': description: Response if analysis could not be processed @@ -65308,8 +67965,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository parameters: + - *324 - *325 - - *326 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -65365,7 +68022,7 @@ paths: next_analysis_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41 confirm_delete_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41?confirm_delete '400': *14 - '403': *427 + '403': *426 '404': *6 '503': *113 x-github: @@ -65387,8 +68044,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -65396,7 +68053,7 @@ paths: application/json: schema: type: array - items: &437 + items: &436 title: CodeQL Database description: A CodeQL database. type: object @@ -65508,7 +68165,7 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65537,8 +68194,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository parameters: + - *324 - *325 - - *326 - name: language in: path description: The language of the CodeQL database. @@ -65550,7 +68207,7 @@ paths: description: Response content: application/json: - schema: *437 + schema: *436 examples: default: value: @@ -65582,9 +68239,9 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '302': &469 + '302': &468 description: Found - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65606,8 +68263,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#delete-a-codeql-database parameters: + - *324 - *325 - - *326 - name: language in: path description: The language of the CodeQL database. @@ -65617,7 +68274,7 @@ paths: responses: '204': description: Response - '403': *427 + '403': *426 '404': *6 '503': *113 x-github: @@ -65645,8 +68302,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#create-a-codeql-variant-analysis parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -65655,7 +68312,7 @@ paths: type: object additionalProperties: false properties: - language: &438 + language: &437 type: string description: The language targeted by the CodeQL query enum: @@ -65735,7 +68392,7 @@ paths: description: Variant analysis submitted for processing content: application/json: - schema: &442 + schema: &441 title: Variant Analysis description: A run of a CodeQL query against one or more repositories. type: object @@ -65745,7 +68402,7 @@ paths: description: The ID of the variant analysis. controller_repo: *64 actor: *4 - query_language: *438 + query_language: *437 query_pack_url: type: string description: The download url for the query pack. @@ -65793,7 +68450,7 @@ paths: items: type: object properties: - repository: &439 + repository: &438 title: Repository Identifier description: Repository Identifier type: object @@ -65835,7 +68492,7 @@ paths: - private - stargazers_count - updated_at - analysis_status: &443 + analysis_status: &442 type: string description: The new status of the CodeQL variant analysis repository task. @@ -65867,7 +68524,7 @@ paths: from processing. This information is only available to the user that initiated the variant analysis. properties: - access_mismatch_repos: &440 + access_mismatch_repos: &439 type: object properties: repository_count: @@ -65882,7 +68539,7 @@ paths: This list may not include all repositories that were skipped. This is only available when the repository was found and the user has access to it. - items: *439 + items: *438 required: - repository_count - repositories @@ -65905,8 +68562,8 @@ paths: required: - repository_count - repository_full_names - no_codeql_db_repos: *440 - over_limit_repos: *440 + no_codeql_db_repos: *439 + over_limit_repos: *439 required: - access_mismatch_repos - not_found_repos @@ -65922,7 +68579,7 @@ paths: examples: repositories_parameter: summary: Response for a successful variant analysis submission - value: &441 + value: &440 summary: Default response value: id: 1 @@ -66068,10 +68725,10 @@ paths: private: false repository_owners: summary: Response for a successful variant analysis submission - value: *441 + value: *440 repository_lists: summary: Response for a successful variant analysis submission - value: *441 + value: *440 '404': *6 '422': description: Unable to process variant analysis submission @@ -66099,8 +68756,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-summary-of-a-codeql-variant-analysis parameters: + - *324 - *325 - - *326 - name: codeql_variant_analysis_id in: path description: The unique identifier of the variant analysis. @@ -66112,9 +68769,9 @@ paths: description: Response content: application/json: - schema: *442 + schema: *441 examples: - default: *441 + default: *440 '404': *6 '503': *113 x-github: @@ -66137,7 +68794,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-analysis-status-of-a-repository-in-a-codeql-variant-analysis parameters: - - *325 + - *324 - name: repo in: path description: The name of the controller repository. @@ -66172,7 +68829,7 @@ paths: type: object properties: repository: *64 - analysis_status: *443 + analysis_status: *442 artifact_size_in_bytes: type: integer description: The size of the artifact. This is only available @@ -66297,8 +68954,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -66389,7 +69046,7 @@ paths: threat_model: remote updated_at: '2023-01-19T11:21:34Z' schedule: weekly - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66410,8 +69067,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -66480,7 +69137,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -66505,7 +69162,7 @@ paths: value: run_id: 42 run_url: https://api.github.com/repos/octoorg/octocat/actions/runs/42 - '403': *427 + '403': *426 '404': *6 '409': description: Response if there is already a validation run in progress with @@ -66576,8 +69233,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#upload-an-analysis-as-sarif-data parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -66585,7 +69242,7 @@ paths: schema: type: object properties: - commit_sha: *444 + commit_sha: *443 ref: type: string description: |- @@ -66645,7 +69302,7 @@ paths: schema: type: object properties: - id: *435 + id: *434 url: type: string description: The REST API URL for checking the status of the upload. @@ -66659,7 +69316,7 @@ paths: url: https://api.github.com/repos/octocat/hello-world/code-scanning/sarifs/47177e22-5596-11eb-80a1-c1e54ef945c6 '400': description: Bad Request if the sarif field is invalid - '403': *427 + '403': *426 '404': *6 '413': description: Payload Too Large if the sarif field is too large @@ -66682,8 +69339,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-information-about-a-sarif-upload parameters: + - *324 - *325 - - *326 - name: sarif_id description: The SARIF ID obtained after uploading. in: path @@ -66731,7 +69388,7 @@ paths: value: processing_status: complete analyses_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses?sarif_id=47177e22-5596-11eb-80a1-c1e54ef945c6 - '403': *421 + '403': *420 '404': description: Not Found if the sarif id does not match any upload '503': *113 @@ -66756,8 +69413,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-security/configurations#get-the-code-security-configuration-associated-with-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -66813,7 +69470,7 @@ paths: html_url: https://github.com/organizations/octo-org/settings/security_products/configurations/edit/1325 created_at: '2024-05-01T00:00:00Z' updated_at: '2024-05-01T00:00:00Z' - '204': *184 + '204': *183 '304': *35 '403': *27 '404': *6 @@ -66838,8 +69495,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-codeowners-errors parameters: + - *324 - *325 - - *326 - name: ref description: 'A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository''s default branch @@ -66967,8 +69624,8 @@ paths: parameters: - *17 - *19 + - *324 - *325 - - *326 responses: '200': description: Response @@ -66984,7 +69641,7 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: default: value: @@ -67282,8 +69939,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-codespace-in-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -67347,17 +70004,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '400': *14 '401': *23 '403': *27 @@ -67386,8 +70043,8 @@ paths: parameters: - *17 - *19 + - *324 - *325 - - *326 responses: '200': description: Response @@ -67451,8 +70108,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/machines#list-available-machine-types-for-a-repository parameters: + - *324 - *325 - - *326 - name: location description: The location to check for available machines. Assigned by IP if not provided. @@ -67489,9 +70146,9 @@ paths: type: integer machines: type: array - items: *446 + items: *445 examples: - default: &654 + default: &653 value: total_count: 2 machines: @@ -67531,8 +70188,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-default-attributes-for-a-codespace parameters: + - *324 - *325 - - *326 - name: ref description: The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked. @@ -67619,8 +70276,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user parameters: + - *324 - *325 - - *326 - name: ref description: The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of `ref` will typically @@ -67689,8 +70346,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -67708,7 +70365,7 @@ paths: type: integer secrets: type: array - items: &450 + items: &449 title: Codespaces Secret description: Set repository secrets for GitHub Codespaces. type: object @@ -67729,7 +70386,7 @@ paths: - created_at - updated_at examples: - default: *447 + default: *446 headers: Link: *65 x-github: @@ -67752,16 +70409,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *448 + schema: *447 examples: - default: *449 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -67781,17 +70438,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *450 + schema: *449 examples: - default: *451 + default: *450 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67811,9 +70468,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -67841,7 +70498,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -67865,9 +70522,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -67895,8 +70552,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#list-repository-collaborators parameters: + - *324 - *325 - - *326 - name: affiliation description: Filter collaborators returned by their affiliation. `outside` means all outside collaborators of an organization-owned repository. `direct` @@ -67934,7 +70591,7 @@ paths: application/json: schema: type: array - items: &452 + items: &451 title: Collaborator description: Collaborator type: object @@ -68127,8 +70784,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 responses: '204': @@ -68175,8 +70832,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#add-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 requestBody: required: false @@ -68203,7 +70860,7 @@ paths: description: Response when a new invitation is created content: application/json: - schema: &519 + schema: &518 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -68215,7 +70872,7 @@ paths: format: int64 examples: - 42 - repository: *153 + repository: *152 invitee: anyOf: - type: 'null' @@ -68431,8 +71088,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#remove-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 responses: '204': @@ -68464,8 +71121,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#get-repository-permissions-for-a-user parameters: + - *324 - *325 - - *326 - *69 responses: '200': @@ -68486,7 +71143,7 @@ paths: user: anyOf: - type: 'null' - - *452 + - *451 required: - permission - role_name @@ -68540,8 +71197,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#list-commit-comments-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -68551,7 +71208,7 @@ paths: application/json: schema: type: array - items: &453 + items: &452 title: Commit Comment description: Commit Comment type: object @@ -68609,7 +71266,7 @@ paths: - created_at - updated_at examples: - default: &458 + default: &457 value: - html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -68668,17 +71325,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#get-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': description: Response content: application/json: - schema: *453 + schema: *452 examples: - default: &459 + default: &458 value: html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -68735,8 +71392,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#update-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -68759,7 +71416,7 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: default: value: @@ -68810,8 +71467,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#delete-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -68833,8 +71490,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -68861,7 +71518,7 @@ paths: application/json: schema: type: array - items: &454 + items: &453 title: Reaction description: Reactions to conversations provide a way to help people express their feelings more simply and effectively. @@ -68905,7 +71562,7 @@ paths: - content - created_at examples: - default: &522 + default: &521 value: - id: 1 node_id: MDg6UmVhY3Rpb24x @@ -68950,8 +71607,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -68984,9 +71641,9 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: &455 + default: &454 value: id: 1 node_id: MDg6UmVhY3Rpb24x @@ -69015,9 +71672,9 @@ paths: description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -69039,10 +71696,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-commit-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - &523 + - &522 name: reaction_id description: The unique identifier of the reaction. in: path @@ -69097,8 +71754,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-commits parameters: + - *324 - *325 - - *326 - name: sha description: 'SHA or branch to start listing commits from. Default: the repository’s default branch (usually `main`).' @@ -69154,9 +71811,9 @@ paths: application/json: schema: type: array - items: *456 + items: *455 examples: - default: &569 + default: &568 value: - url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -69250,9 +71907,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-branches-for-head-commit parameters: + - *324 - *325 - - *326 - - &457 + - &456 name: commit_sha description: The SHA of the commit. in: path @@ -69324,9 +71981,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#list-commit-comments parameters: + - *324 - *325 - - *326 - - *457 + - *456 - *17 - *19 responses: @@ -69336,9 +71993,9 @@ paths: application/json: schema: type: array - items: *453 + items: *452 examples: - default: *458 + default: *457 headers: Link: *65 x-github: @@ -69366,9 +72023,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#create-a-commit-comment parameters: + - *324 - *325 - - *326 - - *457 + - *456 requestBody: required: true content: @@ -69403,9 +72060,9 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: - default: *459 + default: *458 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -69433,9 +72090,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-pull-requests-associated-with-a-commit parameters: + - *324 - *325 - - *326 - - *457 + - *456 - *17 - *19 responses: @@ -69445,9 +72102,9 @@ paths: application/json: schema: type: array - items: *460 + items: *459 examples: - default: &561 + default: &560 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -69984,11 +72641,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#get-a-commit parameters: + - *324 - *325 - - *326 - *19 - *17 - - &461 + - &460 name: ref description: 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](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" @@ -70003,9 +72660,9 @@ paths: description: Response content: application/json: - schema: *456 + schema: *455 examples: - default: &549 + default: &548 value: url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -70118,11 +72775,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-runs-for-a-git-reference parameters: + - *324 - *325 - - *326 + - *460 - *461 - *462 - - *463 - name: filter description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. @@ -70156,9 +72813,9 @@ paths: type: integer check_runs: type: array - items: *403 + items: *402 examples: - default: *464 + default: *463 headers: Link: *65 x-github: @@ -70183,9 +72840,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#list-check-suites-for-a-git-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - name: app_id description: Filters check suites by GitHub App `id`. in: query @@ -70193,7 +72850,7 @@ paths: schema: type: integer example: 1 - - *462 + - *461 - *17 - *19 responses: @@ -70211,7 +72868,7 @@ paths: type: integer check_suites: type: array - items: *407 + items: *406 examples: default: value: @@ -70411,9 +73068,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#get-the-combined-status-for-a-specific-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - *17 - *19 responses: @@ -70484,7 +73141,7 @@ paths: type: string total_count: type: integer - repository: *153 + repository: *152 commit_url: type: string format: uri @@ -70615,9 +73272,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#list-commit-statuses-for-a-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - *17 - *19 responses: @@ -70627,7 +73284,7 @@ paths: application/json: schema: type: array - items: &634 + items: &633 title: Status description: The status of a commit. type: object @@ -70708,7 +73365,7 @@ paths: site_admin: false headers: Link: *65 - '301': *329 + '301': *328 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -70736,8 +73393,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/community#get-community-profile-metrics parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -70770,11 +73427,11 @@ paths: code_of_conduct: anyOf: - type: 'null' - - *465 + - *464 code_of_conduct_file: anyOf: - type: 'null' - - &466 + - &465 title: Community Health File type: object properties: @@ -70794,19 +73451,19 @@ paths: contributing: anyOf: - type: 'null' - - *466 + - *465 readme: anyOf: - type: 'null' - - *466 + - *465 issue_template: anyOf: - type: 'null' - - *466 + - *465 pull_request_template: anyOf: - type: 'null' - - *466 + - *465 required: - code_of_conduct - code_of_conduct_file @@ -70935,8 +73592,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#compare-two-commits parameters: + - *324 - *325 - - *326 - *19 - *17 - name: basehead @@ -70984,8 +73641,8 @@ paths: format: uri examples: - https://github.com/octocat/Hello-World/compare/master...topic.patch - base_commit: *456 - merge_base_commit: *456 + base_commit: *455 + merge_base_commit: *455 status: type: string enum: @@ -71009,10 +73666,10 @@ paths: - 6 commits: type: array - items: *456 + items: *455 files: type: array - items: *467 + items: *466 required: - url - html_url @@ -71298,8 +73955,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-repository-content parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -71469,7 +74126,7 @@ paths: - type - url examples: - response-if-content-is-a-file-github-object: &468 + response-if-content-is-a-file-github-object: &467 summary: Response if content is a file value: type: file @@ -71606,7 +74263,7 @@ paths: - size - type - url - - &574 + - &573 title: Content File description: Content File type: object @@ -71824,7 +74481,7 @@ paths: - url - submodule_git_url examples: - response-if-content-is-a-file: *468 + response-if-content-is-a-file: *467 response-if-content-is-a-directory: summary: Response if content is a directory and the application/json media type is requested @@ -71893,7 +74550,7 @@ paths: html: https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9 '404': *6 '403': *27 - '302': *469 + '302': *468 '304': *35 x-github: githubCloudOnly: false @@ -71916,8 +74573,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#create-or-update-file-contents parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -72012,7 +74669,7 @@ paths: description: Response content: application/json: - schema: &470 + schema: &469 title: File Commit description: File Commit type: object @@ -72168,7 +74825,7 @@ paths: description: Response content: application/json: - schema: *470 + schema: *469 examples: example-for-creating-a-file: value: @@ -72222,7 +74879,7 @@ paths: schema: oneOf: - *3 - - &501 + - &500 description: Repository rule violation was detected type: object properties: @@ -72243,7 +74900,7 @@ paths: items: type: object properties: - placeholder_id: &626 + placeholder_id: &625 description: The ID of the push protection bypass placeholder. This value is returned on any push protected routes. @@ -72275,8 +74932,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#delete-a-file parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -72337,7 +74994,7 @@ paths: description: Response content: application/json: - schema: *470 + schema: *469 examples: default: value: @@ -72392,8 +75049,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-contributors parameters: + - *324 - *325 - - *326 - name: anon description: Set to `1` or `true` to include anonymous contributors in results. in: query @@ -72517,23 +75174,23 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *189 - *190 - *191 - *192 - - *193 - name: manifest in: query description: A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned. schema: type: string + - *193 + - *470 - *194 - - *471 - *195 - *196 - - *197 - *59 - *45 - *46 @@ -72545,11 +75202,11 @@ paths: application/json: schema: type: array - items: &475 + items: &474 type: object description: A Dependabot alert. properties: - number: *171 + number: *170 state: type: string description: The state of the Dependabot alert. @@ -72594,14 +75251,15 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: *472 + security_advisory: *471 security_vulnerability: *63 - url: *174 - html_url: *175 - created_at: *172 - updated_at: *173 - dismissed_at: *177 + url: *173 + html_url: *174 + created_at: *171 + updated_at: *172 + dismissed_at: *176 dismissed_by: anyOf: - type: 'null' @@ -72625,9 +75283,9 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *176 - auto_dismissed_at: *473 - dismissal_request: *474 + fixed_at: *175 + auto_dismissed_at: *472 + dismissal_request: *473 assignees: type: array description: The users assigned to this alert. @@ -72699,7 +75357,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -72882,9 +75540,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#get-a-dependabot-alert parameters: + - *324 - *325 - - *326 - - &476 + - &475 name: alert_number in: path description: |- @@ -72893,13 +75551,13 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *171 + schema: *170 responses: '200': description: Response content: application/json: - schema: *475 + schema: *474 examples: default: value: @@ -72956,7 +75614,7 @@ paths: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 @@ -73031,9 +75689,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#update-a-dependabot-alert parameters: + - *324 - *325 - - *326 - - *476 + - *475 requestBody: required: true content: @@ -73089,7 +75747,7 @@ paths: description: Response content: application/json: - schema: *475 + schema: *474 examples: default: value: @@ -73219,8 +75877,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -73238,7 +75896,7 @@ paths: type: integer secrets: type: array - items: &479 + items: &478 title: Dependabot Secret description: Set secrets for Dependabot. type: object @@ -73292,16 +75950,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *477 + schema: *476 examples: - default: *478 + default: *477 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -73321,15 +75979,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *479 + schema: *478 examples: default: value: @@ -73355,9 +76013,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -73385,7 +76043,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -73409,9 +76067,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -73433,8 +76091,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits parameters: + - *324 - *325 - - *326 - name: basehead description: The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their @@ -73608,8 +76266,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -73869,8 +76527,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -73953,7 +76611,7 @@ paths: - version - url additionalProperties: false - metadata: &480 + metadata: &479 title: metadata description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -73992,7 +76650,7 @@ paths: examples: - "/src/build/package-lock.json" additionalProperties: false - metadata: *480 + metadata: *479 resolved: type: object description: A collection of resolved package dependencies. @@ -74006,7 +76664,7 @@ paths: pattern: "^pkg" examples: - pkg:/npm/%40actions/http-client@1.0.11 - metadata: *480 + metadata: *479 relationship: type: string description: A notation of whether a dependency is requested @@ -74139,8 +76797,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#list-deployments parameters: + - *324 - *325 - - *326 - name: sha description: The SHA recorded at creation time. in: query @@ -74181,9 +76839,9 @@ paths: application/json: schema: type: array - items: *481 + items: *480 examples: - default: *482 + default: *481 headers: Link: *65 x-github: @@ -74249,8 +76907,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#create-a-deployment parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -74332,7 +76990,7 @@ paths: description: Response content: application/json: - schema: *481 + schema: *480 examples: simple-example: summary: Simple example @@ -74405,9 +77063,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#get-a-deployment parameters: + - *324 - *325 - - *326 - - &483 + - &482 name: deployment_id description: deployment_id parameter in: path @@ -74419,7 +77077,7 @@ paths: description: Response content: application/json: - schema: *481 + schema: *480 examples: default: value: @@ -74484,9 +77142,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#delete-a-deployment parameters: + - *324 - *325 - - *326 - - *483 + - *482 responses: '204': description: Response @@ -74508,9 +77166,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#list-deployment-statuses parameters: + - *324 - *325 - - *326 - - *483 + - *482 - *17 - *19 responses: @@ -74520,7 +77178,7 @@ paths: application/json: schema: type: array - items: &484 + items: &483 title: Deployment Status description: The status of a deployment. type: object @@ -74684,9 +77342,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#create-a-deployment-status parameters: + - *324 - *325 - - *326 - - *483 + - *482 requestBody: required: true content: @@ -74761,9 +77419,9 @@ paths: description: Response content: application/json: - schema: *484 + schema: *483 examples: - default: &485 + default: &484 value: url: https://api.github.com/repos/octocat/example/deployments/42/statuses/1 id: 1 @@ -74819,9 +77477,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#get-a-deployment-status parameters: + - *324 - *325 - - *326 - - *483 + - *482 - name: status_id in: path required: true @@ -74832,9 +77490,9 @@ paths: description: Response content: application/json: - schema: *484 + schema: *483 examples: - default: *485 + default: *484 '404': *6 x-github: githubCloudOnly: false @@ -74859,8 +77517,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#create-a-repository-dispatch-event parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -74917,8 +77575,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#list-environments parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -74936,7 +77594,7 @@ paths: - 5 environments: type: array - items: &487 + items: &486 title: Environment description: Details of a deployment environment type: object @@ -74998,7 +77656,7 @@ paths: type: string examples: - wait_timer - wait_timer: &489 + wait_timer: &488 type: integer description: The amount of time to delay a job after the job is initially triggered. The time (in minutes) @@ -75040,11 +77698,11 @@ paths: items: type: object properties: - type: *486 + type: *485 reviewer: anyOf: - *4 - - *188 + - *187 required: - id - node_id @@ -75067,7 +77725,7 @@ paths: - id - node_id - type - deployment_branch_policy: &490 + deployment_branch_policy: &489 type: - object - 'null' @@ -75184,9 +77842,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#get-an-environment parameters: + - *324 - *325 - - *326 - - &488 + - &487 name: environment_name in: path required: true @@ -75199,9 +77857,9 @@ paths: description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: &491 + default: &490 value: id: 161088068 node_id: MDExOkVudmlyb25tZW50MTYxMDg4MDY4 @@ -75285,9 +77943,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#create-or-update-an-environment parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: false content: @@ -75297,7 +77955,7 @@ paths: - object - 'null' properties: - wait_timer: *489 + wait_timer: *488 prevent_self_review: type: boolean description: Whether or not a user who created the job is prevented @@ -75316,14 +77974,14 @@ paths: items: type: object properties: - type: *486 + type: *485 id: type: integer description: The id of the user or team who can review the deployment examples: - 4532992 - deployment_branch_policy: *490 + deployment_branch_policy: *489 additionalProperties: false examples: default: @@ -75343,9 +78001,9 @@ paths: description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: *491 + default: *490 '422': description: Validation error when the environment name is invalid or when `protected_branches` and `custom_branch_policies` in `deployment_branch_policy` @@ -75369,9 +78027,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#delete-an-environment parameters: + - *324 - *325 - - *326 - - *488 + - *487 responses: '204': description: Default response @@ -75396,9 +78054,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#list-deployment-branch-policies parameters: + - *324 - *325 - - *326 - - *488 + - *487 - *17 - *19 responses: @@ -75417,7 +78075,7 @@ paths: - 2 branch_policies: type: array - items: &492 + items: &491 title: Deployment branch policy description: Details of a deployment branch or tag policy. type: object @@ -75478,9 +78136,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#create-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: true content: @@ -75528,9 +78186,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - example-wildcard: &493 + example-wildcard: &492 value: id: 364662 node_id: MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI= @@ -75572,10 +78230,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#get-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - &494 + - *487 + - &493 name: branch_policy_id in: path required: true @@ -75587,9 +78245,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - default: *493 + default: *492 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -75608,10 +78266,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#update-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - *494 + - *487 + - *493 requestBody: required: true content: @@ -75640,9 +78298,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - default: *493 + default: *492 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -75661,10 +78319,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#delete-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - *494 + - *487 + - *493 responses: '204': description: Response @@ -75689,9 +78347,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#get-all-deployment-protection-rules-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 responses: '200': description: List of deployment protection rules @@ -75708,7 +78366,7 @@ paths: - 10 custom_deployment_protection_rules: type: array - items: &495 + items: &494 title: Deployment protection rule description: Deployment protection rule type: object @@ -75730,7 +78388,7 @@ paths: for the environment. examples: - true - app: &496 + app: &495 title: Custom deployment protection rule app description: A GitHub App that is providing a custom deployment protection rule. @@ -75833,9 +78491,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#create-a-custom-deployment-protection-rule-on-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 requestBody: content: application/json: @@ -75856,9 +78514,9 @@ paths: description: The enabled custom deployment protection rule content: application/json: - schema: *495 + schema: *494 examples: - default: &497 + default: &496 value: id: 3 node_id: IEH37kRlcGxveW1lbnRTdGF0ddiv @@ -75893,9 +78551,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#list-custom-deployment-rule-integrations-available-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 - *19 - *17 responses: @@ -75915,7 +78573,7 @@ paths: - 35 available_custom_deployment_protection_rule_integrations: type: array - items: *496 + items: *495 examples: default: value: @@ -75950,10 +78608,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#get-a-custom-deployment-protection-rule parameters: + - *324 - *325 - - *326 - - *488 - - &498 + - *487 + - &497 name: protection_rule_id description: The unique identifier of the protection rule. in: path @@ -75965,9 +78623,9 @@ paths: description: Response content: application/json: - schema: *495 + schema: *494 examples: - default: *497 + default: *496 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -75988,10 +78646,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#disable-a-custom-protection-rule-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 - - *498 + - *324 + - *497 responses: '204': description: Response @@ -76017,9 +78675,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-environment-secrets parameters: + - *324 - *325 - - *326 - - *488 + - *487 - *17 - *19 responses: @@ -76037,9 +78695,9 @@ paths: type: integer secrets: type: array - items: *370 + items: *369 examples: - default: *371 + default: *370 headers: Link: *65 x-github: @@ -76064,17 +78722,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-an-environment-public-key parameters: + - *324 - *325 - - *326 - - *488 + - *487 responses: '200': description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76096,18 +78754,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 responses: '200': description: Response content: application/json: - schema: *370 + schema: *369 examples: - default: *499 + default: *498 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76129,10 +78787,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#create-or-update-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 requestBody: required: true content: @@ -76163,7 +78821,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -76189,10 +78847,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#delete-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 responses: '204': description: Default response @@ -76217,10 +78875,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-environment-variables parameters: + - *324 - *325 - - *326 - - *488 - - *341 + - *487 + - *340 - *19 responses: '200': @@ -76237,9 +78895,9 @@ paths: type: integer variables: type: array - items: *374 + items: *373 examples: - default: *375 + default: *374 headers: Link: *65 x-github: @@ -76262,9 +78920,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#create-an-environment-variable parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: true content: @@ -76291,7 +78949,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -76316,18 +78974,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#get-an-environment-variable parameters: + - *324 - *325 - - *326 - - *488 - - *164 + - *487 + - *163 responses: '200': description: Response content: application/json: - schema: *374 + schema: *373 examples: - default: *500 + default: *499 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76348,10 +79006,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#update-an-environment-variable parameters: + - *324 - *325 - - *326 - - *164 - - *488 + - *163 + - *487 requestBody: required: true content: @@ -76393,10 +79051,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#delete-an-environment-variable parameters: + - *324 - *325 - - *326 - - *164 - - *488 + - *163 + - *487 responses: '204': description: Response @@ -76418,8 +79076,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/events#list-repository-events parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -76487,8 +79145,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/forks#list-forks parameters: + - *324 - *325 - - *326 - name: sort description: The sort order. `stargazers` will sort by star count. in: query @@ -76510,7 +79168,7 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: default: value: @@ -76647,8 +79305,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/forks#create-a-fork parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -76681,9 +79339,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 '400': *14 '422': *15 '403': *27 @@ -76704,8 +79362,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/blobs#create-a-blob parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -76765,7 +79423,7 @@ paths: schema: oneOf: - *121 - - *501 + - *500 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76790,8 +79448,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/blobs#get-a-blob parameters: + - *324 - *325 - - *326 - name: file_sha in: path required: true @@ -76891,8 +79549,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/commits#create-a-commit parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77001,7 +79659,7 @@ paths: description: Response content: application/json: - schema: &502 + schema: &501 title: Git Commit description: Low-level Git commit operations within a repository type: object @@ -77228,15 +79886,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/commits#get-a-commit-object parameters: + - *324 - *325 - - *326 - - *457 + - *456 responses: '200': description: Response content: application/json: - schema: *502 + schema: *501 examples: default: value: @@ -77292,9 +79950,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#list-matching-references parameters: + - *324 - *325 - - *326 - - &503 + - &502 name: ref description: The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. @@ -77311,7 +79969,7 @@ paths: application/json: schema: type: array - items: &504 + items: &503 title: Git Reference description: Git references within a repository type: object @@ -77387,17 +80045,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#get-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 responses: '200': description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: &505 + default: &504 value: ref: refs/heads/featureA node_id: MDM6UmVmcmVmcy9oZWFkcy9mZWF0dXJlQQ== @@ -77426,8 +80084,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#create-a-reference parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77456,9 +80114,9 @@ paths: description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: *505 + default: *504 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA @@ -77484,9 +80142,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#update-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 requestBody: required: true content: @@ -77515,9 +80173,9 @@ paths: description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: *505 + default: *504 '422': *15 '409': *52 x-github: @@ -77535,9 +80193,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#delete-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 responses: '204': description: Response @@ -77592,8 +80250,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/tags#create-a-tag-object parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77660,7 +80318,7 @@ paths: description: Response content: application/json: - schema: &507 + schema: &506 title: Git Tag description: Metadata for a Git tag type: object @@ -77716,7 +80374,7 @@ paths: - sha - type - url - verification: *506 + verification: *505 required: - sha - url @@ -77726,7 +80384,7 @@ paths: - tag - message examples: - default: &508 + default: &507 value: node_id: MDM6VGFnOTQwYmQzMzYyNDhlZmFlMGY5ZWU1YmM3YjJkNWM5ODU4ODdiMTZhYw== tag: v0.0.1 @@ -77799,8 +80457,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/tags#get-a-tag parameters: + - *324 - *325 - - *326 - name: tag_sha in: path required: true @@ -77811,9 +80469,9 @@ paths: description: Response content: application/json: - schema: *507 + schema: *506 examples: - default: *508 + default: *507 '404': *6 '409': *52 x-github: @@ -77837,8 +80495,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/trees#create-a-tree parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77912,7 +80570,7 @@ paths: description: Response content: application/json: - schema: &509 + schema: &508 title: Git Tree description: The hierarchy between files in a Git repository. type: object @@ -78014,8 +80672,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/trees#get-a-tree parameters: + - *324 - *325 - - *326 - name: tree_sha description: The SHA1 value or ref (branch or tag) name of the tree. in: path @@ -78038,7 +80696,7 @@ paths: description: Response content: application/json: - schema: *509 + schema: *508 examples: default-response: summary: Default response @@ -78097,8 +80755,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#list-repository-webhooks parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -78108,7 +80766,7 @@ paths: application/json: schema: type: array - items: &510 + items: &509 title: Webhook description: Webhooks for repositories. type: object @@ -78171,7 +80829,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/hooks/1/deliveries - last_response: &742 + last_response: &741 title: Hook Response type: object properties: @@ -78248,8 +80906,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#create-a-repository-webhook parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -78302,9 +80960,9 @@ paths: description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: &511 + default: &510 value: type: Repository id: 12345678 @@ -78352,17 +81010,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '200': description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: *511 + default: *510 '404': *6 x-github: githubCloudOnly: false @@ -78382,9 +81040,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#update-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 requestBody: required: true content: @@ -78429,9 +81087,9 @@ paths: description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: *511 + default: *510 '422': *15 '404': *6 x-github: @@ -78452,9 +81110,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#delete-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -78478,9 +81136,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-webhook-configuration-for-a-repository parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '200': description: Response @@ -78507,9 +81165,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#update-a-webhook-configuration-for-a-repository parameters: + - *324 - *325 - - *326 - - *203 + - *202 requestBody: required: false content: @@ -78553,12 +81211,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#list-deliveries-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *17 + - *203 - *204 - - *205 responses: '200': description: Response @@ -78566,9 +81224,9 @@ paths: application/json: schema: type: array - items: *206 + items: *205 examples: - default: *207 + default: *206 '400': *14 '422': *15 x-github: @@ -78587,18 +81245,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-delivery-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *16 responses: '200': description: Response content: application/json: - schema: *208 + schema: *207 examples: - default: *209 + default: *208 '400': *14 '422': *15 x-github: @@ -78617,9 +81275,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#redeliver-a-delivery-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *16 responses: '202': *37 @@ -78642,9 +81300,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#ping-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -78669,9 +81327,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#test-the-push-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -78694,8 +81352,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-immutable-releases-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response if immutable releases are enabled @@ -78743,10 +81401,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-immutable-releases parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '409': *52 x-github: githubCloudOnly: false @@ -78764,10 +81422,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-immutable-releases parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '409': *52 x-github: githubCloudOnly: false @@ -78822,14 +81480,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-an-import-status parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &512 + schema: &511 title: Import description: A repository import from an external source. type: object @@ -78936,7 +81594,7 @@ paths: - html_url - authors_url examples: - default: &515 + default: &514 value: vcs: subversion use_lfs: true @@ -78952,7 +81610,7 @@ paths: authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm '404': *6 - '503': &513 + '503': &512 description: Unavailable due to service under maintenance. content: application/json: @@ -78981,8 +81639,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#start-an-import parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -79030,7 +81688,7 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: default: value: @@ -79055,7 +81713,7 @@ paths: type: string '422': *15 '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79083,8 +81741,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#update-an-import parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -79136,7 +81794,7 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: example-1: summary: Example 1 @@ -79184,7 +81842,7 @@ paths: html_url: https://import.github.com/octocat/socm/import authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79207,12 +81865,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#cancel-an-import parameters: + - *324 - *325 - - *326 responses: '204': description: Response - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79238,9 +81896,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-commit-authors parameters: + - *324 - *325 - - *326 - - &676 + - &675 name: since description: A user ID. Only return users with an ID greater than this ID. in: query @@ -79254,7 +81912,7 @@ paths: application/json: schema: type: array - items: &514 + items: &513 title: Porter Author description: Porter Author type: object @@ -79308,7 +81966,7 @@ paths: url: https://api.github.com/repos/octocat/socm/import/authors/2268559 import_url: https://api.github.com/repos/octocat/socm/import '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79333,8 +81991,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#map-a-commit-author parameters: + - *324 - *325 - - *326 - name: author_id in: path required: true @@ -79364,7 +82022,7 @@ paths: description: Response content: application/json: - schema: *514 + schema: *513 examples: default: value: @@ -79377,7 +82035,7 @@ paths: import_url: https://api.github.com/repos/octocat/socm/import '422': *15 '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79401,8 +82059,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-large-files parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -79443,7 +82101,7 @@ paths: path: foo/bar/3 oid: c20ad4d76fe97759aa27a0c99bff6710 size: 12582912 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79471,8 +82129,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#update-git-lfs-preference parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -79499,11 +82157,11 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: - default: *515 + default: *514 '422': *15 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -79526,8 +82184,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/apps/apps#get-a-repository-installation-for-the-authenticated-app parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -79535,8 +82193,8 @@ paths: application/json: schema: *20 examples: - default: *516 - '301': *329 + default: *515 + '301': *328 '404': *6 x-github: githubCloudOnly: false @@ -79556,8 +82214,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#get-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -79565,12 +82223,12 @@ paths: application/json: schema: anyOf: - - *222 + - *221 - type: object properties: {} additionalProperties: false examples: - default: &518 + default: &517 value: limit: collaborators_only origin: repository @@ -79595,13 +82253,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#set-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *517 + schema: *516 examples: default: summary: Example request body @@ -79613,9 +82271,9 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: - default: *518 + default: *517 '409': description: Response x-github: @@ -79637,8 +82295,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#remove-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -79661,8 +82319,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#list-repository-invitations parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -79672,9 +82330,9 @@ paths: application/json: schema: type: array - items: *519 + items: *518 examples: - default: &668 + default: &667 value: - id: 1 repository: @@ -79805,9 +82463,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#update-a-repository-invitation parameters: + - *324 - *325 - - *326 - - *226 + - *225 requestBody: required: false content: @@ -79836,7 +82494,7 @@ paths: description: Response content: application/json: - schema: *519 + schema: *518 examples: default: value: @@ -79967,9 +82625,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#delete-a-repository-invitation parameters: + - *324 - *325 - - *326 - - *226 + - *225 responses: '204': description: Response @@ -80000,8 +82658,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#list-repository-issues parameters: + - *324 - *325 - - *326 - name: milestone description: If an `integer` is passed, it should refer to a milestone by its `number` field. If the string `*` is passed, issues with any milestone @@ -80049,7 +82707,7 @@ paths: required: false schema: type: string - - *233 + - *232 - name: sort description: What to sort results by. in: query @@ -80074,7 +82732,7 @@ paths: type: array items: *81 examples: - default: &528 + default: &527 value: - id: 1 node_id: MDU6SXNzdWUx @@ -80223,7 +82881,7 @@ paths: state_reason: completed headers: Link: *65 - '301': *329 + '301': *328 '422': *15 '404': *6 x-github: @@ -80252,8 +82910,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#create-an-issue parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -80337,7 +82995,7 @@ paths: application/json: schema: *81 examples: - default: &525 + default: &524 value: id: 1 node_id: MDU6SXNzdWUx @@ -80494,7 +83152,7 @@ paths: '422': *15 '503': *113 '404': *6 - '410': *520 + '410': *519 x-github: triggersNotification: true githubCloudOnly: false @@ -80522,8 +83180,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#list-issue-comments-for-a-repository parameters: + - *324 - *325 - - *326 - *103 - name: direction description: Either `asc` or `desc`. Ignored without the `sort` parameter. @@ -80546,7 +83204,7 @@ paths: type: array items: *82 examples: - default: &527 + default: &526 value: - id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -80604,8 +83262,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#get-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': @@ -80614,7 +83272,7 @@ paths: application/json: schema: *82 examples: - default: &521 + default: &520 value: id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -80669,8 +83327,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#update-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -80695,7 +83353,7 @@ paths: application/json: schema: *82 examples: - default: *521 + default: *520 '422': *15 x-github: githubCloudOnly: false @@ -80713,8 +83371,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#delete-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -80743,8 +83401,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#pin-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': @@ -80807,7 +83465,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -80824,8 +83482,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#unpin-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -80833,7 +83491,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 '503': *113 x-github: githubCloudOnly: false @@ -80851,8 +83509,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -80879,9 +83537,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -80902,8 +83560,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -80936,16 +83594,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -80967,10 +83625,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-an-issue-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - *523 + - *522 responses: '204': description: Response @@ -80990,8 +83648,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#list-issue-events-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -81001,7 +83659,7 @@ paths: application/json: schema: type: array - items: &524 + items: &523 title: Issue Event description: Issue Event type: object @@ -81081,7 +83739,7 @@ paths: anyOf: - type: 'null' - *4 - requested_team: *188 + requested_team: *187 dismissed_review: title: Issue Event Dismissed Review type: object @@ -81341,8 +83999,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#get-an-issue-event parameters: + - *324 - *325 - - *326 - name: event_id in: path required: true @@ -81353,7 +84011,7 @@ paths: description: Response content: application/json: - schema: *524 + schema: *523 examples: default: value: @@ -81546,7 +84204,7 @@ paths: author_association: COLLABORATOR state_reason: completed '404': *6 - '410': *520 + '410': *519 '403': *27 x-github: githubCloudOnly: false @@ -81580,9 +84238,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#get-an-issue parameters: + - *324 - *325 - - *326 - - &526 + - &525 name: issue_number description: The number that identifies the issue. in: path @@ -81598,7 +84256,7 @@ paths: examples: default: summary: Issue - value: *525 + value: *524 pinned_comment: summary: Issue with pinned comment value: @@ -81797,9 +84455,9 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 '304': *35 x-github: githubCloudOnly: false @@ -81824,9 +84482,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#update-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -81961,13 +84619,13 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 '422': *15 '503': *113 '403': *27 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81985,9 +84643,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#add-assignees-to-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -82015,7 +84673,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82031,9 +84689,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#remove-assignees-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: content: application/json: @@ -82060,7 +84718,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82082,9 +84740,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#check-if-a-user-can-be-assigned-to-a-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: assignee in: path required: true @@ -82124,9 +84782,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#list-issue-comments parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *86 - *17 - *19 @@ -82139,11 +84797,11 @@ paths: type: array items: *82 examples: - default: *527 + default: *526 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82172,9 +84830,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#create-an-issue-comment parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -82198,14 +84856,14 @@ paths: application/json: schema: *82 examples: - default: *521 + default: *520 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/comments/1 schema: type: string '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -82233,9 +84891,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -82247,12 +84905,12 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82280,9 +84938,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#add-a-dependency-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -82306,15 +84964,15 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/dependencies/blocked_by schema: type: string - '301': *329 + '301': *328 '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -82345,9 +85003,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#remove-dependency-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: issue_id in: path description: The id of the blocking issue to remove as a dependency @@ -82361,13 +85019,13 @@ paths: application/json: schema: *81 examples: - default: *525 - '301': *329 + default: *524 + '301': *328 '400': *14 '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 x-github: triggersNotification: true githubCloudOnly: false @@ -82393,9 +85051,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocking parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -82407,12 +85065,12 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -82429,9 +85087,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#list-issue-events parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -82445,7 +85103,7 @@ paths: title: Issue Event for Issue description: Issue Event for Issue anyOf: - - &531 + - &530 title: Labeled Issue Event description: Labeled Issue Event type: object @@ -82494,7 +85152,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &532 + - &531 title: Unlabeled Issue Event description: Unlabeled Issue Event type: object @@ -82622,7 +85280,7 @@ paths: - performed_via_github_app - assignee - assigner - - &533 + - &532 title: Milestoned Issue Event description: Milestoned Issue Event type: object @@ -82668,7 +85326,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &534 + - &533 title: Demilestoned Issue Event description: Demilestoned Issue Event type: object @@ -82714,7 +85372,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &535 + - &534 title: Renamed Issue Event description: Renamed Issue Event type: object @@ -82763,7 +85421,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &536 + - &535 title: Review Requested Issue Event description: Review Requested Issue Event type: object @@ -82792,7 +85450,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *188 + requested_team: *187 requested_reviewer: *4 required: - review_requester @@ -82805,7 +85463,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &537 + - &536 title: Review Request Removed Issue Event description: Review Request Removed Issue Event type: object @@ -82834,7 +85492,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *188 + requested_team: *187 requested_reviewer: *4 required: - review_requester @@ -82847,7 +85505,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &538 + - &537 title: Review Dismissed Issue Event description: Review Dismissed Issue Event type: object @@ -82903,7 +85561,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &539 + - &538 title: Locked Issue Event description: Locked Issue Event type: object @@ -82948,7 +85606,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &540 + - &539 title: Added to Project Issue Event description: Added to Project Issue Event type: object @@ -83009,7 +85667,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &541 + - &540 title: Moved Column in Project Issue Event description: Moved Column in Project Issue Event type: object @@ -83070,7 +85728,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &542 + - &541 title: Removed from Project Issue Event description: Removed from Project Issue Event type: object @@ -83131,7 +85789,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &543 + - &542 title: Converted Note to Issue Issue Event description: Converted Note to Issue Issue Event type: object @@ -83224,7 +85882,7 @@ paths: color: red headers: Link: *65 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83241,9 +85899,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#list-issue-field-values-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83253,9 +85911,9 @@ paths: application/json: schema: type: array - items: *529 + items: *528 examples: - default: &640 + default: &639 value: - issue_field_id: 1 node_id: IFT_GDKND @@ -83279,9 +85937,9 @@ paths: value: '2025-12-25' headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83298,9 +85956,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83312,7 +85970,7 @@ paths: type: array items: *80 examples: - default: &530 + default: &529 value: - id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -83330,9 +85988,9 @@ paths: default: false headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83348,9 +86006,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#add-labels-to-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83395,10 +86053,10 @@ paths: type: array items: *80 examples: - default: *530 - '301': *329 + default: *529 + '301': *328 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -83415,9 +86073,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#set-labels-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83479,10 +86137,10 @@ paths: type: array items: *80 examples: - default: *530 - '301': *329 + default: *529 + '301': *328 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -83499,15 +86157,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#remove-all-labels-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '204': description: Response - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83526,9 +86184,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#remove-a-label-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: name in: path required: true @@ -83552,9 +86210,9 @@ paths: description: Something isn't working color: f29513 default: true - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83574,9 +86232,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#lock-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83605,7 +86263,7 @@ paths: '204': description: Response '403': *27 - '410': *520 + '410': *519 '404': *6 '422': *15 x-github: @@ -83623,9 +86281,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#unlock-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '204': description: Response @@ -83655,9 +86313,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#get-parent-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '200': description: Response @@ -83665,10 +86323,10 @@ paths: application/json: schema: *81 examples: - default: *525 - '301': *329 + default: *524 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83685,9 +86343,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue. @@ -83713,13 +86371,13 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83737,9 +86395,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -83771,16 +86429,16 @@ paths: description: Response content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Response content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -83802,10 +86460,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-an-issue-reaction parameters: + - *324 - *325 - - *326 - - *526 - - *523 + - *525 + - *522 responses: '204': description: Response @@ -83834,9 +86492,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#remove-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -83860,7 +86518,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/sub-issue @@ -83893,9 +86551,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#list-sub-issues parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83907,11 +86565,11 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83939,9 +86597,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#add-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -83970,14 +86628,14 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/sub-issues/1 schema: type: string '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -83997,9 +86655,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#reprioritize-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84032,7 +86690,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 '403': *27 '404': *6 '422': *7 @@ -84054,9 +86712,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/timeline#list-timeline-events-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -84071,6 +86729,7 @@ paths: description: Timeline Event type: object anyOf: + - *530 - *531 - *532 - *533 @@ -84083,7 +86742,6 @@ paths: - *540 - *541 - *542 - - *543 - title: Timeline Comment Event description: Timeline Comment Event type: object @@ -84140,7 +86798,7 @@ paths: pin: anyOf: - type: 'null' - - *544 + - *543 required: - event - actor @@ -84416,7 +87074,7 @@ paths: type: string comments: type: array - items: &563 + items: &562 title: Pull Request Review Comment description: Pull Request Review Comments are comments on a portion of the Pull Request's diff. @@ -84657,7 +87315,7 @@ paths: type: string comments: type: array - items: *453 + items: *452 - title: Timeline Assigned Issue Event description: Timeline Assigned Issue Event type: object @@ -84932,7 +87590,7 @@ paths: headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84949,8 +87607,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#list-deploy-keys parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -84960,7 +87618,7 @@ paths: application/json: schema: type: array - items: &545 + items: &544 title: Deploy Key description: An SSH key granting access to a single repository. type: object @@ -85028,8 +87686,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#create-a-deploy-key parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85065,9 +87723,9 @@ paths: description: Response content: application/json: - schema: *545 + schema: *544 examples: - default: &546 + default: &545 value: id: 1 key: ssh-rsa AAA... @@ -85101,9 +87759,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#get-a-deploy-key parameters: + - *324 - *325 - - *326 - - &547 + - &546 name: key_id description: The unique identifier of the key. in: path @@ -85115,9 +87773,9 @@ paths: description: Response content: application/json: - schema: *545 + schema: *544 examples: - default: *546 + default: *545 '404': *6 x-github: githubCloudOnly: false @@ -85135,9 +87793,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#delete-a-deploy-key parameters: + - *324 - *325 - - *326 - - *547 + - *546 responses: '204': description: Response @@ -85157,8 +87815,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -85170,7 +87828,7 @@ paths: type: array items: *80 examples: - default: *530 + default: *529 headers: Link: *65 '404': *6 @@ -85191,8 +87849,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#create-a-label parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85230,7 +87888,7 @@ paths: application/json: schema: *80 examples: - default: &548 + default: &547 value: id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -85262,8 +87920,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#get-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -85276,7 +87934,7 @@ paths: application/json: schema: *80 examples: - default: *548 + default: *547 '404': *6 x-github: githubCloudOnly: false @@ -85293,8 +87951,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#update-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -85359,8 +88017,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#delete-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -85386,8 +88044,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-languages parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -85426,9 +88084,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/licenses/licenses#get-the-license-for-a-repository parameters: + - *324 - *325 - - *326 - - *428 + - *427 responses: '200': description: Response @@ -85575,8 +88233,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85641,8 +88299,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#merge-a-branch parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85676,9 +88334,9 @@ paths: description: Successful Response (The resulting merge commit) content: application/json: - schema: *456 + schema: *455 examples: - default: *549 + default: *548 '204': description: Response when already merged '404': @@ -85703,8 +88361,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#list-milestones parameters: + - *324 - *325 - - *326 - name: state description: The state of the milestone. Either `open`, `closed`, or `all`. in: query @@ -85745,7 +88403,7 @@ paths: application/json: schema: type: array - items: *266 + items: *265 examples: default: value: @@ -85801,8 +88459,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#create-a-milestone parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -85842,9 +88500,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: &550 + default: &549 value: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -85903,9 +88561,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#get-a-milestone parameters: + - *324 - *325 - - *326 - - &551 + - &550 name: milestone_number description: The number that identifies the milestone. in: path @@ -85917,9 +88575,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: *550 + default: *549 '404': *6 x-github: githubCloudOnly: false @@ -85936,9 +88594,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#update-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 requestBody: required: false content: @@ -85976,9 +88634,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: *550 + default: *549 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85994,9 +88652,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#delete-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 responses: '204': description: Response @@ -86017,9 +88675,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-issues-in-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 - *17 - *19 responses: @@ -86031,7 +88689,7 @@ paths: type: array items: *80 examples: - default: *530 + default: *529 headers: Link: *65 x-github: @@ -86050,12 +88708,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#list-repository-notifications-for-the-authenticated-user parameters: + - *324 - *325 - - *326 + - *551 - *552 - - *553 - *86 - - *554 + - *553 - *17 - *19 responses: @@ -86067,7 +88725,7 @@ paths: type: array items: *106 examples: - default: *555 + default: *554 headers: Link: *65 x-github: @@ -86091,8 +88749,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#mark-repository-notifications-as-read parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -86150,14 +88808,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-a-apiname-pages-site parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &556 + schema: &555 title: GitHub Pages description: The configuration for GitHub Pages for a repository. type: object @@ -86301,7 +88959,7 @@ paths: - custom_404 - public examples: - default: &557 + default: &556 value: url: https://api.github.com/repos/github/developer.github.com/pages status: built @@ -86342,8 +89000,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#create-a-apiname-pages-site parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86398,9 +89056,9 @@ paths: description: Response content: application/json: - schema: *556 + schema: *555 examples: - default: *557 + default: *556 '422': *15 '409': *52 x-github: @@ -86423,8 +89081,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#update-information-about-a-apiname-pages-site parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86524,8 +89182,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#delete-a-apiname-pages-site parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -86551,8 +89209,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#list-apiname-pages-builds parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -86562,7 +89220,7 @@ paths: application/json: schema: type: array - items: &558 + items: &557 title: Page Build description: Page Build type: object @@ -86654,8 +89312,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#request-a-apiname-pages-build parameters: + - *324 - *325 - - *326 responses: '201': description: Response @@ -86702,16 +89360,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-latest-pages-build parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *558 + schema: *557 examples: - default: &559 + default: &558 value: url: https://api.github.com/repos/github/developer.github.com/pages/builds/5472601 status: built @@ -86759,8 +89417,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-apiname-pages-build parameters: + - *324 - *325 - - *326 - name: build_id in: path required: true @@ -86771,9 +89429,9 @@ paths: description: Response content: application/json: - schema: *558 + schema: *557 examples: - default: *559 + default: *558 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -86793,8 +89451,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#create-a-github-pages-deployment parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86902,9 +89560,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-the-status-of-a-github-pages-deployment parameters: + - *324 - *325 - - *326 - - &560 + - &559 name: pages_deployment_id description: The ID of the Pages deployment. You can also give the commit SHA of the deployment. @@ -86962,11 +89620,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#cancel-a-github-pages-deployment parameters: + - *324 - *325 - - *326 - - *560 + - *559 responses: - '204': *184 + '204': *183 '404': *6 x-github: githubCloudOnly: false @@ -86991,8 +89649,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-a-dns-health-check-for-github-pages parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -87260,7 +89918,7 @@ paths: description: Empty response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -87287,8 +89945,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-private-vulnerability-reporting-is-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Private vulnerability reporting status @@ -87325,10 +89983,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-private-vulnerability-reporting-for-a-repository parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '422': *14 x-github: githubCloudOnly: false @@ -87347,10 +90005,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-private-vulnerability-reporting-for-a-repository parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '422': *14 x-github: githubCloudOnly: false @@ -87370,8 +90028,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/custom-properties#get-all-custom-property-values-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -87379,7 +90037,7 @@ paths: application/json: schema: type: array - items: *280 + items: *279 examples: default: value: @@ -87410,8 +90068,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/custom-properties#create-or-update-custom-property-values-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -87423,7 +90081,7 @@ paths: type: array description: A list of custom property names and associated values to apply to the repositories. - items: *280 + items: *279 required: - properties examples: @@ -87473,8 +90131,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-pull-requests parameters: + - *324 - *325 - - *326 - name: state description: Either `open`, `closed`, or `all` to filter by state. in: query @@ -87534,9 +90192,9 @@ paths: application/json: schema: type: array - items: *460 + items: *459 examples: - default: *561 + default: *560 headers: Link: *65 '304': *35 @@ -87568,8 +90226,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#create-a-pull-request parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -87636,7 +90294,7 @@ paths: description: Response content: application/json: - schema: &565 + schema: &564 type: object title: Pull Request description: Pull requests let you tell others about changes you've @@ -87765,7 +90423,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 active_lock_reason: type: - string @@ -87804,7 +90462,7 @@ paths: items: *4 requested_teams: type: array - items: *245 + items: *244 head: type: object properties: @@ -87842,14 +90500,14 @@ paths: _links: type: object properties: - comments: *267 - commits: *267 - statuses: *267 - html: *267 - issue: *267 - review_comments: *267 - review_comment: *267 - self: *267 + comments: *266 + commits: *266 + statuses: *266 + html: *266 + issue: *266 + review_comments: *266 + review_comment: *266 + self: *266 required: - comments - commits @@ -87860,7 +90518,7 @@ paths: - review_comment - self author_association: *78 - auto_merge: *562 + auto_merge: *561 draft: description: Indicates whether or not the pull request is a draft. type: boolean @@ -87960,7 +90618,7 @@ paths: - merged_by - review_comments examples: - default: &566 + default: &565 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -88487,8 +91145,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository parameters: + - *324 - *325 - - *326 - name: sort in: query required: false @@ -88517,9 +91175,9 @@ paths: application/json: schema: type: array - items: *563 + items: *562 examples: - default: &568 + default: &567 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -88596,17 +91254,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 responses: '200': description: Response content: application/json: - schema: *563 + schema: *562 examples: - default: &564 + default: &563 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -88681,8 +91339,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -88705,9 +91363,9 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: - default: *564 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -88723,8 +91381,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -88746,8 +91404,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-pull-request-review-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -88774,9 +91432,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -88797,8 +91455,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-pull-request-review-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -88831,16 +91489,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -88862,10 +91520,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-pull-request-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - *523 + - *522 responses: '204': description: Response @@ -88908,9 +91566,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#get-a-pull-request parameters: + - *324 - *325 - - *326 - - &567 + - &566 name: pull_number description: The number that identifies the pull request. in: path @@ -88923,9 +91581,9 @@ paths: to fetch diff and patch formats. content: application/json: - schema: *565 + schema: *564 examples: - default: *566 + default: *565 '304': *35 '404': *6 '406': @@ -88960,9 +91618,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#update-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -89004,9 +91662,9 @@ paths: description: Response content: application/json: - schema: *565 + schema: *564 examples: - default: *566 + default: *565 '422': *15 '403': *27 x-github: @@ -89028,9 +91686,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-codespace-from-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -89091,17 +91749,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -89131,9 +91789,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *103 - name: direction description: The direction to sort results. Ignored without `sort` parameter. @@ -89154,9 +91812,9 @@ paths: application/json: schema: type: array - items: *563 + items: *562 examples: - default: *568 + default: *567 headers: Link: *65 x-github: @@ -89189,9 +91847,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -89297,7 +91955,7 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: example-for-a-multi-line-comment: value: @@ -89385,9 +92043,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *95 requestBody: required: true @@ -89410,7 +92068,7 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: default: value: @@ -89496,9 +92154,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -89508,9 +92166,9 @@ paths: application/json: schema: type: array - items: *456 + items: *455 examples: - default: *569 + default: *568 headers: Link: *65 x-github: @@ -89540,9 +92198,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -89552,7 +92210,7 @@ paths: application/json: schema: type: array - items: *467 + items: *466 examples: default: value: @@ -89590,9 +92248,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged parameters: + - *324 - *325 - - *326 - - *567 + - *566 responses: '204': description: Response if pull request has been merged @@ -89615,9 +92273,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -89729,9 +92387,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 responses: '200': description: Response @@ -89747,7 +92405,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 required: - users - teams @@ -89806,9 +92464,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -89845,7 +92503,7 @@ paths: description: Response content: application/json: - schema: *460 + schema: *459 examples: default: value: @@ -90381,9 +93039,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -90417,7 +93075,7 @@ paths: description: Response content: application/json: - schema: *460 + schema: *459 examples: default: value: @@ -90922,9 +93580,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -90934,7 +93592,7 @@ paths: application/json: schema: type: array - items: &570 + items: &569 title: Pull Request Review description: Pull Request Reviews are reviews on pull requests. type: object @@ -91090,9 +93748,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -91182,9 +93840,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: &572 + default: &571 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -91247,10 +93905,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - &571 + - *566 + - &570 name: review_id description: The unique identifier of the review. in: path @@ -91262,9 +93920,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: &573 + default: &572 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -91323,10 +93981,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -91349,7 +94007,7 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: default: value: @@ -91411,18 +94069,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 responses: '200': description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: *572 + default: *571 '422': *7 '404': *6 x-github: @@ -91449,10 +94107,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 - *17 - *19 responses: @@ -91550,9 +94208,9 @@ paths: _links: type: object properties: - self: *267 - html: *267 - pull_request: *267 + self: *266 + html: *266 + pull_request: *266 required: - self - html @@ -91710,10 +94368,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -91742,7 +94400,7 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: default: value: @@ -91805,10 +94463,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -91843,9 +94501,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: *573 + default: *572 '404': *6 '422': *7 '403': *27 @@ -91867,9 +94525,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -91933,8 +94591,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-a-repository-readme parameters: + - *324 - *325 - - *326 - name: ref description: 'The name of the commit/branch/tag. Default: the repository’s default branch.' @@ -91947,9 +94605,9 @@ paths: description: Response content: application/json: - schema: *574 + schema: *573 examples: - default: &575 + default: &574 value: type: file encoding: base64 @@ -91991,8 +94649,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-a-repository-readme-for-a-directory parameters: + - *324 - *325 - - *326 - name: dir description: The alternate path to look for a README file in: path @@ -92012,9 +94670,9 @@ paths: description: Response content: application/json: - schema: *574 + schema: *573 examples: - default: *575 + default: *574 '404': *6 '422': *15 x-github: @@ -92036,8 +94694,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#list-releases parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -92047,7 +94705,7 @@ paths: application/json: schema: type: array - items: *576 + items: *575 examples: default: value: @@ -92141,8 +94799,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#create-a-release parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -92218,9 +94876,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: &580 + default: &579 value: url: https://api.github.com/repos/octocat/Hello-World/releases/1 html_url: https://github.com/octocat/Hello-World/releases/v1.0.0 @@ -92325,9 +94983,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#get-a-release-asset parameters: + - *324 - *325 - - *326 - - &578 + - &577 name: asset_id description: The unique identifier of the asset. in: path @@ -92339,9 +94997,9 @@ paths: description: Response content: application/json: - schema: *577 + schema: *576 examples: - default: &579 + default: &578 value: url: https://api.github.com/repos/octocat/Hello-World/releases/assets/1 browser_download_url: https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip @@ -92376,7 +95034,7 @@ paths: type: User site_admin: false '404': *6 - '302': *469 + '302': *468 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -92392,9 +95050,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#update-a-release-asset parameters: + - *324 - *325 - - *326 - - *578 + - *577 requestBody: required: false content: @@ -92423,9 +95081,9 @@ paths: description: Response content: application/json: - schema: *577 + schema: *576 examples: - default: *579 + default: *578 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -92441,9 +95099,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#delete-a-release-asset parameters: + - *324 - *325 - - *326 - - *578 + - *577 responses: '204': description: Response @@ -92468,8 +95126,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#generate-release-notes-content-for-a-release parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -92555,16 +95213,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-the-latest-release parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': *6 x-github: githubCloudOnly: false @@ -92582,8 +95240,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-a-release-by-tag-name parameters: + - *324 - *325 - - *326 - name: tag description: tag parameter in: path @@ -92596,9 +95254,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': *6 x-github: githubCloudOnly: false @@ -92620,9 +95278,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-a-release parameters: + - *324 - *325 - - *326 - - &581 + - &580 name: release_id description: The unique identifier of the release. in: path @@ -92636,9 +95294,9 @@ paths: For more information, see "[Getting started with the REST API](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia)."' content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '401': description: Unauthorized x-github: @@ -92656,9 +95314,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#update-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 requestBody: required: false content: @@ -92722,9 +95380,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': description: Not Found if the discussion category name is invalid content: @@ -92745,9 +95403,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#delete-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 responses: '204': description: Response @@ -92768,9 +95426,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#list-release-assets parameters: + - *324 - *325 - - *326 - - *581 + - *580 - *17 - *19 responses: @@ -92780,7 +95438,7 @@ paths: application/json: schema: type: array - items: *577 + items: *576 examples: default: value: @@ -92861,9 +95519,9 @@ paths: description: The URL origin (protocol + host name + port) is included in `upload_url` returned in the response of the "Create a release" endpoint parameters: + - *324 - *325 - - *326 - - *581 + - *580 - name: name in: query required: true @@ -92889,7 +95547,7 @@ paths: description: Response for successful upload content: application/json: - schema: *577 + schema: *576 examples: response-for-successful-upload: value: @@ -92944,9 +95602,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a release. @@ -92970,9 +95628,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -92993,9 +95651,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 requestBody: required: true content: @@ -93025,16 +95683,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -93056,10 +95714,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-release-reaction parameters: + - *324 - *325 - - *326 - - *581 - - *523 + - *580 + - *522 responses: '204': description: Response @@ -93083,9 +95741,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-rules-for-a-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 - *17 - *19 responses: @@ -93101,8 +95759,8 @@ paths: description: A repository rule with ruleset details. oneOf: - allOf: - - *287 - - &582 + - *286 + - &581 title: repository ruleset data for rule description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -93121,69 +95779,69 @@ paths: ruleset_id: type: integer description: The ID of the ruleset that includes this rule. + - allOf: + - *287 + - *581 - allOf: - *288 - - *582 + - *581 - allOf: - *289 - - *582 + - *581 - allOf: - - *290 - *582 + - *581 - allOf: - - *583 - - *582 + - *290 + - *581 - allOf: - *291 - - *582 + - *581 - allOf: - *292 - - *582 + - *581 - allOf: - *293 - - *582 + - *581 - allOf: - *294 - - *582 + - *581 - allOf: - *295 - - *582 + - *581 - allOf: - *296 - - *582 + - *581 - allOf: - *297 - - *582 + - *581 - allOf: - *298 - - *582 + - *581 - allOf: - *299 - - *582 + - *581 - allOf: - *300 - - *582 + - *581 - allOf: - *301 - - *582 + - *581 - allOf: - *302 - - *582 + - *581 - allOf: - *303 - - *582 + - *581 - allOf: - *304 - - *582 + - *581 - allOf: - *305 - - *582 + - *581 - allOf: - *306 - - *582 - - allOf: - - *307 - - *582 + - *581 examples: default: value: @@ -93222,8 +95880,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - *17 - *19 - name: includes_parents @@ -93234,7 +95892,7 @@ paths: schema: type: boolean default: true - - *584 + - *583 responses: '200': description: Response @@ -93242,7 +95900,7 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: default: value: @@ -93289,8 +95947,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 requestBody: description: Request body required: true @@ -93310,16 +95968,16 @@ paths: - tag - push default: branch - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *282 + items: *284 + conditions: *281 rules: type: array description: An array of rules within the ruleset. - items: *585 + items: *584 required: - name - enforcement @@ -93350,9 +96008,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: &595 + default: &594 value: id: 42 name: super cool ruleset @@ -93400,12 +96058,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rule-suites#list-repository-rule-suites parameters: + - *324 - *325 - - *326 + - *585 - *586 - *587 - *588 - - *589 - *17 - *19 responses: @@ -93413,9 +96071,9 @@ paths: description: Response content: application/json: - schema: *590 + schema: *589 examples: - default: *591 + default: *590 '404': *6 '500': *53 x-github: @@ -93436,17 +96094,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rule-suites#get-a-repository-rule-suite parameters: + - *324 - *325 - - *326 - - *592 + - *591 responses: '200': description: Response content: application/json: - schema: *593 + schema: *592 examples: - default: *594 + default: *593 '404': *6 '500': *53 x-github: @@ -93474,8 +96132,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -93495,9 +96153,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *595 + default: *594 '404': *6 '500': *53 put: @@ -93515,8 +96173,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -93541,16 +96199,16 @@ paths: - branch - tag - push - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *282 + items: *284 + conditions: *281 rules: description: An array of rules within the ruleset. type: array - items: *585 + items: *584 examples: default: value: @@ -93578,9 +96236,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *595 + default: *594 '404': *6 '422': *15 '500': *53 @@ -93599,8 +96257,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -93623,8 +96281,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-repository-ruleset-history parameters: + - *324 - *325 - - *326 - *17 - *19 - name: ruleset_id @@ -93640,9 +96298,9 @@ paths: application/json: schema: type: array - items: *311 + items: *310 examples: - default: *596 + default: *595 '404': *6 '500': *53 x-github: @@ -93661,8 +96319,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-repository-ruleset-version parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -93680,7 +96338,7 @@ paths: description: Response content: application/json: - schema: *597 + schema: *596 examples: default: value: @@ -93735,22 +96393,22 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *597 - *598 - *599 - *600 - *601 - - *602 - *59 - *19 - *17 + - *602 - *603 - *604 - *605 - *606 - *607 - - *608 responses: '200': description: Response @@ -93758,24 +96416,24 @@ paths: application/json: schema: type: array - items: &612 + items: &611 type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: *609 - resolution: *610 + state: *608 + resolution: *609 resolved_at: type: - string @@ -93869,7 +96527,7 @@ paths: first_location_detected: anyOf: - type: 'null' - - *611 + - *610 has_more_locations: type: boolean description: A boolean value representing whether or not the @@ -94014,16 +96672,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 - - *608 + - *421 + - *607 responses: '200': description: Response content: application/json: - schema: *612 + schema: *611 examples: default: value: @@ -94077,9 +96735,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#update-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: true content: @@ -94087,8 +96745,8 @@ paths: schema: type: object properties: - state: *609 - resolution: *610 + state: *608 + resolution: *609 resolution_comment: description: An optional comment when closing or reopening an alert. Cannot be updated or deleted. @@ -94126,7 +96784,7 @@ paths: description: Response content: application/json: - schema: *612 + schema: *611 examples: default: value: @@ -94221,9 +96879,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 - *19 - *17 responses: @@ -94234,7 +96892,7 @@ paths: schema: type: array description: List of locations where the secret was detected - items: &762 + items: &761 type: object properties: type: @@ -94261,6 +96919,7 @@ paths: - commit details: oneOf: + - *612 - *613 - *614 - *615 @@ -94273,7 +96932,6 @@ paths: - *622 - *623 - *624 - - *625 examples: default: value: @@ -94359,8 +97017,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#create-a-push-protection-bypass parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -94368,14 +97026,14 @@ paths: schema: type: object properties: - reason: &627 + reason: &626 description: The reason for bypassing push protection. type: string enum: - false_positive - used_in_tests - will_fix_later - placeholder_id: *626 + placeholder_id: *625 required: - reason - placeholder_id @@ -94392,7 +97050,7 @@ paths: schema: type: object properties: - reason: *627 + reason: *626 expire_at: type: - string @@ -94439,8 +97097,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#get-secret-scanning-scan-history-for-a-repository parameters: + - *324 - *325 - - *326 responses: '404': description: Repository does not have GitHub Advanced Security or secret @@ -94455,7 +97113,7 @@ paths: properties: incremental_scans: type: array - items: &628 + items: &627 description: Information on a single scan performed by secret scanning on the repository type: object @@ -94483,15 +97141,15 @@ paths: the scan is pending pattern_update_scans: type: array - items: *628 + items: *627 backfill_scans: type: array - items: *628 + items: *627 custom_pattern_backfill_scans: type: array items: allOf: - - *628 + - *627 - type: object properties: pattern_name: @@ -94561,8 +97219,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#list-repository-security-advisories parameters: + - *324 - *325 - - *326 - *59 - name: sort description: The property to sort the results by. @@ -94606,9 +97264,9 @@ paths: application/json: schema: type: array - items: *629 + items: *628 examples: - default: *630 + default: *629 '400': *14 '404': *6 x-github: @@ -94631,8 +97289,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#create-a-repository-security-advisory parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -94712,7 +97370,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 required: - login - type @@ -94802,9 +97460,9 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: &632 + default: &631 value: ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -95037,8 +97695,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -95151,7 +97809,7 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: default: value: @@ -95298,17 +97956,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#get-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '200': description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *632 + default: *631 '403': *27 '404': *6 x-github: @@ -95332,9 +97990,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#update-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 requestBody: required: true content: @@ -95414,7 +98072,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 required: - login - type @@ -95505,10 +98163,10 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *632 - add_credit: *632 + default: *631 + add_credit: *631 '403': *27 '404': *6 '422': @@ -95546,9 +98204,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#request-a-cve-for-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '202': *37 '400': *14 @@ -95575,17 +98233,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#create-a-temporary-private-fork parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '202': description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 '400': *14 '422': *15 '403': *27 @@ -95611,8 +98269,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#list-stargazers parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -95708,8 +98366,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-weekly-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Returns a weekly aggregate of the number of additions and deletions @@ -95718,7 +98376,7 @@ paths: application/json: schema: type: array - items: &633 + items: &632 title: Code Frequency Stat description: Code Frequency Stat type: array @@ -95731,7 +98389,7 @@ paths: - 1124 - -435 '202': *37 - '204': *184 + '204': *183 '422': description: Repository contains more than 10,000 commits x-github: @@ -95751,8 +98409,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-last-year-of-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -95803,7 +98461,7 @@ paths: total: 89 week: 1336280400 '202': *37 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95830,8 +98488,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-all-contributor-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -95903,7 +98561,7 @@ paths: d: 77 c: 10 '202': *37 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -95925,8 +98583,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-weekly-commit-count parameters: + - *324 - *325 - - *326 responses: '200': description: The array order is oldest week (index 0) to most recent week. @@ -96080,8 +98738,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-hourly-commit-count-for-each-day parameters: + - *324 - *325 - - *326 responses: '200': description: For example, `[2, 14, 25]` indicates that there were 25 total @@ -96091,7 +98749,7 @@ paths: application/json: schema: type: array - items: *633 + items: *632 examples: default: value: @@ -96104,7 +98762,7 @@ paths: - - 0 - 2 - 21 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96124,8 +98782,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#create-a-commit-status parameters: + - *324 - *325 - - *326 - name: sha in: path required: true @@ -96181,7 +98839,7 @@ paths: description: Response content: application/json: - schema: *634 + schema: *633 examples: default: value: @@ -96235,8 +98893,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#list-watchers parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96268,14 +98926,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#get-a-repository-subscription parameters: + - *324 - *325 - - *326 responses: '200': description: if you subscribe to the repository content: application/json: - schema: &635 + schema: &634 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -96348,8 +99006,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#set-a-repository-subscription parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -96375,7 +99033,7 @@ paths: description: Response content: application/json: - schema: *635 + schema: *634 examples: default: value: @@ -96402,8 +99060,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#delete-a-repository-subscription parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -96423,8 +99081,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-tags parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96506,8 +99164,8 @@ paths: url: https://docs.github.com/rest/repos/contents#download-a-repository-archive-tar operationId: repos/download-tarball-archive parameters: + - *324 - *325 - - *326 - name: ref in: path required: true @@ -96543,8 +99201,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-teams parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96554,9 +99212,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 headers: Link: *65 '404': *6 @@ -96576,8 +99234,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#get-all-repository-topics parameters: + - *324 - *325 - - *326 - *19 - *17 responses: @@ -96585,7 +99243,7 @@ paths: description: Response content: application/json: - schema: &636 + schema: &635 title: Topic description: A topic aggregates entities that are related to a subject. type: object @@ -96597,7 +99255,7 @@ paths: required: - names examples: - default: &637 + default: &636 value: names: - octocat @@ -96620,8 +99278,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#replace-all-repository-topics parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -96652,9 +99310,9 @@ paths: description: Response content: application/json: - schema: *636 + schema: *635 examples: - default: *637 + default: *636 '404': *6 '422': *7 x-github: @@ -96675,9 +99333,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-repository-clones parameters: + - *324 - *325 - - *326 - - &638 + - &637 name: per description: The time frame to display results for. in: query @@ -96708,7 +99366,7 @@ paths: - 128 clones: type: array - items: &639 + items: &638 title: Traffic type: object properties: @@ -96795,8 +99453,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-top-referral-paths parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -96890,8 +99548,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-top-referral-sources parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -96954,9 +99612,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-page-views parameters: + - *324 - *325 - - *326 - - *638 + - *637 responses: '200': description: Response @@ -96977,7 +99635,7 @@ paths: - 3782 views: type: array - items: *639 + items: *638 required: - uniques - count @@ -97054,8 +99712,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#transfer-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -97091,7 +99749,7 @@ paths: description: Response content: application/json: - schema: *153 + schema: *152 examples: default: value: @@ -97329,8 +99987,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response if repository is enabled with vulnerability alerts @@ -97353,8 +100011,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-vulnerability-alerts parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -97376,8 +100034,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-vulnerability-alerts parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -97403,8 +100061,8 @@ paths: url: https://docs.github.com/rest/repos/contents#download-a-repository-archive-zip operationId: repos/download-zipball-archive parameters: + - *324 - *325 - - *326 - name: ref in: path required: true @@ -97496,9 +100154,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -97539,7 +100197,7 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: default: value: @@ -97645,8 +100303,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#add-issue-field-values-to-an-issue parameters: - - *142 - - *526 + - *141 + - *525 requestBody: required: true content: @@ -97712,9 +100370,9 @@ paths: type: array description: The current issue field values for this issue after adding the new values - items: *529 + items: *528 examples: - default: *640 + default: *639 '400': *14 '403': *27 '404': *6 @@ -97750,8 +100408,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#set-issue-field-values-for-an-issue parameters: - - *142 - - *526 + - *141 + - *525 requestBody: required: true content: @@ -97818,9 +100476,9 @@ paths: type: array description: The current issue field values for this issue after setting the new values - items: *529 + items: *528 examples: - default: *640 + default: *639 '400': *14 '403': *27 '404': *6 @@ -97851,9 +100509,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#delete-an-issue-field-value-from-an-issue parameters: - - *142 - - *526 - - *229 + - *141 + - *525 + - *228 responses: '204': description: Issue field value deleted successfully @@ -97974,7 +100632,7 @@ paths: html_url: type: string format: uri - repository: *153 + repository: *152 score: type: number file_size: @@ -97993,7 +100651,7 @@ paths: examples: - 73..77 - 77..78 - text_matches: &641 + text_matches: &640 title: Search Result Text Matches type: array items: @@ -98156,7 +100814,7 @@ paths: enum: - author-date - committer-date - - &642 + - &641 name: order description: Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter @@ -98225,7 +100883,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 comment_count: type: integer message: @@ -98244,7 +100902,7 @@ paths: url: type: string format: uri - verification: *506 + verification: *505 required: - author - committer @@ -98259,7 +100917,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 parents: type: array items: @@ -98271,12 +100929,12 @@ paths: type: string sha: type: string - repository: *153 + repository: *152 score: type: number node_id: type: string - text_matches: *641 + text_matches: *640 required: - sha - node_id @@ -98468,7 +101126,7 @@ paths: - interactions - created - updated - - *642 + - *641 - *17 - *19 - name: advanced_search @@ -98582,11 +101240,11 @@ paths: type: - string - 'null' - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: type: string state_reason: @@ -98596,7 +101254,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 comments: type: integer created_at: @@ -98610,7 +101268,7 @@ paths: - string - 'null' format: date-time - text_matches: *641 + text_matches: *640 pull_request: type: object properties: @@ -98659,7 +101317,7 @@ paths: timeline_url: type: string format: uri - type: *230 + type: *229 performed_via_github_app: anyOf: - type: 'null' @@ -98875,7 +101533,7 @@ paths: enum: - created - updated - - *642 + - *641 - *17 - *19 responses: @@ -98920,7 +101578,7 @@ paths: - 'null' score: type: number - text_matches: *641 + text_matches: *640 required: - id - node_id @@ -99005,7 +101663,7 @@ paths: - forks - help-wanted-issues - updated - - *642 + - *641 - *17 - *19 responses: @@ -99251,7 +101909,7 @@ paths: - admin - pull - push - text_matches: *641 + text_matches: *640 temp_clone_token: type: string allow_merge_commit: @@ -99559,7 +102217,7 @@ paths: - string - 'null' format: uri - text_matches: *641 + text_matches: *640 related: type: - array @@ -99752,7 +102410,7 @@ paths: - followers - repositories - joined - - *642 + - *641 - *17 - *19 responses: @@ -99862,7 +102520,7 @@ paths: type: - boolean - 'null' - text_matches: *641 + text_matches: *640 blog: type: - string @@ -99944,7 +102602,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#get-a-team-legacy parameters: - - &645 + - &644 name: team_id description: The unique identifier of the team. in: path @@ -99956,9 +102614,9 @@ paths: description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 x-github: githubCloudOnly: false @@ -99985,7 +102643,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#update-a-team-legacy parameters: - - *645 + - *644 requestBody: required: true content: @@ -100049,16 +102707,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '201': description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 '422': *15 '403': *27 @@ -100086,7 +102744,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#delete-a-team-legacy parameters: - - *645 + - *644 responses: '204': description: Response @@ -100115,7 +102773,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#list-pending-team-invitations-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -100125,9 +102783,9 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 x-github: @@ -100153,7 +102811,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#list-team-members-legacy parameters: - - *645 + - *644 - name: role description: Filters members returned by their role in the team. in: query @@ -100204,7 +102862,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#get-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100241,7 +102899,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#add-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100281,7 +102939,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#remove-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100318,16 +102976,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#get-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 responses: '200': description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-user-is-a-team-maintainer: *646 + response-if-user-is-a-team-maintainer: *645 '404': *6 x-github: githubCloudOnly: false @@ -100360,7 +103018,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 requestBody: required: false @@ -100386,9 +103044,9 @@ paths: description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-users-membership-with-team-is-now-pending: *647 + response-if-users-membership-with-team-is-now-pending: *646 '403': description: Forbidden if team synchronization is set up '422': @@ -100422,7 +103080,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -100450,7 +103108,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#list-team-repositories-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -100460,9 +103118,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 '404': *6 @@ -100492,15 +103150,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#check-team-permissions-for-a-repository-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 responses: '200': description: Alternative response with extra repository information content: application/json: - schema: *648 + schema: *647 examples: alternative-response-with-extra-repository-information: value: @@ -100651,9 +103309,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#add-or-update-team-repository-permissions-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 requestBody: required: false content: @@ -100703,9 +103361,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#remove-a-repository-from-a-team-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 responses: '204': description: Response @@ -100730,7 +103388,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#list-child-teams-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -100740,9 +103398,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - response-if-child-teams-exist: *649 + response-if-child-teams-exist: *648 headers: Link: *65 '404': *6 @@ -100775,7 +103433,7 @@ paths: application/json: schema: oneOf: - - &650 + - &649 title: Private User description: Private User type: object @@ -101025,7 +103683,7 @@ paths: - private_gists - total_private_repos - two_factor_authentication - - &675 + - &674 title: Public User description: Public User type: object @@ -101359,7 +104017,7 @@ paths: description: Response content: application/json: - schema: *650 + schema: *649 examples: default: value: @@ -101562,9 +104220,9 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: - default: *236 + default: *235 '304': *35 '500': *53 '401': *23 @@ -101703,17 +104361,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -101757,7 +104415,7 @@ paths: type: integer secrets: type: array - items: &651 + items: &650 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -101799,7 +104457,7 @@ paths: - visibility - selected_repositories_url examples: - default: *447 + default: *446 headers: Link: *65 x-github: @@ -101871,13 +104529,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#get-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *651 + schema: *650 examples: default: value: @@ -101907,7 +104565,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#create-or-update-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 requestBody: required: true content: @@ -101952,7 +104610,7 @@ paths: description: Response after successfully creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -101980,7 +104638,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#delete-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 responses: '204': description: Response @@ -102005,7 +104663,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#list-selected-repositories-for-a-user-secret parameters: - - *161 + - *160 responses: '200': description: Response @@ -102021,9 +104679,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *189 + default: *188 '401': *23 '403': *27 '404': *6 @@ -102048,7 +104706,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#set-selected-repositories-for-a-user-secret parameters: - - *161 + - *160 requestBody: required: true content: @@ -102102,7 +104760,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#add-a-selected-repository-to-a-user-secret parameters: - - *161 + - *160 - name: repository_id in: path required: true @@ -102135,7 +104793,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#remove-a-selected-repository-from-a-user-secret parameters: - - *161 + - *160 - name: repository_id in: path required: true @@ -102167,15 +104825,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '304': *35 '500': *53 '401': *23 @@ -102201,7 +104859,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#update-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 requestBody: required: false content: @@ -102231,9 +104889,9 @@ paths: description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -102255,7 +104913,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#delete-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '202': *37 '304': *35 @@ -102284,13 +104942,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#export-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '202': description: Response content: application/json: - schema: &652 + schema: &651 type: object title: Fetches information about an export of a codespace. description: An export of a codespace. Also, latest export details @@ -102343,7 +105001,7 @@ paths: examples: - https://github.com/octocat/hello-world/tree/:branch examples: - default: &653 + default: &652 value: state: succeeded completed_at: '2022-01-01T14:59:22Z' @@ -102375,7 +105033,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-details-about-a-codespace-export parameters: - - *237 + - *236 - name: export_id in: path required: true @@ -102388,9 +105046,9 @@ paths: description: Response content: application/json: - schema: *652 + schema: *651 examples: - default: *653 + default: *652 '404': *6 x-github: githubCloudOnly: false @@ -102411,7 +105069,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/machines#list-machine-types-for-a-codespace parameters: - - *237 + - *236 responses: '200': description: Response @@ -102427,9 +105085,9 @@ paths: type: integer machines: type: array - items: *446 + items: *445 examples: - default: *654 + default: *653 '304': *35 '500': *53 '401': *23 @@ -102458,7 +105116,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-repository-from-an-unpublished-codespace parameters: - - *237 + - *236 requestBody: required: true content: @@ -102514,11 +105172,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *328 + repository: *327 machine: anyOf: - type: 'null' - - *446 + - *445 devcontainer_path: description: Path to devcontainer.json from repo root used to create Codespace. @@ -103315,15 +105973,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#start-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '304': *35 '500': *53 '400': *14 @@ -103355,15 +106013,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#stop-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '500': *53 '401': *23 '403': *27 @@ -103393,9 +106051,9 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: &665 + default: &664 value: - id: 197 name: hello_docker @@ -103496,7 +106154,7 @@ paths: application/json: schema: type: array - items: &655 + items: &654 title: Email description: Email type: object @@ -103566,9 +106224,9 @@ paths: application/json: schema: type: array - items: *655 + items: *654 examples: - default: &667 + default: &666 value: - email: octocat@github.com verified: true @@ -103645,7 +106303,7 @@ paths: application/json: schema: type: array - items: *655 + items: *654 examples: default: value: @@ -103903,7 +106561,7 @@ paths: application/json: schema: type: array - items: &656 + items: &655 title: GPG Key description: A unique encryption key type: object @@ -104048,7 +106706,7 @@ paths: - subkeys - revoked examples: - default: &684 + default: &683 value: - id: 3 name: Octocat's GPG Key @@ -104133,9 +106791,9 @@ paths: description: Response content: application/json: - schema: *656 + schema: *655 examples: - default: &657 + default: &656 value: id: 3 name: Octocat's GPG Key @@ -104192,7 +106850,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/gpg-keys#get-a-gpg-key-for-the-authenticated-user parameters: - - &658 + - &657 name: gpg_key_id description: The unique identifier of the GPG key. in: path @@ -104204,9 +106862,9 @@ paths: description: Response content: application/json: - schema: *656 + schema: *655 examples: - default: *657 + default: *656 '404': *6 '304': *35 '403': *27 @@ -104229,7 +106887,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/gpg-keys#delete-a-gpg-key-for-the-authenticated-user parameters: - - *658 + - *657 responses: '204': description: Response @@ -104422,7 +107080,7 @@ paths: allOf: - *77 examples: - default: *145 + default: *144 headers: Link: *65 '404': *6 @@ -104448,7 +107106,7 @@ paths: url: https://docs.github.com/rest/apps/installations#add-a-repository-to-an-app-installation parameters: - *21 - - *142 + - *141 responses: '204': description: Response @@ -104474,7 +107132,7 @@ paths: url: https://docs.github.com/rest/apps/installations#remove-a-repository-from-an-app-installation parameters: - *21 - - *142 + - *141 responses: '204': description: Response @@ -104508,12 +107166,12 @@ paths: application/json: schema: anyOf: - - *222 + - *221 - type: object properties: {} additionalProperties: false examples: - default: *223 + default: *222 '204': description: Response when there are no restrictions x-github: @@ -104537,7 +107195,7 @@ paths: required: true content: application/json: - schema: *517 + schema: *516 examples: default: value: @@ -104548,7 +107206,7 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: default: value: @@ -104629,7 +107287,7 @@ paths: - closed - all default: open - - *233 + - *232 - name: sort description: What to sort results by. in: query @@ -104654,7 +107312,7 @@ paths: type: array items: *81 examples: - default: *234 + default: *233 headers: Link: *65 '404': *6 @@ -104687,7 +107345,7 @@ paths: application/json: schema: type: array - items: &659 + items: &658 title: Key description: Key type: object @@ -104790,9 +107448,9 @@ paths: description: Response content: application/json: - schema: *659 + schema: *658 examples: - default: &660 + default: &659 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -104825,15 +107483,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/keys#get-a-public-ssh-key-for-the-authenticated-user parameters: - - *547 + - *546 responses: '200': description: Response content: application/json: - schema: *659 + schema: *658 examples: - default: *660 + default: *659 '404': *6 '304': *35 '403': *27 @@ -104856,7 +107514,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/keys#delete-a-public-ssh-key-for-the-authenticated-user parameters: - - *547 + - *546 responses: '204': description: Response @@ -104889,7 +107547,7 @@ paths: application/json: schema: type: array - items: &661 + items: &660 title: User Marketplace Purchase description: User Marketplace Purchase type: object @@ -104968,7 +107626,7 @@ paths: - account - plan examples: - default: &662 + default: &661 value: - billing_cycle: monthly next_billing_date: '2017-11-11T00:00:00Z' @@ -105030,9 +107688,9 @@ paths: application/json: schema: type: array - items: *661 + items: *660 examples: - default: *662 + default: *661 headers: Link: *65 '304': *35 @@ -105072,7 +107730,7 @@ paths: application/json: schema: type: array - items: *239 + items: *238 examples: default: value: @@ -105186,7 +107844,7 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: default: value: @@ -105273,7 +107931,7 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: default: value: @@ -105345,7 +108003,7 @@ paths: application/json: schema: type: array - items: *241 + items: *240 examples: default: value: @@ -105607,7 +108265,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -105787,7 +108445,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#get-a-user-migration-status parameters: - - *242 + - *241 - name: exclude in: query required: false @@ -105800,7 +108458,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -105994,7 +108652,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#download-a-user-migration-archive parameters: - - *242 + - *241 responses: '302': description: Response @@ -106020,7 +108678,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#delete-a-user-migration-archive parameters: - - *242 + - *241 responses: '204': description: Response @@ -106049,8 +108707,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#unlock-a-user-repository parameters: - - *242 - - *663 + - *241 + - *662 responses: '204': description: Response @@ -106074,7 +108732,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#list-repositories-for-a-user-migration parameters: - - *242 + - *241 - *17 - *19 responses: @@ -106163,7 +108821,7 @@ paths: - docker - nuget - container - - *664 + - *663 - *19 - *17 responses: @@ -106173,10 +108831,10 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *665 - '400': *666 + default: *664 + '400': *665 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -106196,16 +108854,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 responses: '200': description: Response content: application/json: - schema: *247 + schema: *246 examples: - default: &685 + default: &684 value: id: 40201 name: octo-name @@ -106318,8 +108976,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 responses: '204': description: Response @@ -106349,8 +109007,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - name: token description: package token schema: @@ -106382,8 +109040,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user parameters: + - *248 - *249 - - *250 - *19 - *17 - name: state @@ -106403,7 +109061,7 @@ paths: application/json: schema: type: array - items: *251 + items: *250 examples: default: value: @@ -106452,15 +109110,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '200': description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -106496,9 +109154,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '204': description: Response @@ -106528,9 +109186,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '204': description: Response @@ -106567,9 +109225,9 @@ paths: application/json: schema: type: array - items: *655 + items: *654 examples: - default: *667 + default: *666 headers: Link: *65 '304': *35 @@ -106682,7 +109340,7 @@ paths: type: array items: *77 examples: - default: &674 + default: &673 summary: Default response value: - id: 1296269 @@ -107000,9 +109658,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -107041,9 +109699,9 @@ paths: application/json: schema: type: array - items: *519 + items: *518 examples: - default: *668 + default: *667 headers: Link: *65 '304': *35 @@ -107066,7 +109724,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#accept-a-repository-invitation parameters: - - *226 + - *225 responses: '204': description: Response @@ -107090,7 +109748,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#decline-a-repository-invitation parameters: - - *226 + - *225 responses: '204': description: Response @@ -107123,7 +109781,7 @@ paths: application/json: schema: type: array - items: &669 + items: &668 title: Social account description: Social media account type: object @@ -107140,7 +109798,7 @@ paths: - provider - url examples: - default: &670 + default: &669 value: - provider: twitter url: https://twitter.com/github @@ -107203,9 +109861,9 @@ paths: application/json: schema: type: array - items: *669 + items: *668 examples: - default: *670 + default: *669 '422': *15 '304': *35 '404': *6 @@ -107293,7 +109951,7 @@ paths: application/json: schema: type: array - items: &671 + items: &670 title: SSH Signing Key description: A public SSH key used to sign Git commits type: object @@ -107313,7 +109971,7 @@ paths: - title - created_at examples: - default: &703 + default: &702 value: - id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -107378,9 +110036,9 @@ paths: description: Response content: application/json: - schema: *671 + schema: *670 examples: - default: &672 + default: &671 value: id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -107410,7 +110068,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/ssh-signing-keys#get-an-ssh-signing-key-for-the-authenticated-user parameters: - - &673 + - &672 name: ssh_signing_key_id description: The unique identifier of the SSH signing key. in: path @@ -107422,9 +110080,9 @@ paths: description: Response content: application/json: - schema: *671 + schema: *670 examples: - default: *672 + default: *671 '404': *6 '304': *35 '403': *27 @@ -107447,7 +110105,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/ssh-signing-keys#delete-an-ssh-signing-key-for-the-authenticated-user parameters: - - *673 + - *672 responses: '204': description: Response @@ -107476,7 +110134,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-the-authenticated-user parameters: - - &704 + - &703 name: sort description: The property to sort the results by. `created` means when the repository was starred. `updated` means when the repository was last pushed @@ -107501,11 +110159,11 @@ paths: type: array items: *77 examples: - default-response: *674 + default-response: *673 application/vnd.github.v3.star+json: schema: type: array - items: &705 + items: &704 title: Starred Repository description: Starred Repository type: object @@ -107661,8 +110319,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response if this repository is starred by you @@ -107690,8 +110348,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#star-a-repository-for-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -107715,8 +110373,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#unstar-a-repository-for-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -107749,9 +110407,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 '304': *35 @@ -107788,7 +110446,7 @@ paths: application/json: schema: type: array - items: *321 + items: *320 examples: default: value: @@ -107874,10 +110532,10 @@ paths: application/json: schema: oneOf: - - *650 - - *675 + - *649 + - *674 examples: - default-response: &679 + default-response: &678 summary: Default response value: login: octocat @@ -107912,7 +110570,7 @@ paths: following: 0 created_at: '2008-01-14T04:33:35Z' updated_at: '2008-01-14T04:33:35Z' - response-with-git-hub-plan-information: &680 + response-with-git-hub-plan-information: &679 summary: Response with GitHub plan information value: login: octocat @@ -107969,14 +110627,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-user-owned-project parameters: - - &677 + - &676 name: user_id description: The unique identifier of the user. in: path required: true schema: type: string - - *265 + - *264 requestBody: required: true description: Details of the draft item to create in the project. @@ -108010,9 +110668,9 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: - draft_issue: *271 + draft_issue: *270 '304': *35 '403': *27 '401': *23 @@ -108035,7 +110693,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/users#list-users parameters: - - *676 + - *675 - *17 responses: '200': @@ -108070,8 +110728,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/views#create-a-view-for-a-user-owned-project parameters: - - *677 - - *265 + - *676 + - *264 requestBody: required: true content: @@ -108145,17 +110803,17 @@ paths: description: Response for creating a view in a user-owned project. content: application/json: - schema: *678 + schema: *677 examples: table_view: summary: Response for creating a table view - value: *275 + value: *274 board_view: summary: Response for creating a board view with filter - value: *275 + value: *274 roadmap_view: summary: Response for creating a roadmap view - value: *275 + value: *274 '304': *35 '403': *27 '401': *23 @@ -108197,11 +110855,11 @@ paths: application/json: schema: oneOf: - - *650 - - *675 + - *649 + - *674 examples: - default-response: *679 - response-with-git-hub-plan-information: *680 + default-response: *678 + response-with-git-hub-plan-information: *679 '404': *6 x-github: githubCloudOnly: false @@ -108251,8 +110909,8 @@ paths: required: - subject_digests examples: - default: *681 - withPredicateType: *682 + default: *680 + withPredicateType: *681 responses: '200': description: Response @@ -108292,7 +110950,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: *683 + default: *682 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -108481,12 +111139,12 @@ paths: initiator: type: string examples: - default: *386 + default: *385 '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -108520,9 +111178,9 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *665 + default: *664 '403': *27 '401': *23 x-github: @@ -108906,9 +111564,9 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: - default: *684 + default: *683 headers: Link: *65 x-github: @@ -109012,7 +111670,7 @@ paths: application/json: schema: *20 examples: - default: *516 + default: *515 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -109137,7 +111795,7 @@ paths: - docker - nuget - container - - *664 + - *663 - *69 - *19 - *17 @@ -109148,12 +111806,12 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *665 + default: *664 '403': *27 '401': *23 - '400': *666 + '400': *665 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -109173,17 +111831,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '200': description: Response content: application/json: - schema: *247 + schema: *246 examples: - default: *685 + default: *684 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -109204,8 +111862,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '204': @@ -109238,8 +111896,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 - name: token description: package token @@ -109272,8 +111930,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '200': @@ -109282,7 +111940,7 @@ paths: application/json: schema: type: array - items: *251 + items: *250 examples: default: value: @@ -109340,16 +111998,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-a-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 - *69 responses: '200': description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -109384,10 +112042,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-package-version-for-a-user parameters: + - *248 - *249 - - *250 - *69 - - *252 + - *251 responses: '204': description: Response @@ -109419,10 +112077,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-package-version-for-a-user parameters: + - *248 - *249 - - *250 - *69 - - *252 + - *251 responses: '204': description: Response @@ -109463,9 +112121,9 @@ paths: application/json: schema: type: array - items: *263 + items: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -109487,16 +112145,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/projects#get-project-for-user parameters: - - *265 + - *264 - *69 responses: '200': description: Response content: application/json: - schema: *263 + schema: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -109518,7 +112176,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#list-project-fields-for-user parameters: - - *265 + - *264 - *69 - *17 - *45 @@ -109530,9 +112188,9 @@ paths: application/json: schema: type: array - items: *268 + items: *267 examples: - default: *686 + default: *685 headers: Link: *65 '304': *35 @@ -109554,7 +112212,7 @@ paths: url: https://docs.github.com/rest/projects/fields#add-field-to-user-owned-project parameters: - *69 - - *265 + - *264 requestBody: required: true content: @@ -109592,7 +112250,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: *687 + items: *686 required: - name - data_type @@ -109608,7 +112266,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: *688 + iteration_configuration: *687 required: - name - data_type @@ -109630,20 +112288,20 @@ paths: value: name: Due date data_type: date - single_select_field: *689 - iteration_field: *690 + single_select_field: *688 + iteration_field: *689 responses: '201': description: Response content: application/json: - schema: *268 + schema: *267 examples: - text_field: *691 - number_field: *692 - date_field: *693 - single_select_field: *694 - iteration_field: *695 + text_field: *690 + number_field: *691 + date_field: *692 + single_select_field: *693 + iteration_field: *694 '304': *35 '403': *27 '401': *23 @@ -109664,17 +112322,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#get-project-field-for-user parameters: - - *265 - - *696 + - *264 + - *695 - *69 responses: '200': description: Response content: application/json: - schema: *268 + schema: *267 examples: - default: *697 + default: *696 headers: Link: *65 '304': *35 @@ -109697,7 +112355,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-a-user-owned-project parameters: - - *265 + - *264 - *69 - *45 - *46 @@ -109730,9 +112388,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -109754,7 +112412,7 @@ paths: url: https://docs.github.com/rest/projects/items#add-item-to-user-owned-project parameters: - *69 - - *265 + - *264 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -109824,22 +112482,22 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *271 + value: *270 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *271 + value: *270 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *271 + value: *270 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *271 + value: *270 '304': *35 '403': *27 '401': *23 @@ -109859,9 +112517,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#get-an-item-for-a-user-owned-project parameters: - - *265 + - *264 - *69 - - *274 + - *273 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the title field will be returned. @@ -109881,9 +112539,9 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -109904,9 +112562,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#update-project-item-for-user parameters: - - *265 + - *264 - *69 - - *274 + - *273 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -109979,13 +112637,13 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - text_field: *273 - number_field: *273 - date_field: *273 - single_select_field: *273 - iteration_field: *273 + text_field: *272 + number_field: *272 + date_field: *272 + single_select_field: *272 + iteration_field: *272 '401': *23 '403': *27 '404': *6 @@ -110005,9 +112663,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#delete-project-item-for-user parameters: - - *265 + - *264 - *69 - - *274 + - *273 responses: '204': description: Response @@ -110029,9 +112687,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-a-user-project-view parameters: - - *265 + - *264 - *69 - - *698 + - *697 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the @@ -110057,9 +112715,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -110278,9 +112936,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 x-github: @@ -110306,7 +112964,7 @@ paths: - *115 - *117 - *116 - - *699 + - *698 - *118 responses: '200': @@ -110437,7 +113095,7 @@ paths: parameters: - *69 - *115 - - *700 + - *699 - *116 responses: '200': @@ -110536,9 +113194,9 @@ paths: - *115 - *117 - *116 - - *701 + - *700 - *118 - - *702 + - *701 responses: '200': description: Response when getting a billing usage summary @@ -110672,9 +113330,9 @@ paths: application/json: schema: type: array - items: *669 + items: *668 examples: - default: *670 + default: *669 headers: Link: *65 x-github: @@ -110704,9 +113362,9 @@ paths: application/json: schema: type: array - items: *671 + items: *670 examples: - default: *703 + default: *702 headers: Link: *65 x-github: @@ -110731,7 +113389,7 @@ paths: url: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-a-user parameters: - *69 - - *704 + - *703 - *59 - *17 - *19 @@ -110743,11 +113401,11 @@ paths: schema: anyOf: - type: array - items: *705 + items: *704 - type: array items: *77 examples: - default-response: *674 + default-response: *673 headers: Link: *65 x-github: @@ -110776,9 +113434,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *260 + default: *259 headers: Link: *65 x-github: @@ -110907,7 +113565,7 @@ webhooks: type: string enum: - disabled - enterprise: &706 + enterprise: &705 title: Enterprise description: |- An enterprise on GitHub. Webhook payloads contain the `enterprise` property when the webhook is configured @@ -110976,7 +113634,7 @@ webhooks: - created_at - updated_at - avatar_url - installation: &707 + installation: &706 title: Simple Installation description: |- The GitHub App installation. Webhook payloads contain the `installation` property when the event is configured @@ -110997,7 +113655,7 @@ webhooks: required: - id - node_id - organization: &708 + organization: &707 title: Organization Simple description: |- A GitHub organization. Webhook payloads contain the `organization` property when the webhook is configured for an @@ -111070,7 +113728,7 @@ webhooks: - public_members_url - avatar_url - description - repository: &709 + repository: &708 title: Repository description: |- The repository on GitHub where the event occurred. Webhook payloads contain the `repository` property @@ -111985,10 +114643,10 @@ webhooks: type: string enum: - enabled - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -112064,11 +114722,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: &710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: &709 title: branch protection rule description: The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) @@ -112291,11 +114949,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: *710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: *709 sender: *4 required: - action @@ -112483,11 +115141,11 @@ webhooks: - everyone required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: *710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: *709 sender: *4 required: - action @@ -112571,7 +115229,7 @@ webhooks: type: string enum: - completed - check_run: &712 + check_run: &711 title: CheckRun description: A check performed on the code of a given code change type: object @@ -112637,7 +115295,7 @@ webhooks: pull_requests: type: array items: *84 - repository: *153 + repository: *152 status: type: string enum: @@ -112681,7 +115339,7 @@ webhooks: - examples: - neutral - deployment: *711 + deployment: *710 details_url: type: string examples: @@ -112779,10 +115437,10 @@ webhooks: - output - app - pull_requests - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -113173,11 +115831,11 @@ webhooks: type: string enum: - created - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -113571,11 +116229,11 @@ webhooks: type: string enum: - requested_action - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 requested_action: description: The action requested by the user. type: object @@ -113978,11 +116636,11 @@ webhooks: type: string enum: - rerequested - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -114967,10 +117625,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -115674,10 +118332,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -116375,10 +119033,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -116547,7 +119205,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -116699,20 +119357,20 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: &713 + commit_oid: &712 description: The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - enterprise: *706 - installation: *707 - organization: *708 - ref: &714 + enterprise: *705 + installation: *706 + organization: *707 + ref: &713 description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -116879,7 +119537,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -117120,12 +119778,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -117223,7 +119881,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -117408,12 +120066,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -117582,7 +120240,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -117759,12 +120417,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -117865,7 +120523,7 @@ webhooks: type: - object - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -118054,9 +120712,9 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 ref: description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event @@ -118064,7 +120722,7 @@ webhooks: type: - string - 'null' - repository: *709 + repository: *708 sender: *4 required: - action @@ -118163,7 +120821,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -118310,12 +120968,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -118484,7 +121142,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -118636,10 +121294,10 @@ webhooks: - dismissed_reason - rule - tool - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -118899,10 +121557,10 @@ webhooks: - updated_at - author_association - body - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -118983,18 +121641,18 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 master_branch: description: The name of the repository's default branch (usually `main`). type: string - organization: *708 - pusher_type: &715 + organization: *707 + pusher_type: &714 description: The pusher type for the event. Can be either `user` or a deploy key. type: string - ref: &716 + ref: &715 description: The [`git ref`](https://docs.github.com/rest/git/refs#get-a-reference) resource. type: string @@ -119004,7 +121662,7 @@ webhooks: enum: - tag - branch - repository: *709 + repository: *708 sender: *4 required: - ref @@ -119086,10 +121744,10 @@ webhooks: type: string enum: - created - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119174,9 +121832,9 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119253,10 +121911,10 @@ webhooks: type: string enum: - promote_to_enterprise - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119333,10 +121991,10 @@ webhooks: type: string enum: - updated - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -119413,19 +122071,19 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - repository: *709 - organization: *708 + enterprise: *705 + installation: *706 + repository: *708 + organization: *707 sender: *4 new_property_values: type: array description: The new custom property values for the repository. - items: *280 + items: *279 old_property_values: type: array description: The old custom property values for the repository. - items: *280 + items: *279 required: - action - repository @@ -119501,18 +122159,18 @@ webhooks: title: delete event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - pusher_type: *715 - ref: *716 + enterprise: *705 + installation: *706 + organization: *707 + pusher_type: *714 + ref: *715 ref_type: description: The type of Git ref object deleted in the repository. type: string enum: - tag - branch - repository: *709 + repository: *708 sender: *4 required: - ref @@ -119592,11 +122250,11 @@ webhooks: type: string enum: - assignees_changed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -119676,11 +122334,11 @@ webhooks: type: string enum: - auto_dismissed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -119761,11 +122419,11 @@ webhooks: type: string enum: - auto_reopened - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -119846,11 +122504,11 @@ webhooks: type: string enum: - created - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -119929,11 +122587,11 @@ webhooks: type: string enum: - dismissed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120012,11 +122670,11 @@ webhooks: type: string enum: - fixed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120096,11 +122754,11 @@ webhooks: type: string enum: - reintroduced - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120179,11 +122837,11 @@ webhooks: type: string enum: - reopened - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120260,9 +122918,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - key: &717 + enterprise: *705 + installation: *706 + key: &716 description: The [`deploy key`](https://docs.github.com/rest/deploy-keys/deploy-keys#get-a-deploy-key) resource. type: object @@ -120300,8 +122958,8 @@ webhooks: - verified - created_at - read_only - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -120378,11 +123036,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - key: *717 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + key: *716 + organization: *707 + repository: *708 sender: *4 required: - action @@ -120949,12 +123607,12 @@ webhooks: - updated_at - statuses_url - repository_url - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: &721 + workflow: &720 title: Workflow type: - object @@ -121705,13 +124363,13 @@ webhooks: deployment: anyOf: - type: 'null' - - *481 + - *480 pull_requests: type: array - items: *565 - repository: *709 - organization: *708 - installation: *707 + items: *564 + repository: *708 + organization: *707 + installation: *706 sender: *4 responses: '200': @@ -121782,7 +124440,7 @@ webhooks: type: string enum: - approved - approver: &718 + approver: &717 type: object properties: avatar_url: @@ -121825,11 +124483,11 @@ webhooks: type: string comment: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - reviewers: &719 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + reviewers: &718 type: array items: type: object @@ -121910,7 +124568,7 @@ webhooks: sender: *4 since: type: string - workflow_job_run: &720 + workflow_job_run: &719 type: object properties: conclusion: @@ -122656,18 +125314,18 @@ webhooks: type: string enum: - rejected - approver: *718 + approver: *717 comment: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - reviewers: *719 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + reviewers: *718 sender: *4 since: type: string - workflow_job_run: *720 + workflow_job_run: *719 workflow_job_runs: type: array items: @@ -123384,13 +126042,13 @@ webhooks: type: string enum: - requested - enterprise: *706 + enterprise: *705 environment: type: string - installation: *707 - organization: *708 - repository: *709 - requestor: &726 + installation: *706 + organization: *707 + repository: *708 + requestor: &725 title: User type: - object @@ -125323,12 +127981,12 @@ webhooks: - updated_at - deployment_url - repository_url - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Deployment Workflow Run type: @@ -126019,7 +128677,7 @@ webhooks: type: string enum: - answered - answer: &724 + answer: &723 type: object properties: author_association: @@ -126179,11 +128837,11 @@ webhooks: - created_at - updated_at - body - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126310,11 +128968,11 @@ webhooks: - from required: - category - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126397,11 +129055,11 @@ webhooks: type: string enum: - closed - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126483,7 +129141,7 @@ webhooks: type: string enum: - created - comment: &723 + comment: &722 type: object properties: author_association: @@ -126643,11 +129301,11 @@ webhooks: - updated_at - body - reactions - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126730,12 +129388,12 @@ webhooks: type: string enum: - deleted - comment: *723 - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + comment: *722 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126830,12 +129488,12 @@ webhooks: - from required: - body - comment: *723 - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + comment: *722 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -126919,11 +129577,11 @@ webhooks: type: string enum: - created - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127005,11 +129663,11 @@ webhooks: type: string enum: - deleted - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127109,11 +129767,11 @@ webhooks: type: string required: - from - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127195,10 +129853,10 @@ webhooks: type: string enum: - labeled - discussion: *722 - enterprise: *706 - installation: *707 - label: &725 + discussion: *721 + enterprise: *705 + installation: *706 + label: &724 title: Label type: object properties: @@ -127231,8 +129889,8 @@ webhooks: - color - default - description - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127315,11 +129973,11 @@ webhooks: type: string enum: - locked - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127401,11 +130059,11 @@ webhooks: type: string enum: - pinned - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127487,11 +130145,11 @@ webhooks: type: string enum: - reopened - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127576,16 +130234,16 @@ webhooks: changes: type: object properties: - new_discussion: *722 - new_repository: *709 + new_discussion: *721 + new_repository: *708 required: - new_discussion - new_repository - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127668,10 +130326,10 @@ webhooks: type: string enum: - unanswered - discussion: *722 - old_answer: *724 - organization: *708 - repository: *709 + discussion: *721 + old_answer: *723 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127753,12 +130411,12 @@ webhooks: type: string enum: - unlabeled - discussion: *722 - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127841,11 +130499,11 @@ webhooks: type: string enum: - unlocked - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127927,11 +130585,11 @@ webhooks: type: string enum: - unpinned - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128004,7 +130662,7 @@ webhooks: description: A user forks a repository. type: object properties: - enterprise: *706 + enterprise: *705 forkee: description: The created [`repository`](https://docs.github.com/rest/repos/repos#get-a-repository) resource. @@ -128682,9 +131340,9 @@ webhooks: type: integer watchers_count: type: integer - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - forkee @@ -128830,9 +131488,9 @@ webhooks: title: gollum event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pages: description: The pages that were updated. type: array @@ -128870,7 +131528,7 @@ webhooks: - action - sha - html_url - repository: *709 + repository: *708 sender: *4 required: - pages @@ -128946,10 +131604,10 @@ webhooks: type: string enum: - created - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: &727 + organization: *707 + repositories: &726 description: An array of repository objects that the installation can access. type: array @@ -128975,8 +131633,8 @@ webhooks: - name - full_name - private - repository: *709 - requester: *726 + repository: *708 + requester: *725 sender: *4 required: - action @@ -129051,11 +131709,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129132,11 +131790,11 @@ webhooks: type: string enum: - new_permissions_accepted - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129213,10 +131871,10 @@ webhooks: type: string enum: - added - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories_added: &728 + organization: *707 + repositories_added: &727 description: An array of repository objects, which were added to the installation. type: array @@ -129262,15 +131920,15 @@ webhooks: private: description: Whether the repository is private or public. type: boolean - repository: *709 - repository_selection: &729 + repository: *708 + repository_selection: &728 description: Describe whether all repositories have been selected or there's a selection involved type: string enum: - all - selected - requester: *726 + requester: *725 sender: *4 required: - action @@ -129349,10 +132007,10 @@ webhooks: type: string enum: - removed - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories_added: *728 + organization: *707 + repositories_added: *727 repositories_removed: description: An array of repository objects, which were removed from the installation. @@ -129379,9 +132037,9 @@ webhooks: - name - full_name - private - repository: *709 - repository_selection: *729 - requester: *726 + repository: *708 + repository_selection: *728 + requester: *725 sender: *4 required: - action @@ -129460,11 +132118,11 @@ webhooks: type: string enum: - suspend - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129646,10 +132304,10 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 target_type: type: string @@ -129728,11 +132386,11 @@ webhooks: type: string enum: - unsuspend - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -129898,7 +132556,7 @@ webhooks: pin: anyOf: - type: 'null' - - *544 + - *543 user: title: User type: @@ -129984,8 +132642,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -130797,8 +133455,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -130815,7 +133473,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -131159,8 +133817,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -131240,7 +133898,7 @@ webhooks: type: string enum: - deleted - comment: &730 + comment: &729 title: issue comment description: The [comment](https://docs.github.com/rest/issues/comments#get-an-issue-comment) itself. @@ -131397,7 +134055,7 @@ webhooks: pin: anyOf: - type: 'null' - - *544 + - *543 required: - url - html_url @@ -131411,8 +134069,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -132220,8 +134878,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -132238,7 +134896,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -132584,8 +135242,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -132665,7 +135323,7 @@ webhooks: type: string enum: - edited - changes: &754 + changes: &753 description: The changes to the comment. type: object properties: @@ -132677,9 +135335,9 @@ webhooks: type: string required: - from - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -133490,8 +136148,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -133508,7 +136166,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -133852,8 +136510,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -133934,9 +136592,9 @@ webhooks: type: string enum: - pinned - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -134749,8 +137407,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -134767,7 +137425,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -135113,8 +137771,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -135194,9 +137852,9 @@ webhooks: type: string enum: - unpinned - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -136009,8 +138667,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -136027,7 +138685,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -136373,8 +139031,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136463,9 +139121,9 @@ webhooks: type: number blocking_issue: *81 blocking_issue_repo: *77 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136554,9 +139212,9 @@ webhooks: type: number blocking_issue: *81 blocking_issue_repo: *77 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136644,9 +139302,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136735,9 +139393,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136817,10 +139475,10 @@ webhooks: type: string enum: - assigned - assignee: *726 - enterprise: *706 - installation: *707 - issue: &733 + assignee: *725 + enterprise: *705 + installation: *706 + issue: &732 title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -137631,11 +140289,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -137652,7 +140310,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -137755,8 +140413,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137836,8 +140494,8 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -138653,11 +141311,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -138674,7 +141332,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -138920,8 +141578,8 @@ webhooks: required: - state - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -139000,8 +141658,8 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -139808,11 +142466,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -139829,7 +142487,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -139931,8 +142589,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -140011,8 +142669,8 @@ webhooks: type: string enum: - demilestoned - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -140842,11 +143500,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -140863,7 +143521,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -140944,7 +143602,7 @@ webhooks: format: uri user_view_type: type: string - milestone: &731 + milestone: &730 title: Milestone description: A collection of related issues and pull requests. type: object @@ -141087,8 +143745,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -141187,8 +143845,8 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -141999,11 +144657,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -142017,7 +144675,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -142123,9 +144781,9 @@ webhooks: - active_lock_reason - body - reactions - label: *725 - organization: *708 - repository: *709 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -142205,8 +144863,8 @@ webhooks: type: string enum: - labeled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -143016,11 +145674,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -143034,7 +145692,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -143140,9 +145798,9 @@ webhooks: - active_lock_reason - body - reactions - label: *725 - organization: *708 - repository: *709 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -143222,8 +145880,8 @@ webhooks: type: string enum: - locked - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -144058,11 +146716,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -144076,7 +146734,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -144159,8 +146817,8 @@ webhooks: format: uri user_view_type: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -144239,8 +146897,8 @@ webhooks: type: string enum: - milestoned - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -145069,11 +147727,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -145090,7 +147748,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -145170,9 +147828,9 @@ webhooks: format: uri user_view_type: type: string - milestone: *731 - organization: *708 - repository: *709 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -146059,11 +148717,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -146163,7 +148821,7 @@ webhooks: required: - login - id - type: *230 + type: *229 required: - id - number @@ -146655,8 +149313,8 @@ webhooks: required: - old_issue - old_repository - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -147463,11 +150121,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -147484,7 +150142,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -147590,8 +150248,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -147671,9 +150329,9 @@ webhooks: type: string enum: - pinned - enterprise: *706 - installation: *707 - issue: &732 + enterprise: *705 + installation: *706 + issue: &731 title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -148478,11 +151136,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -148499,7 +151157,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -148601,8 +151259,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -148681,8 +151339,8 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -149515,11 +152173,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -149616,9 +152274,9 @@ webhooks: format: uri user_view_type: type: string - type: *230 - organization: *708 - repository: *709 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -150506,11 +153164,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -150527,7 +153185,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -151120,11 +153778,11 @@ webhooks: required: - new_issue - new_repository - enterprise: *706 - installation: *707 - issue: *732 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *731 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151204,12 +153862,12 @@ webhooks: type: string enum: - typed - enterprise: *706 - installation: *707 - issue: *733 - type: *230 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151290,7 +153948,7 @@ webhooks: type: string enum: - unassigned - assignee: &757 + assignee: &756 title: User type: - object @@ -151362,11 +154020,11 @@ webhooks: required: - login - id - enterprise: *706 - installation: *707 - issue: *733 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151445,12 +154103,12 @@ webhooks: type: string enum: - unlabeled - enterprise: *706 - installation: *707 - issue: *733 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151530,8 +154188,8 @@ webhooks: type: string enum: - unlocked - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -152364,11 +155022,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -152385,7 +155043,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -152465,8 +155123,8 @@ webhooks: format: uri user_view_type: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152546,11 +155204,11 @@ webhooks: type: string enum: - unpinned - enterprise: *706 - installation: *707 - issue: *732 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *731 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152629,12 +155287,12 @@ webhooks: type: string enum: - untyped - enterprise: *706 - installation: *707 - issue: *733 - type: *230 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152714,11 +155372,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152796,11 +155454,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152910,11 +155568,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152996,9 +155654,9 @@ webhooks: - cancelled effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: &734 + enterprise: *705 + installation: *706 + marketplace_purchase: &733 title: Marketplace Purchase type: object required: @@ -153086,8 +155744,8 @@ webhooks: type: integer unit_count: type: integer - organization: *708 - previous_marketplace_purchase: &735 + organization: *707 + previous_marketplace_purchase: &734 title: Marketplace Purchase type: object properties: @@ -153171,7 +155829,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -153251,10 +155909,10 @@ webhooks: - changed effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -153342,7 +156000,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -153424,10 +156082,10 @@ webhooks: - pending_change effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -153513,7 +156171,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -153594,8 +156252,8 @@ webhooks: - pending_change_cancelled effective_date: type: string - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 marketplace_purchase: title: Marketplace Purchase type: object @@ -153681,9 +156339,9 @@ webhooks: type: integer unit_count: type: integer - organization: *708 - previous_marketplace_purchase: *735 - repository: *709 + organization: *707 + previous_marketplace_purchase: *734 + repository: *708 sender: *4 required: - action @@ -153763,12 +156421,12 @@ webhooks: - purchased effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 - previous_marketplace_purchase: *735 - repository: *709 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 + previous_marketplace_purchase: *734 + repository: *708 sender: *4 required: - action @@ -153870,11 +156528,11 @@ webhooks: type: string required: - to - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153976,11 +156634,11 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154059,11 +156717,11 @@ webhooks: type: string enum: - removed - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154141,11 +156799,11 @@ webhooks: type: string enum: - added - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 scope: description: The scope of the membership. Currently, can only be `team`. @@ -154223,7 +156881,7 @@ webhooks: required: - login - id - team: &736 + team: &735 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -154453,11 +157111,11 @@ webhooks: type: string enum: - removed - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 scope: description: The scope of the membership. Currently, can only be `team`. @@ -154536,7 +157194,7 @@ webhooks: required: - login - id - team: *736 + team: *735 required: - action - scope @@ -154618,8 +157276,8 @@ webhooks: type: string enum: - checks_requested - installation: *707 - merge_group: &737 + installation: *706 + merge_group: &736 type: object title: Merge Group description: A group of pull requests that the merge queue has grouped @@ -154638,15 +157296,15 @@ webhooks: description: The full ref of the branch the merge group will be merged into. type: string - head_commit: *406 + head_commit: *405 required: - head_sha - head_ref - base_sha - base_ref - head_commit - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154732,10 +157390,10 @@ webhooks: - merged - invalidated - dequeued - installation: *707 - merge_group: *737 - organization: *708 - repository: *709 + installation: *706 + merge_group: *736 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154808,7 +157466,7 @@ webhooks: type: string enum: - deleted - enterprise: *706 + enterprise: *705 hook: description: 'The deleted webhook. This will contain different keys based on the type of webhook it is: repository, organization, @@ -154917,12 +157575,12 @@ webhooks: hook_id: description: The id of the modified webhook. type: integer - installation: *707 - organization: *708 + installation: *706 + organization: *707 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -155002,11 +157660,11 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155085,9 +157743,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - milestone: &738 + enterprise: *705 + installation: *706 + milestone: &737 title: Milestone description: A collection of related issues and pull requests. type: object @@ -155229,8 +157887,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155309,11 +157967,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155423,11 +158081,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155507,11 +158165,11 @@ webhooks: type: string enum: - opened - enterprise: *706 - installation: *707 - milestone: *738 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *737 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155590,11 +158248,11 @@ webhooks: type: string enum: - blocked - blocked_user: *726 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + blocked_user: *725 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155673,11 +158331,11 @@ webhooks: type: string enum: - unblocked - blocked_user: *726 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + blocked_user: *725 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155756,9 +158414,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - membership: &739 + enterprise: *705 + installation: *706 + membership: &738 title: Membership description: The membership between the user and the organization. Not present when the action is `member_invited`. @@ -155868,8 +158526,8 @@ webhooks: - role - organization_url - user - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155947,11 +158605,11 @@ webhooks: type: string enum: - member_added - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156030,8 +158688,8 @@ webhooks: type: string enum: - member_invited - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 invitation: description: The invitation for the user or email if the action is `member_invited`. @@ -156153,10 +158811,10 @@ webhooks: - inviter - team_count - invitation_teams_url - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 - user: *726 + user: *725 required: - action - invitation @@ -156234,11 +158892,11 @@ webhooks: type: string enum: - member_removed - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156325,11 +158983,11 @@ webhooks: properties: from: type: string - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156406,9 +159064,9 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 package: description: Information about the package. type: object @@ -156931,7 +159589,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: &740 + items: &739 title: Ruby Gems metadata type: object properties: @@ -157028,7 +159686,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -157104,9 +159762,9 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 package: description: Information about the package. type: object @@ -157468,7 +160126,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *740 + items: *739 source_url: type: string format: uri @@ -157539,7 +160197,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -157719,12 +160377,12 @@ webhooks: - duration - created_at - updated_at - enterprise: *706 + enterprise: *705 id: type: integer - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - id @@ -157801,7 +160459,7 @@ webhooks: type: string enum: - approved - personal_access_token_request: &741 + personal_access_token_request: &740 title: Personal Access Token Request description: Details of a Personal Access Token Request. type: object @@ -157951,10 +160609,10 @@ webhooks: - token_expired - token_expires_at - token_last_used_at - enterprise: *706 - organization: *708 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158031,11 +160689,11 @@ webhooks: type: string enum: - cancelled - personal_access_token_request: *741 - enterprise: *706 - organization: *708 + personal_access_token_request: *740 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158111,11 +160769,11 @@ webhooks: type: string enum: - created - personal_access_token_request: *741 - enterprise: *706 - organization: *708 + personal_access_token_request: *740 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158190,11 +160848,11 @@ webhooks: type: string enum: - denied - personal_access_token_request: *741 - organization: *708 - enterprise: *706 + personal_access_token_request: *740 + organization: *707 + enterprise: *705 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -158299,7 +160957,7 @@ webhooks: id: description: Unique identifier of the webhook. type: integer - last_response: *742 + last_response: *741 name: description: The type of webhook. The only valid value is 'web'. type: string @@ -158331,8 +160989,8 @@ webhooks: hook_id: description: The ID of the webhook that triggered the ping. type: integer - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 zen: description: Random string of GitHub zen. @@ -158577,10 +161235,10 @@ webhooks: - from required: - note - enterprise: *706 - installation: *707 - organization: *708 - project_card: &743 + enterprise: *705 + installation: *706 + organization: *707 + project_card: &742 title: Project Card type: object properties: @@ -158703,7 +161361,7 @@ webhooks: - creator - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -158784,11 +161442,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project_card: *743 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_card: *742 + repository: *708 sender: *4 required: - action @@ -158868,9 +161526,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 project_card: title: Project Card type: object @@ -159000,7 +161658,7 @@ webhooks: repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -159094,11 +161752,11 @@ webhooks: - from required: - note - enterprise: *706 - installation: *707 - organization: *708 - project_card: *743 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_card: *742 + repository: *708 sender: *4 required: - action @@ -159192,9 +161850,9 @@ webhooks: - from required: - column_id - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 project_card: allOf: - title: Project Card @@ -159391,7 +162049,7 @@ webhooks: type: string required: - after_id - repository: *709 + repository: *708 sender: *4 required: - action @@ -159471,10 +162129,10 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - organization: *708 - project: &745 + enterprise: *705 + installation: *706 + organization: *707 + project: &744 title: Project type: object properties: @@ -159601,7 +162259,7 @@ webhooks: - creator - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -159681,10 +162339,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project_column: &744 + enterprise: *705 + installation: *706 + organization: *707 + project_column: &743 title: Project Column type: object properties: @@ -159724,7 +162382,7 @@ webhooks: - name - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -159803,14 +162461,14 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -159899,11 +162557,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 + repository: *708 sender: *4 required: - action @@ -159983,11 +162641,11 @@ webhooks: type: string enum: - moved - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 + repository: *708 sender: *4 required: - action @@ -160067,11 +162725,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -160151,14 +162809,14 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - project: *745 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -160259,11 +162917,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -160342,11 +163000,11 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -160427,9 +163085,9 @@ webhooks: type: string enum: - closed - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -160510,9 +163168,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -160593,9 +163251,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -160716,9 +163374,9 @@ webhooks: type: string to: type: string - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -160801,7 +163459,7 @@ webhooks: type: string enum: - archived - changes: &749 + changes: &748 type: object properties: archived_at: @@ -160817,9 +163475,9 @@ webhooks: - string - 'null' format: date-time - installation: *707 - organization: *708 - projects_v2_item: &746 + installation: *706 + organization: *707 + projects_v2_item: &745 title: Projects v2 Item description: An item belonging to a project type: object @@ -160837,7 +163495,7 @@ webhooks: type: string description: The node ID of the content represented by this item. - content_type: *269 + content_type: *268 creator: *4 created_at: type: string @@ -160959,9 +163617,9 @@ webhooks: - 'null' to: type: string - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161043,9 +163701,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161126,9 +163784,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161233,7 +163891,7 @@ webhooks: oneOf: - type: string - type: integer - - &747 + - &746 title: Projects v2 Single Select Option description: An option for a single select field type: object @@ -161257,7 +163915,7 @@ webhooks: required: - id - name - - &748 + - &747 title: Projects v2 Iteration Setting description: An iteration setting for an iteration field type: object @@ -161297,8 +163955,8 @@ webhooks: oneOf: - type: string - type: integer + - *746 - *747 - - *748 type: - 'null' - string @@ -161321,9 +163979,9 @@ webhooks: - 'null' required: - body - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161420,9 +164078,9 @@ webhooks: type: - string - 'null' - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161505,10 +164163,10 @@ webhooks: type: string enum: - restored - changes: *749 - installation: *707 - organization: *708 - projects_v2_item: *746 + changes: *748 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -161590,9 +164248,9 @@ webhooks: type: string enum: - reopened - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161673,9 +164331,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -161756,9 +164414,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -161904,9 +164562,9 @@ webhooks: - string - 'null' format: date - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -161977,10 +164635,10 @@ webhooks: title: public event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - repository @@ -162057,13 +164715,13 @@ webhooks: type: string enum: - assigned - assignee: *726 - enterprise: *706 - installation: *707 - number: &751 + assignee: *725 + enterprise: *705 + installation: *706 + number: &750 description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -164415,7 +167073,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -164497,11 +167155,11 @@ webhooks: type: string enum: - auto_merge_disabled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -166846,7 +169504,7 @@ webhooks: - draft reason: type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -166928,11 +169586,11 @@ webhooks: type: string enum: - auto_merge_enabled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -169277,7 +171935,7 @@ webhooks: - draft reason: type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -169359,13 +172017,13 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: &752 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: &751 allOf: - - *565 + - *564 - type: object properties: allow_auto_merge: @@ -169427,7 +172085,7 @@ webhooks: Please use `squash_merge_commit_title` instead.** type: boolean default: false - repository: *709 + repository: *708 sender: *4 required: - action @@ -169508,12 +172166,12 @@ webhooks: type: string enum: - converted_to_draft - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -169593,11 +172251,11 @@ webhooks: type: string enum: - demilestoned - enterprise: *706 - milestone: *266 - number: *751 - organization: *708 - pull_request: &753 + enterprise: *705 + milestone: *265 + number: *750 + organization: *707 + pull_request: &752 title: Pull Request type: object properties: @@ -171941,7 +174599,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -172020,11 +174678,11 @@ webhooks: type: string enum: - dequeued - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -174387,7 +177045,7 @@ webhooks: - BRANCH_PROTECTIONS - GIT_TREE_INVALID - INVALID_MERGE_COMMIT - repository: *709 + repository: *708 sender: *4 required: - action @@ -174511,12 +177169,12 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -174596,11 +177254,11 @@ webhooks: type: string enum: - enqueued - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -176948,7 +179606,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -177028,11 +179686,11 @@ webhooks: type: string enum: - labeled - enterprise: *706 - installation: *707 - label: *725 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + label: *724 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -179383,7 +182041,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -179464,10 +182122,10 @@ webhooks: type: string enum: - locked - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -181816,7 +184474,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -181896,12 +184554,12 @@ webhooks: type: string enum: - milestoned - enterprise: *706 - milestone: *266 - number: *751 - organization: *708 - pull_request: *753 - repository: *709 + enterprise: *705 + milestone: *265 + number: *750 + organization: *707 + pull_request: *752 + repository: *708 sender: *4 required: - action @@ -181980,12 +184638,12 @@ webhooks: type: string enum: - opened - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -182066,12 +184724,12 @@ webhooks: type: string enum: - ready_for_review - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -182151,12 +184809,12 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -182531,9 +185189,9 @@ webhooks: - start_side - side - reactions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -184766,7 +187424,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -184846,7 +187504,7 @@ webhooks: type: string enum: - deleted - comment: &755 + comment: &754 title: Pull Request Review Comment description: The [comment](https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request) itself. @@ -185139,9 +187797,9 @@ webhooks: - start_side - side - reactions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -187362,7 +190020,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -187442,11 +190100,11 @@ webhooks: type: string enum: - edited - changes: *754 - comment: *755 - enterprise: *706 - installation: *707 - organization: *708 + changes: *753 + comment: *754 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -189670,7 +192328,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -189751,9 +192409,9 @@ webhooks: type: string enum: - dismissed - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -191989,7 +194647,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 review: description: The review that was affected. type: object @@ -192240,9 +194898,9 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -194351,8 +197009,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 - review: &756 + repository: *708 + review: &755 description: The review that was affected. type: object properties: @@ -194590,12 +197248,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -196945,7 +199603,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_reviewer: title: User type: @@ -197031,12 +199689,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -199393,7 +202051,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_team: title: Team description: Groups of organization members that gives permissions @@ -199588,12 +202246,12 @@ webhooks: type: string enum: - review_requested - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -201945,7 +204603,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_reviewer: title: User type: @@ -202032,12 +204690,12 @@ webhooks: type: string enum: - review_requested - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -204380,7 +207038,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_team: title: Team description: Groups of organization members that gives permissions @@ -204564,9 +207222,9 @@ webhooks: type: string enum: - submitted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -206805,8 +209463,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 - review: *756 + repository: *708 + review: *755 sender: *4 required: - action @@ -206886,9 +209544,9 @@ webhooks: type: string enum: - resolved - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -209036,7 +211694,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 sender: *4 thread: type: object @@ -209433,9 +212091,9 @@ webhooks: type: string enum: - unresolved - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -211566,7 +214224,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 sender: *4 thread: type: object @@ -211965,10 +214623,10 @@ webhooks: type: string before: type: string - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -214306,7 +216964,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -214388,11 +217046,11 @@ webhooks: type: string enum: - unassigned - assignee: *757 - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + assignee: *756 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -216745,7 +219403,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -216824,11 +219482,11 @@ webhooks: type: string enum: - unlabeled - enterprise: *706 - installation: *707 - label: *725 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + label: *724 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -219170,7 +221828,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -219251,10 +221909,10 @@ webhooks: type: string enum: - unlocked - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -221586,7 +224244,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -221789,7 +224447,7 @@ webhooks: deleted: description: Whether this push deleted the `ref`. type: boolean - enterprise: *706 + enterprise: *705 forced: description: Whether this push was a force push of the `ref`. type: boolean @@ -221884,8 +224542,8 @@ webhooks: - url - author - committer - installation: *707 - organization: *708 + installation: *706 + organization: *707 pusher: title: Committer description: Metaproperties for Git author/committer information. @@ -222484,9 +225142,9 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 registry_package: type: object properties: @@ -222963,7 +225621,7 @@ webhooks: type: string rubygems_metadata: type: array - items: *740 + items: *739 summary: type: string tag_name: @@ -223019,7 +225677,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -223097,9 +225755,9 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 registry_package: type: object properties: @@ -223411,7 +226069,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *740 + items: *739 summary: type: string tag_name: @@ -223461,7 +226119,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -223538,10 +226196,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - release: &758 + enterprise: *705 + installation: *706 + organization: *707 + release: &757 title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) object. @@ -223872,7 +226530,7 @@ webhooks: - updated_at - zipball_url - body - repository: *709 + repository: *708 sender: *4 required: - action @@ -223949,11 +226607,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -224070,11 +226728,11 @@ webhooks: type: boolean required: - to - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -224152,9 +226810,9 @@ webhooks: type: string enum: - prereleased - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 release: title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) @@ -224490,7 +227148,7 @@ webhooks: - string - 'null' format: uri - repository: *709 + repository: *708 sender: *4 required: - action @@ -224566,10 +227224,10 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - release: &759 + enterprise: *705 + installation: *706 + organization: *707 + release: &758 title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) object. @@ -224902,7 +227560,7 @@ webhooks: - string - 'null' format: uri - repository: *709 + repository: *708 sender: *4 required: - action @@ -224978,11 +227636,11 @@ webhooks: type: string enum: - released - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -225058,11 +227716,11 @@ webhooks: type: string enum: - unpublished - enterprise: *706 - installation: *707 - organization: *708 - release: *759 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *758 + repository: *708 sender: *4 required: - action @@ -225138,11 +227796,11 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_advisory: *629 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_advisory: *628 sender: *4 required: - action @@ -225218,11 +227876,11 @@ webhooks: type: string enum: - reported - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_advisory: *629 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_advisory: *628 sender: *4 required: - action @@ -225298,10 +227956,10 @@ webhooks: type: string enum: - archived - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -225378,10 +228036,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -225459,10 +228117,10 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -225547,10 +228205,10 @@ webhooks: additionalProperties: true description: The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body. - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -225665,10 +228323,10 @@ webhooks: - 'null' items: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -225740,10 +228398,10 @@ webhooks: title: repository_import event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 status: type: string @@ -225824,10 +228482,10 @@ webhooks: type: string enum: - privatized - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -225904,10 +228562,10 @@ webhooks: type: string enum: - publicized - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226001,10 +228659,10 @@ webhooks: - name required: - repository - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226084,11 +228742,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 sender: *4 required: - action @@ -226166,11 +228824,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 sender: *4 required: - action @@ -226248,11 +228906,11 @@ webhooks: type: string enum: - edited - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 changes: type: object properties: @@ -226271,16 +228929,16 @@ webhooks: properties: added: type: array - items: *282 + items: *281 deleted: type: array - items: *282 + items: *281 updated: type: array items: type: object properties: - condition: *282 + condition: *281 changes: type: object properties: @@ -226313,16 +228971,16 @@ webhooks: properties: added: type: array - items: *585 + items: *584 deleted: type: array - items: *585 + items: *584 updated: type: array items: type: object properties: - rule: *585 + rule: *584 changes: type: object properties: @@ -226559,10 +229217,10 @@ webhooks: - from required: - owner - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226640,10 +229298,10 @@ webhooks: type: string enum: - unarchived - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -226721,7 +229379,7 @@ webhooks: type: string enum: - create - alert: &760 + alert: &759 title: Repository Vulnerability Alert Alert description: The security alert of the vulnerable dependency. type: object @@ -226846,10 +229504,10 @@ webhooks: enum: - auto_dismissed - open - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227059,10 +229717,10 @@ webhooks: type: string enum: - dismissed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227140,11 +229798,11 @@ webhooks: type: string enum: - reopen - alert: *760 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *759 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227346,10 +230004,10 @@ webhooks: enum: - fixed - open - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227427,17 +230085,17 @@ webhooks: type: string enum: - assigned - alert: &761 + alert: &760 type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri @@ -227542,10 +230200,10 @@ webhooks: - type: 'null' - *4 assignee: *4 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227623,11 +230281,11 @@ webhooks: type: string enum: - created - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227708,11 +230366,11 @@ webhooks: type: string enum: - created - alert: *761 - installation: *707 - location: *762 - organization: *708 - repository: *709 + alert: *760 + installation: *706 + location: *761 + organization: *707 + repository: *708 sender: *4 required: - location @@ -227950,11 +230608,11 @@ webhooks: type: string enum: - publicly_leaked - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228032,11 +230690,11 @@ webhooks: type: string enum: - reopened - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228114,11 +230772,11 @@ webhooks: type: string enum: - resolved - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228196,12 +230854,12 @@ webhooks: type: string enum: - unassigned - alert: *761 + alert: *760 assignee: *4 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228279,11 +230937,11 @@ webhooks: type: string enum: - validated - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228413,10 +231071,10 @@ webhooks: - organization - enterprise - - repository: *709 - enterprise: *706 - installation: *707 - organization: *708 + repository: *708 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -228494,11 +231152,11 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - security_advisory: &763 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + security_advisory: &762 description: The details of the security advisory, including summary, description, and severity. type: object @@ -228671,11 +231329,11 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - security_advisory: *763 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + security_advisory: *762 sender: *4 required: - action @@ -228748,10 +231406,10 @@ webhooks: type: string enum: - withdrawn - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 security_advisory: description: The details of the security advisory, including summary, description, and severity. @@ -228924,11 +231582,11 @@ webhooks: from: type: object properties: - security_and_analysis: *281 - enterprise: *706 - installation: *707 - organization: *708 - repository: *328 + security_and_analysis: *280 + enterprise: *705 + installation: *706 + organization: *707 + repository: *327 sender: *4 required: - changes @@ -229006,12 +231664,12 @@ webhooks: type: string enum: - cancelled - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: &764 + sponsorship: &763 type: object properties: created_at: @@ -229316,12 +231974,12 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - sponsorship @@ -229409,12 +232067,12 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -229491,17 +232149,17 @@ webhooks: type: string enum: - pending_cancellation - effective_date: &765 + effective_date: &764 description: The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - sponsorship @@ -229575,7 +232233,7 @@ webhooks: type: string enum: - pending_tier_change - changes: &766 + changes: &765 type: object properties: tier: @@ -229619,13 +232277,13 @@ webhooks: - from required: - tier - effective_date: *765 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + effective_date: *764 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -229702,13 +232360,13 @@ webhooks: type: string enum: - tier_changed - changes: *766 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + changes: *765 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -229782,10 +232440,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -229869,10 +232527,10 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -230306,15 +232964,15 @@ webhooks: type: - string - 'null' - enterprise: *706 + enterprise: *705 id: description: The unique identifier of the status. type: integer - installation: *707 + installation: *706 name: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 sha: description: The Commit SHA. @@ -230430,9 +233088,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230522,9 +233180,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230614,9 +233272,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230706,9 +233364,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230785,12 +233443,12 @@ webhooks: title: team_add event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - team: &767 + team: &766 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -231020,9 +233678,9 @@ webhooks: type: string enum: - added_to_repository - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -231492,7 +234150,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -231568,9 +234226,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -232040,7 +234698,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -232117,9 +234775,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -232589,7 +235247,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -232733,9 +235391,9 @@ webhooks: - from required: - permissions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -233205,7 +235863,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - changes @@ -233283,9 +235941,9 @@ webhooks: type: string enum: - removed_from_repository - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -233755,7 +236413,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -233831,10 +236489,10 @@ webhooks: type: string enum: - started - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -233907,17 +236565,17 @@ webhooks: title: workflow_dispatch event type: object properties: - enterprise: *706 + enterprise: *705 inputs: type: - object - 'null' additionalProperties: true - installation: *707 - organization: *708 + installation: *706 + organization: *707 ref: type: string - repository: *709 + repository: *708 sender: *4 workflow: type: string @@ -233999,10 +236657,10 @@ webhooks: type: string enum: - completed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: allOf: @@ -234258,7 +236916,7 @@ webhooks: type: string required: - conclusion - deployment: *481 + deployment: *480 required: - action - repository @@ -234337,10 +236995,10 @@ webhooks: type: string enum: - in_progress - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: allOf: @@ -234622,7 +237280,7 @@ webhooks: required: - status - steps - deployment: *481 + deployment: *480 required: - action - repository @@ -234701,10 +237359,10 @@ webhooks: type: string enum: - queued - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: type: object @@ -234850,7 +237508,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *481 + deployment: *480 required: - action - repository @@ -234929,10 +237587,10 @@ webhooks: type: string enum: - waiting - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: type: object @@ -235079,7 +237737,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *481 + deployment: *480 required: - action - repository @@ -235159,12 +237817,12 @@ webhooks: type: string enum: - completed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object @@ -236183,12 +238841,12 @@ webhooks: type: string enum: - in_progress - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object @@ -237192,12 +239850,12 @@ webhooks: type: string enum: - requested - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json index 10468a718a..996e6d212d 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.json @@ -195,6 +195,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -1431,12 +1435,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -2330,6 +2332,3298 @@ } } }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks": { + "get": { + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks/{task_id}": { + "get": { + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, "/app": { "get": { "summary": "Get the authenticated app", @@ -25150,6 +28444,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -26699,12 +29994,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -92603,10 +95896,7 @@ "type": "string" } } - }, - "required": [ - "include_claim_keys" - ] + } }, "examples": { "default": { @@ -108631,6 +111921,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -108734,8 +112029,347 @@ } } } + }, + "required": [ + "total_count" + ] + }, + "examples": { + "default": { + "value": { + "total_count": 1, + "deployment_records": [ + { + "id": 123, + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "logical_environment": "prod", + "physical_environment": "pacific-east", + "cluster": "moda-1", + "deployment_name": "prod-deployment", + "tags": { + "data": "sensitive" + }, + "created": "2011-01-26T19:14:43Z", + "updated_at": "2011-01-26T19:14:43Z", + "attestation_id": 456 + } + ] + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "artifact-metadata" + } + } + }, + "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { + "post": { + "summary": "Set cluster deployment records", + "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", + "tags": [ + "orgs" + ], + "operationId": "orgs/set-cluster-deployment-records", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "cluster", + "in": "path", + "description": "The cluster name.", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 128, + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "logical_environment": { + "type": "string", + "description": "The stage of the deployment.", + "minLength": 1, + "maxLength": 128 + }, + "physical_environment": { + "type": "string", + "description": "The physical region of the deployment.", + "maxLength": 128 + }, + "deployments": { + "type": "array", + "description": "The list of deployments to record.", + "maxItems": 1000, + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", + "minLength": 1, + "maxLength": 256 + }, + "digest": { + "type": "string", + "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", + "minLength": 71, + "maxLength": 71, + "pattern": "^sha256:[a-f0-9]{64}$" + }, + "version": { + "type": "string", + "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", + "maxLength": 100, + "x-multi-segment": true, + "examples": [ + "1.2.3" + ] + }, + "status": { + "type": "string", + "description": "The deployment status of the artifact.", + "default": "deployed", + "enum": [ + "deployed", + "decommissioned" + ] + }, + "deployment_name": { + "type": "string", + "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", + "minLength": 1, + "maxLength": 256 + }, + "github_repository": { + "type": "string", + "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", + "maxLength": 100, + "pattern": "^[A-Za-z0-9.\\-_]+$", + "examples": [ + "my-github-repo" + ] + }, + "tags": { + "type": "object", + "description": "Key-value pairs to tag the deployment record.", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + } + }, + "required": [ + "name", + "deployment_name", + "digest" + ] + } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, + "required": [ + "logical_environment", + "deployments" + ] + }, + "examples": { + "default": { + "value": { + "logical_environment": "prod", + "physical_environment": "pacific-east", + "deployments": [ + { + "name": "awesome-image", + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "version": "2.1.0", + "status": "deployed", + "deployment_name": "deployment-pod", + "tags": { + "runtime-risk": "sensitive-data" + } + } + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Deployment records created or updated successfully.\n", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "total_count": { + "description": "The number of deployment records created", + "type": "integer" + }, + "deployment_records": { + "type": "array", + "items": { + "title": "Artifact Deployment Record", + "description": "Artifact Metadata Deployment Record", + "type": "object", + "properties": { + "id": { + "type": "integer" + }, + "digest": { + "type": "string" + }, + "logical_environment": { + "type": "string" + }, + "physical_environment": { + "type": "string" + }, + "cluster": { + "type": "string" + }, + "deployment_name": { + "type": "string" + }, + "tags": { + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + }, + "created_at": { + "type": "string" + }, + "updated_at": { + "type": "string" + }, + "attestation_id": { + "type": [ + "integer", + "null" + ], + "description": "The ID of the provenance attestation associated with the deployment record." + } + } + } + } + }, + "required": [ + "total_count" + ] + }, "examples": { "default": { "value": { @@ -108784,332 +112418,17 @@ "type": "string" } } - } - } - } - }, - "404": { - "description": "Resource not found", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "artifact-metadata" - } - } - }, - "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { - "post": { - "summary": "Set cluster deployment records", - "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", - "tags": [ - "orgs" - ], - "operationId": "orgs/set-cluster-deployment-records", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/artifact-metadata#set-cluster-deployment-records" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "cluster", - "in": "path", - "description": "The cluster name.", - "required": true, - "schema": { - "type": "string", - "minLength": 1, - "maxLength": 128, - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "logical_environment": { - "type": "string", - "description": "The stage of the deployment.", - "minLength": 1, - "maxLength": 128 - }, - "physical_environment": { - "type": "string", - "description": "The physical region of the deployment.", - "maxLength": 128 - }, - "deployments": { - "type": "array", - "description": "The list of deployments to record.", - "maxItems": 1000, - "items": { - "type": "object", - "properties": { - "name": { - "type": "string", - "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", - "minLength": 1, - "maxLength": 256 - }, - "digest": { - "type": "string", - "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", - "minLength": 71, - "maxLength": 71, - "pattern": "^sha256:[a-f0-9]{64}$" - }, - "version": { - "type": "string", - "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", - "maxLength": 100, - "x-multi-segment": true, - "examples": [ - "1.2.3" - ] - }, - "status": { - "type": "string", - "description": "The deployment status of the artifact.", - "default": "deployed", - "enum": [ - "deployed", - "decommissioned" - ] - }, - "deployment_name": { - "type": "string", - "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", - "minLength": 1, - "maxLength": 256 - }, - "github_repository": { - "type": "string", - "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", - "maxLength": 100, - "pattern": "^[A-Za-z0-9.\\-_]+$", - "examples": [ - "my-github-repo" - ] - }, - "tags": { - "type": "object", - "description": "Key-value pairs to tag the deployment record.", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - } - }, - "required": [ - "name", - "deployment_name", - "digest" - ] - } - } - }, - "required": [ - "logical_environment", - "deployments" - ] - }, - "examples": { - "default": { - "value": { - "logical_environment": "prod", - "physical_environment": "pacific-east", - "deployments": [ - { - "name": "awesome-image", - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "version": "2.1.0", - "status": "deployed", - "deployment_name": "deployment-pod", - "tags": { - "runtime-risk": "sensitive-data" - } - } - ] - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Deployment records created or updated successfully.\n", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "total_count": { - "description": "The number of deployment records created", - "type": "integer" - }, - "deployment_records": { - "type": "array", - "items": { - "title": "Artifact Deployment Record", - "description": "Artifact Metadata Deployment Record", - "type": "object", - "properties": { - "id": { - "type": "integer" - }, - "digest": { - "type": "string" - }, - "logical_environment": { - "type": "string" - }, - "physical_environment": { - "type": "string" - }, - "cluster": { - "type": "string" - }, - "deployment_name": { - "type": "string" - }, - "tags": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - }, - "created_at": { - "type": "string" - }, - "updated_at": { - "type": "string" - }, - "attestation_id": { - "type": [ - "integer", - "null" - ], - "description": "The ID of the provenance attestation associated with the deployment record." - } - } - } - } - } }, "examples": { - "default": { + "insufficient_repo_permissions": { "value": { - "total_count": 1, - "deployment_records": [ - { - "id": 123, - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "logical_environment": "prod", - "physical_environment": "pacific-east", - "cluster": "moda-1", - "deployment_name": "prod-deployment", - "tags": { - "data": "sensitive" - }, - "created": "2011-01-26T19:14:43Z", - "updated_at": "2011-01-26T19:14:43Z", - "attestation_id": 456 - } - ] - } - } - } - } - } - }, - "403": { - "description": "Forbidden", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } } } } @@ -109266,6 +112585,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -109345,7 +112669,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -132494,6 +135821,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -134043,12 +137371,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -181469,7 +184795,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -182260,7 +185586,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -244995,6 +248321,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -245088,6 +248422,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -245105,6 +248447,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -245122,6 +248472,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -245190,6 +248548,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -245207,6 +248573,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -245224,6 +248598,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -245241,6 +248623,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -245258,6 +248648,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -250961,338 +254359,364 @@ }, "network_settings_ids": { "type": "array", - "minItems": 1, + "minItems": 1, + "maxItems": 1, + "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." + } + }, + "required": [ + "name", + "network_settings_ids" + ] + }, + "examples": { + "default": { + "value": { + "name": "my-network-configuration", + "network_settings_ids": [ + "23456789ABDCEF1" + ], + "compute_service": "actions" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "network-configurations" + } + } + }, + "/orgs/{org}/settings/network-configurations/{network_configuration_id}": { + "get": { + "summary": "Get a hosted compute network configuration for an organization", + "description": "Gets a hosted compute network configuration configured in an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `read:network_configurations` scope to use this endpoint.", + "tags": [ + "hosted-compute" + ], + "operationId": "hosted-compute/get-network-configuration-for-org", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + }, + "headers": { + "Link": { + "example": "; rel=\"next\", ; rel=\"last\"", + "schema": { + "type": "string" + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "network-configurations" + } + }, + "patch": { + "summary": "Update a hosted compute network configuration for an organization", + "description": "Updates a hosted compute network configuration for an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `write:network_configurations` scope to use this endpoint.", + "tags": [ + "hosted-compute" + ], + "operationId": "hosted-compute/update-network-configuration-for-org", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.", + "type": "string" + }, + "compute_service": { + "description": "The hosted compute service to use for the network configuration.", + "type": "string", + "enum": [ + "none", + "actions" + ] + }, + "network_settings_ids": { + "type": "array", + "minItems": 0, "maxItems": 1, "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } - } - }, - "required": [ - "name", - "network_settings_ids" - ] - }, - "examples": { - "default": { - "value": { - "name": "my-network-configuration", - "network_settings_ids": [ - "23456789ABDCEF1" - ], - "compute_service": "actions" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "network-configurations" - } - } - }, - "/orgs/{org}/settings/network-configurations/{network_configuration_id}": { - "get": { - "summary": "Get a hosted compute network configuration for an organization", - "description": "Gets a hosted compute network configuration configured in an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `read:network_configurations` scope to use this endpoint.", - "tags": [ - "hosted-compute" - ], - "operationId": "hosted-compute/get-network-configuration-for-org", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } - }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - }, - "headers": { - "Link": { - "example": "; rel=\"next\", ; rel=\"last\"", - "schema": { - "type": "string" - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "network-configurations" - } - }, - "patch": { - "summary": "Update a hosted compute network configuration for an organization", - "description": "Updates a hosted compute network configuration for an organization.\n\nOAuth app tokens and personal access tokens (classic) need the `write:network_configurations` scope to use this endpoint.", - "tags": [ - "hosted-compute" - ], - "operationId": "hosted-compute/update-network-configuration-for-org", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "name": { - "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, '.', '-', and '_'.", - "type": "string" - }, - "compute_service": { - "description": "The hosted compute service to use for the network configuration.", - "type": "string", - "enum": [ - "none", - "actions" - ] - }, - "network_settings_ids": { + "failover_network_settings_ids": { "type": "array", "minItems": 0, "maxItems": 1, - "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -386870,6 +390294,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -387867,12 +391292,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -388384,6 +391807,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -389390,12 +392814,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", @@ -389727,6 +393149,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -635218,6 +638641,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -635311,6 +638742,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -635328,6 +638767,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -635345,6 +638792,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -635413,6 +638868,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -635430,6 +638893,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -635447,6 +638918,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -635464,6 +638943,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -635481,6 +638968,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -636629,6 +640124,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -636722,6 +640225,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -636739,6 +640250,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -636756,6 +640275,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -636824,6 +640351,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -636841,6 +640376,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -636858,6 +640401,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -636875,6 +640426,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -636892,6 +640451,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -638023,6 +641590,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -638116,6 +641691,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -638133,6 +641716,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -638150,6 +641741,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -638218,6 +641817,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -638235,6 +641842,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -638252,6 +641867,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -638269,6 +641892,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -638286,6 +641917,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -638731,6 +642370,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -638824,6 +642471,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -638841,6 +642496,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -638858,6 +642521,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -638926,6 +642597,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -638943,6 +642622,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -638960,6 +642647,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -638977,6 +642672,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -638994,6 +642697,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -940575,6 +944286,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -943609,6 +947321,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -946643,6 +950356,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -949677,6 +953391,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -952711,6 +956426,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -955745,6 +959461,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -958779,6 +962496,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -961813,6 +965531,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1599571,6 +1603290,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -1599664,6 +1603391,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1599681,6 +1603416,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1599698,6 +1603441,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -1599766,6 +1603517,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1599783,6 +1603542,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1599800,6 +1603567,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -1599817,6 +1603592,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -1599834,6 +1603617,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ diff --git a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml index 30ab358181..d578f5de35 100644 --- a/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml +++ b/descriptions-next/api.github.com/dereferenced/api.github.com.deref.yaml @@ -103,6 +103,8 @@ tags: description: Endpoints to manage campaigns via the REST API. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -929,7 +931,7 @@ paths: - subscriptions_url - type - url - type: &314 + type: &313 type: string description: The type of credit the user is receiving. enum: @@ -1045,7 +1047,7 @@ paths: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -1122,7 +1124,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/global-advisories#get-a-global-security-advisory parameters: - - &631 + - &630 name: ghsa_id description: The GHSA (GitHub Security Advisory) identifier of the advisory. in: path @@ -1212,6 +1214,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -1707,7 +4224,7 @@ paths: schema: type: integer default: 30 - - &204 + - &203 name: cursor description: 'Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the `link` header for the next and previous @@ -1716,7 +4233,7 @@ paths: required: false schema: type: string - - &205 + - &204 name: status description: Returns webhook deliveries filtered by delivery outcome classification based on `status_code` range. A `status` of `success` returns deliveries @@ -1736,7 +4253,7 @@ paths: application/json: schema: type: array - items: &206 + items: &205 title: Simple webhook delivery description: Delivery made by a webhook, without request and response information. @@ -1832,7 +4349,7 @@ paths: - installation_id - repository_id examples: - default: &207 + default: &206 value: - id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -1967,7 +4484,7 @@ paths: description: Response content: application/json: - schema: &208 + schema: &207 title: Webhook delivery description: Delivery made by a webhook. type: object @@ -2102,7 +4619,7 @@ paths: - request - response examples: - default: &209 + default: &208 value: id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -8471,7 +10988,7 @@ paths: description: Response content: application/json: - schema: &182 + schema: &181 type: array description: A list of default code security configurations items: @@ -8487,7 +11004,7 @@ paths: default configuration: *47 examples: - default: &183 + default: &182 value: - default_for_new_repos: public configuration: @@ -8827,7 +11344,7 @@ paths: - *38 - *49 responses: - '204': &184 + '204': &183 description: A header with no content is returned. '400': *14 '403': *27 @@ -8954,7 +11471,7 @@ paths: default: value: default_for_new_repos: all - configuration: &181 + configuration: &180 value: id: 1325 target_type: organization @@ -9039,7 +11556,7 @@ paths: application/json: schema: type: array - items: &185 + items: &184 type: object description: Repositories associated with a code security configuration and attachment status @@ -9384,7 +11901,7 @@ paths: summary: Example of code security configuration repositories value: - status: attached - repository: &186 + repository: &185 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -9685,7 +12202,7 @@ paths: url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-an-enterprise parameters: - *38 - - &190 + - &189 name: state in: query description: |- @@ -9694,7 +12211,7 @@ paths: Can be: `auto_dismissed`, `dismissed`, `fixed`, `open` schema: type: string - - &191 + - &190 name: severity in: query description: |- @@ -9703,7 +12220,7 @@ paths: Can be: `low`, `medium`, `high`, `critical` schema: type: string - - &192 + - &191 name: ecosystem in: query description: |- @@ -9712,14 +12229,14 @@ paths: Can be: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust` schema: type: string - - &193 + - &192 name: package in: query description: A comma-separated list of package names. If specified, only alerts for these packages will be returned. schema: type: string - - &194 + - &193 name: epss_percentage in: query description: |- @@ -9731,7 +12248,7 @@ paths: Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. schema: type: string - - &471 + - &470 name: has in: query description: |- @@ -9745,7 +12262,7 @@ paths: type: string enum: - patch - - &195 + - &194 name: assignee in: query description: |- @@ -9754,7 +12271,7 @@ paths: Use `*` to list alerts with at least one assignee or `none` to list alerts with no assignees. schema: type: string - - &196 + - &195 name: scope in: query description: The scope of the vulnerable dependency. If specified, only alerts @@ -9764,7 +12281,7 @@ paths: enum: - development - runtime - - &197 + - &196 name: sort in: query description: |- @@ -9790,11 +12307,11 @@ paths: application/json: schema: type: array - items: &198 + items: &197 type: object description: A Dependabot alert. properties: - number: &171 + number: &170 type: integer description: The security alert number. readOnly: true @@ -9859,8 +12376,9 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: &472 + security_advisory: &471 type: object description: Details for the GitHub Security Advisory. readOnly: true @@ -10086,29 +12604,29 @@ paths: - withdrawn_at version: '2026-03-10' security_vulnerability: *63 - url: &174 + url: &173 type: string description: The REST API URL of the alert resource. format: uri readOnly: true - html_url: &175 + html_url: &174 type: string description: The GitHub URL of the alert resource. format: uri readOnly: true - created_at: &172 + created_at: &171 type: string description: 'The time that the alert was created in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - updated_at: &173 + updated_at: &172 type: string description: 'The time that the alert was last updated in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissed_at: &177 + dismissed_at: &176 type: - string - 'null' @@ -10139,7 +12657,7 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: &176 + fixed_at: &175 type: - string - 'null' @@ -10147,7 +12665,7 @@ paths: and was considered fixed in ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - auto_dismissed_at: &473 + auto_dismissed_at: &472 type: - string - 'null' @@ -10155,7 +12673,7 @@ paths: ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissal_request: &474 + dismissal_request: &473 title: Dependabot alert dismissal request description: Information about an active dismissal request for this Dependabot alert. @@ -10218,7 +12736,7 @@ paths: - repository additionalProperties: false examples: - default: &199 + default: &198 value: - number: 2 state: dismissed @@ -10267,7 +12785,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -11582,7 +14100,7 @@ paths: properties: action: type: string - discussion: &722 + discussion: &721 title: Discussion description: A Discussion in a repository. type: object @@ -12083,7 +14601,7 @@ paths: milestone: anyOf: - type: 'null' - - &266 + - &265 title: Milestone description: A collection of related issues and pull requests. @@ -12255,7 +14773,7 @@ paths: timeline_url: type: string format: uri - type: &230 + type: &229 title: Issue Type description: The type of issue. type: @@ -12366,7 +14884,7 @@ paths: - hooray - eyes - rocket - sub_issues_summary: &643 + sub_issues_summary: &642 title: Sub-issues Summary type: object properties: @@ -12450,7 +14968,7 @@ paths: pin: anyOf: - type: 'null' - - &544 + - &543 title: Pinned Issue Comment description: Context around who pinned an issue comment and when it was pinned. @@ -12477,7 +14995,7 @@ paths: - url - created_at - updated_at - issue_dependencies_summary: &644 + issue_dependencies_summary: &643 title: Issue Dependencies Summary type: object properties: @@ -12496,7 +15014,7 @@ paths: - total_blocking issue_field_values: type: array - items: &529 + items: &528 title: Issue Field Value description: A value assigned to an issue field type: object @@ -13320,7 +15838,7 @@ paths: type: string release: allOf: - - &576 + - &575 title: Release description: A release. type: object @@ -13402,7 +15920,7 @@ paths: author: *4 assets: type: array - items: &577 + items: &576 title: Release Asset description: Data related to a release. type: object @@ -14034,7 +16552,7 @@ paths: url: type: string format: uri - user: &650 + user: &649 title: Public User description: Public User type: object @@ -15939,7 +18457,7 @@ paths: - closed - all default: open - - &233 + - &232 name: labels description: 'A list of comma separated label names. Example: `bug,ui,@high`' in: query @@ -15990,7 +18508,7 @@ paths: type: array items: *81 examples: - default: &234 + default: &233 value: - id: 1 node_id: MDU6SXNzdWUx @@ -17402,14 +19920,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/events#list-public-events-for-a-network-of-repositories parameters: - - &325 + - &324 name: owner description: The account owner of the repository. The name is not case sensitive. in: path required: true schema: type: string - - &326 + - &325 name: repo description: The name of the repository without the `.git` extension. The name is not case sensitive. @@ -17471,7 +19989,7 @@ paths: '404': *6 '403': *27 '304': *35 - '301': &329 + '301': &328 description: Moved permanently content: application/json: @@ -17493,7 +20011,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#list-notifications-for-the-authenticated-user parameters: - - &552 + - &551 name: all description: If `true`, show notifications marked as read. in: query @@ -17501,7 +20019,7 @@ paths: schema: type: boolean default: false - - &553 + - &552 name: participating description: If `true`, only shows notifications in which the user is directly participating or mentioned. @@ -17511,7 +20029,7 @@ paths: type: boolean default: false - *86 - - &554 + - &553 name: before description: 'Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: @@ -17543,7 +20061,7 @@ paths: properties: id: type: string - repository: &153 + repository: &152 title: Minimal Repository description: Minimal Repository type: object @@ -17893,7 +20411,7 @@ paths: type: boolean examples: - false - security_and_analysis: &281 + security_and_analysis: &280 type: - object - 'null' @@ -18103,7 +20621,7 @@ paths: - url - subscription_url examples: - default: &555 + default: &554 value: - id: '1' repository: @@ -19673,7 +22191,7 @@ paths: required: false schema: type: string - - &699 + - &698 name: model description: The model name to query usage for. The name is not case sensitive. in: query @@ -19819,7 +22337,7 @@ paths: parameters: - *73 - *115 - - &700 + - &699 name: month description: If specified, only return results for a single month. The value of `month` is an integer between `1` and `12`. If no year is specified the @@ -19931,7 +22449,7 @@ paths: - *115 - *117 - *116 - - &701 + - &700 name: repository description: The repository name to query for usage in the format owner/repository. in: query @@ -19939,7 +22457,7 @@ paths: schema: type: string - *118 - - &702 + - &701 name: sku description: The SKU to query for usage. in: query @@ -20946,7 +23464,7 @@ paths: type: integer repository_cache_usages: type: array - items: &336 + items: &335 title: Actions Cache Usage by repository description: GitHub Actions Cache Usage by repository. type: object @@ -21194,7 +23712,7 @@ paths: - public_ip_enabled - platform examples: - default: &152 + default: &151 value: total_count: 2 runners: @@ -22189,7 +24707,7 @@ paths: description: A JSON serialized template for OIDC subject claim customization content: application/json: - schema: &135 + schema: title: Actions OIDC Subject customization description: Actions OIDC Subject customization type: object @@ -22203,7 +24721,7 @@ paths: required: - include_claim_keys examples: - default: &136 + default: &135 value: include_claim_keys: - repo @@ -22230,15 +24748,25 @@ paths: required: true content: application/json: - schema: *135 + schema: + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: - default: *136 + default: *135 responses: '201': description: Empty response content: application/json: - schema: &162 + schema: &161 title: Empty Object description: An object without any properties. type: object @@ -22277,7 +24805,7 @@ paths: schema: type: object properties: - enabled_repositories: &137 + enabled_repositories: &136 type: string description: The policy that controls the repositories in the organization that are allowed to run GitHub Actions. @@ -22290,7 +24818,7 @@ paths: description: The API URL to use to get or set the selected repositories that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`. - allowed_actions: &138 + allowed_actions: &137 type: string description: The permissions policy that controls the actions and reusable workflows that are allowed to run. @@ -22298,12 +24826,12 @@ paths: - all - local_only - selected - selected_actions_url: &342 + selected_actions_url: &341 type: string description: The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` is set to `selected`. - sha_pinning_required: &139 + sha_pinning_required: &138 type: boolean description: Whether actions must be pinned to a full-length commit SHA. @@ -22345,9 +24873,9 @@ paths: schema: type: object properties: - enabled_repositories: *137 - allowed_actions: *138 - sha_pinning_required: *139 + enabled_repositories: *136 + allowed_actions: *137 + sha_pinning_required: *138 required: - enabled_repositories examples: @@ -22381,7 +24909,7 @@ paths: description: Response content: application/json: - schema: &346 + schema: &345 type: object properties: days: @@ -22423,7 +24951,7 @@ paths: required: true content: application/json: - schema: &347 + schema: &346 type: object properties: days: @@ -22466,7 +24994,7 @@ paths: description: Response content: application/json: - schema: &140 + schema: &139 type: object properties: approval_policy: @@ -22480,7 +25008,7 @@ paths: required: - approval_policy examples: - default: &348 + default: &347 value: approval_policy: first_time_contributors '404': *6 @@ -22511,7 +25039,7 @@ paths: required: true content: application/json: - schema: *140 + schema: *139 examples: default: summary: Set approval policy to first time contributors @@ -22539,7 +25067,7 @@ paths: description: Response content: application/json: - schema: &349 + schema: &348 type: object required: - run_workflows_from_fork_pull_requests @@ -22565,7 +25093,7 @@ paths: description: Whether workflows triggered by pull requests from forks require approval from a repository administrator to run. examples: - default: &141 + default: &140 value: run_workflows_from_fork_pull_requests: true send_write_tokens_to_workflows: false @@ -22593,7 +25121,7 @@ paths: required: true content: application/json: - schema: &350 + schema: &349 type: object required: - run_workflows_from_fork_pull_requests @@ -22616,7 +25144,7 @@ paths: description: Whether workflows triggered by pull requests from forks require approval from a repository administrator to run. examples: - default: *141 + default: *140 responses: '204': description: Empty response for successful settings update @@ -22666,7 +25194,7 @@ paths: type: array items: *77 examples: - default: &145 + default: &144 value: total_count: 1 repositories: @@ -22851,7 +25379,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization parameters: - *73 - - &142 + - &141 name: repository_id description: The unique identifier of the repository. in: path @@ -22880,7 +25408,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -22909,7 +25437,7 @@ paths: description: Response content: application/json: - schema: &143 + schema: &142 type: object properties: github_owned_allowed: @@ -22931,7 +25459,7 @@ paths: items: type: string examples: - default: &144 + default: &143 value: github_owned_allowed: true verified_allowed: false @@ -22964,9 +25492,9 @@ paths: required: false content: application/json: - schema: *143 + schema: *142 examples: - selected_actions: *144 + selected_actions: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -23098,7 +25626,7 @@ paths: type: array items: *77 examples: - default: *145 + default: *144 '403': *27 '404': *6 x-github: @@ -23167,7 +25695,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#add-a-repository-to-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No content @@ -23194,7 +25722,7 @@ paths: url: https://docs.github.com/rest/actions/permissions#remove-a-repository-from-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No content @@ -23228,17 +25756,17 @@ paths: description: Response content: application/json: - schema: &351 + schema: &350 type: object properties: - default_workflow_permissions: &146 + default_workflow_permissions: &145 type: string description: The default workflow permissions granted to the GITHUB_TOKEN when running workflows. enum: - read - write - can_approve_pull_request_reviews: &147 + can_approve_pull_request_reviews: &146 type: boolean description: Whether GitHub Actions can approve pull requests. Enabling this can be a security risk. @@ -23246,7 +25774,7 @@ paths: - default_workflow_permissions - can_approve_pull_request_reviews examples: - default: &148 + default: &147 summary: Give read-only permission, and allow approving PRs. value: default_workflow_permissions: read @@ -23279,13 +25807,13 @@ paths: required: false content: application/json: - schema: &352 + schema: &351 type: object properties: - default_workflow_permissions: *146 - can_approve_pull_request_reviews: *147 + default_workflow_permissions: *145 + can_approve_pull_request_reviews: *146 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -23330,7 +25858,7 @@ paths: type: number runner_groups: type: array - items: &149 + items: &148 type: object properties: id: @@ -23520,9 +26048,9 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: - default: &151 + default: &150 value: id: 2 name: octo-runner-group @@ -23558,7 +26086,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#get-a-self-hosted-runner-group-for-an-organization parameters: - *73 - - &150 + - &149 name: runner_group_id description: Unique identifier of the self-hosted runner group. in: path @@ -23570,7 +26098,7 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: default: value: @@ -23607,7 +26135,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#update-a-self-hosted-runner-group-for-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -23663,9 +26191,9 @@ paths: description: Response content: application/json: - schema: *149 + schema: *148 examples: - default: *151 + default: *150 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -23685,7 +26213,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#delete-a-self-hosted-runner-group-from-an-organization parameters: - *73 - - *150 + - *149 responses: '204': description: Response @@ -23709,7 +26237,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-github-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 - *17 - *19 responses: @@ -23729,7 +26257,7 @@ paths: type: array items: *123 examples: - default: *152 + default: *151 headers: Link: *65 x-github: @@ -23752,7 +26280,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 + - *149 - *19 - *17 responses: @@ -23770,9 +26298,9 @@ paths: type: number repositories: type: array - items: *153 + items: *152 examples: - default: &189 + default: &188 value: total_count: 1 repositories: @@ -24025,7 +26553,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#set-repository-access-for-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -24070,8 +26598,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#add-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 - - *142 + - *149 + - *141 responses: '204': description: Response @@ -24094,8 +26622,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#remove-repository-access-to-a-self-hosted-runner-group-in-an-organization parameters: - *73 - - *150 - - *142 + - *149 + - *141 responses: '204': description: Response @@ -24119,7 +26647,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#list-self-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 - *17 - *19 responses: @@ -24137,7 +26665,7 @@ paths: type: number runners: type: array - items: &155 + items: &154 title: Self hosted runners description: A self hosted runner type: object @@ -24171,7 +26699,7 @@ paths: type: boolean labels: type: array - items: &158 + items: &157 title: Self hosted runner label description: A label for a self hosted runner type: object @@ -24201,7 +26729,7 @@ paths: - busy - labels examples: - default: &156 + default: &155 value: total_count: 2 runners: @@ -24261,7 +26789,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#set-self-hosted-runners-in-a-group-for-an-organization parameters: - *73 - - *150 + - *149 requestBody: required: true content: @@ -24306,8 +26834,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#add-a-self-hosted-runner-to-a-group-for-an-organization parameters: - *73 - - *150 - - &154 + - *149 + - &153 name: runner_id description: Unique identifier of the self-hosted runner. in: path @@ -24336,8 +26864,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runner-groups#remove-a-self-hosted-runner-from-a-group-for-an-organization parameters: - *73 - - *150 - - *154 + - *149 + - *153 responses: '204': description: Response @@ -24385,9 +26913,9 @@ paths: type: integer runners: type: array - items: *155 + items: *154 examples: - default: *156 + default: *155 headers: Link: *65 x-github: @@ -24419,7 +26947,7 @@ paths: application/json: schema: type: array - items: &353 + items: &352 title: Runner Application description: Runner Application type: object @@ -24444,7 +26972,7 @@ paths: - download_url - filename examples: - default: &354 + default: &353 value: - os: osx architecture: x64 @@ -24530,7 +27058,7 @@ paths: - no-gpu work_folder: _work responses: - '201': &355 + '201': &354 description: Response content: application/json: @@ -24540,7 +27068,7 @@ paths: - runner - encoded_jit_config properties: - runner: *155 + runner: *154 encoded_jit_config: type: string description: The base64 encoded runner configuration. @@ -24603,7 +27131,7 @@ paths: description: Response content: application/json: - schema: &157 + schema: &156 title: Authentication Token description: Authentication Token type: object @@ -24645,7 +27173,7 @@ paths: - token - expires_at examples: - default: &356 + default: &355 value: token: LLBF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-22T12:13:35.123-08:00' @@ -24682,9 +27210,9 @@ paths: description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: &357 + default: &356 value: token: AABF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-29T12:13:35.123-08:00' @@ -24710,15 +27238,15 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: '200': description: Response content: application/json: - schema: *155 + schema: *154 examples: - default: &358 + default: &357 value: id: 23 name: MBP @@ -24760,7 +27288,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-an-organization parameters: - *73 - - *154 + - *153 responses: '204': description: Response @@ -24787,9 +27315,9 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: - '200': &159 + '200': &158 description: Response content: application/json: @@ -24803,7 +27331,7 @@ paths: type: integer labels: type: array - items: *158 + items: *157 examples: default: value: @@ -24843,7 +27371,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 requestBody: required: true content: @@ -24867,7 +27395,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24892,7 +27420,7 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 requestBody: required: true content: @@ -24917,7 +27445,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -24942,9 +27470,9 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 + - *153 responses: - '200': &359 + '200': &358 description: Response content: application/json: @@ -24958,7 +27486,7 @@ paths: type: integer labels: type: array - items: *158 + items: *157 examples: default: value: @@ -25000,8 +27528,8 @@ paths: url: https://docs.github.com/rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-an-organization parameters: - *73 - - *154 - - &360 + - *153 + - &359 name: name description: The name of a self-hosted runner's custom label. in: path @@ -25009,7 +27537,7 @@ paths: schema: type: string responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -25052,7 +27580,7 @@ paths: type: integer secrets: type: array - items: &160 + items: &159 title: Actions Secret for an Organization description: Secrets for GitHub Actions for an organization. type: object @@ -25133,7 +27661,7 @@ paths: description: Response content: application/json: - schema: &372 + schema: &371 title: ActionsPublicKey description: The public key used for setting Actions Secrets. type: object @@ -25168,7 +27696,7 @@ paths: - key_id - key examples: - default: &373 + default: &372 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -25194,7 +27722,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#get-an-organization-secret parameters: - *73 - - &161 + - &160 name: secret_name description: The name of the secret. in: path @@ -25206,7 +27734,7 @@ paths: description: Response content: application/json: - schema: *160 + schema: *159 examples: default: value: @@ -25237,7 +27765,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -25294,7 +27822,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -25321,7 +27849,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -25348,7 +27876,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -25366,9 +27894,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: &165 + default: &164 value: total_count: 1 repositories: @@ -25461,7 +27989,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -25514,7 +28042,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -25548,7 +28076,7 @@ paths: url: https://docs.github.com/rest/actions/secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -25581,7 +28109,7 @@ paths: url: https://docs.github.com/rest/actions/variables#list-organization-variables parameters: - *73 - - &341 + - &340 name: per_page description: The number of results per page (max 30). For more information, see "[Using pagination in the REST API](https://docs.github.com/rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -25605,7 +28133,7 @@ paths: type: integer variables: type: array - items: &163 + items: &162 title: Actions Variable for an Organization description: Organization variable for GitHub Actions. type: object @@ -25743,7 +28271,7 @@ paths: description: Response when creating a variable content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -25769,7 +28297,7 @@ paths: url: https://docs.github.com/rest/actions/variables#get-an-organization-variable parameters: - *73 - - &164 + - &163 name: name description: The name of the variable. in: path @@ -25781,7 +28309,7 @@ paths: description: Response content: application/json: - schema: *163 + schema: *162 examples: default: value: @@ -25812,7 +28340,7 @@ paths: url: https://docs.github.com/rest/actions/variables#update-an-organization-variable parameters: - *73 - - *164 + - *163 requestBody: required: true content: @@ -25875,7 +28403,7 @@ paths: url: https://docs.github.com/rest/actions/variables#delete-an-organization-variable parameters: - *73 - - *164 + - *163 responses: '204': description: Response @@ -25902,7 +28430,7 @@ paths: url: https://docs.github.com/rest/actions/variables#list-selected-repositories-for-an-organization-variable parameters: - *73 - - *164 + - *163 - *19 - *17 responses: @@ -25920,9 +28448,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 '409': description: Response when the visibility of the variable is not set to `selected` @@ -25949,7 +28477,7 @@ paths: url: https://docs.github.com/rest/actions/variables#set-selected-repositories-for-an-organization-variable parameters: - *73 - - *164 + - *163 requestBody: required: true content: @@ -25999,7 +28527,7 @@ paths: url: https://docs.github.com/rest/actions/variables#add-selected-repository-to-an-organization-variable parameters: - *73 - - *164 + - *163 - name: repository_id in: path required: true @@ -26034,7 +28562,7 @@ paths: url: https://docs.github.com/rest/actions/variables#remove-selected-repository-from-an-organization-variable parameters: - *73 - - *164 + - *163 - name: repository_id in: path required: true @@ -26163,6 +28691,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -26194,7 +28729,7 @@ paths: type: integer deployment_records: type: array - items: &166 + items: &165 title: Artifact Deployment Record description: Artifact Metadata Deployment Record type: object @@ -26238,8 +28773,10 @@ paths: - 'null' description: The ID of the provenance attestation associated with the deployment record. + required: + - total_count examples: - default: &167 + default: &166 value: total_count: 1 deployment_records: @@ -26383,6 +28920,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -26414,10 +28958,25 @@ paths: type: integer deployment_records: type: array - items: *166 + items: *165 + required: + - total_count examples: - default: *167 - '403': *27 + default: *166 + '403': + description: Forbidden + content: + application/json: + schema: *3 + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': *6 x-github: githubCloudOnly: false @@ -26519,6 +29078,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -26572,6 +29138,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -26630,9 +29198,9 @@ paths: - 3 deployment_records: type: array - items: *166 + items: *165 examples: - default: *167 + default: *166 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -26762,12 +29330,12 @@ paths: required: - subject_digests examples: - default: &681 + default: &680 value: subject_digests: - sha256:abc123 - sha512:def456 - withPredicateType: &682 + withPredicateType: &681 value: subject_digests: - sha256:abc123 @@ -26826,7 +29394,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: &683 + default: &682 value: attestations_subject_digests: - sha256:abc: @@ -27192,7 +29760,7 @@ paths: initiator: type: string examples: - default: &386 + default: &385 value: attestations: - bundle: @@ -27425,7 +29993,7 @@ paths: description: If specified, only campaigns with this state will be returned. in: query required: false - schema: &168 + schema: &167 title: Campaign state description: Indicates whether a campaign is open or closed type: string @@ -27451,7 +30019,7 @@ paths: application/json: schema: type: array - items: &169 + items: &168 title: Campaign summary description: The campaign metadata and alert stats. type: object @@ -27482,7 +30050,7 @@ paths: team_managers: description: The campaign team managers type: array - items: &188 + items: &187 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -27559,7 +30127,7 @@ paths: parent: anyOf: - type: 'null' - - &245 + - &244 title: Team Simple description: Groups of organization members that gives permissions on specified repositories. @@ -27695,7 +30263,7 @@ paths: - string - 'null' format: date-time - state: *168 + state: *167 contact_link: description: The contact link of the campaign. type: @@ -27918,9 +30486,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: &170 + default: &169 value: number: 3 created_at: '2024-02-14T12:29:18Z' @@ -28003,9 +30571,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: *170 + default: *169 '404': *6 '422': description: Unprocessable Entity @@ -28083,7 +30651,7 @@ paths: - string - 'null' format: uri - state: *168 + state: *167 examples: default: value: @@ -28093,9 +30661,9 @@ paths: description: Response content: application/json: - schema: *169 + schema: *168 examples: - default: *170 + default: *169 '400': description: Bad Request content: @@ -28162,17 +30730,17 @@ paths: url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization parameters: - *73 - - &410 + - &409 name: tool_name description: The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either `tool_name` or `tool_guid`, but not both. in: query required: false - schema: &178 + schema: &177 type: string description: The name of the tool used to generate the code scanning analysis. - - &411 + - &410 name: tool_guid description: The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in @@ -28180,7 +30748,7 @@ paths: or `tool_name`, but not both. in: query required: false - schema: &179 + schema: &178 type: - string - 'null' @@ -28196,7 +30764,7 @@ paths: be returned. in: query required: false - schema: &413 + schema: &412 type: string description: State of a code scanning alert. enum: @@ -28219,7 +30787,7 @@ paths: be returned. in: query required: false - schema: &414 + schema: &413 type: string description: Severity of a code scanning alert. enum: @@ -28248,18 +30816,18 @@ paths: items: type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: &415 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: &414 type: string description: The REST API URL for fetching the list of instances for an alert. format: uri readOnly: true - state: &180 + state: &179 type: - string - 'null' @@ -28269,13 +30837,13 @@ paths: - dismissed - fixed - - fixed_at: *176 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: &416 + dismissed_at: *176 + dismissed_reason: &415 type: - string - 'null' @@ -28286,14 +30854,14 @@ paths: - won't fix - used in tests - - dismissed_comment: &417 + dismissed_comment: &416 type: - string - 'null' description: The dismissal comment associated with the dismissal of the alert. maxLength: 280 - rule: &418 + rule: &417 type: object properties: id: @@ -28354,43 +30922,43 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: &419 + tool: &418 type: object properties: - name: *178 + name: *177 version: type: - string - 'null' description: The version of the tool used to generate the code scanning analysis. - guid: *179 - most_recent_instance: &420 + guid: *178 + most_recent_instance: &419 type: object properties: - ref: &412 + ref: &411 type: string description: |- The Git reference, formatted as `refs/pull//merge`, `refs/pull//head`, `refs/heads/` or simply ``. - analysis_key: &430 + analysis_key: &429 type: string description: Identifies the configuration under which the analysis was executed. For example, in GitHub Actions this includes the workflow filename and job name. - environment: &431 + environment: &430 type: string description: Identifies the variable values associated with the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed. - category: &432 + category: &431 type: string description: Identifies the configuration under which the analysis was executed. Used to distinguish between multiple analyses for the same tool and commit, but performed on different languages or different parts of the code. - state: *180 + state: *179 commit_sha: type: string message: @@ -28404,7 +30972,7 @@ paths: with placeholder links for related locations replaced by links to the relevant code. Only populated when related locations are available for the alert instance. - location: &433 + location: &432 type: object description: Describe a region within a file for the alert. properties: @@ -28425,7 +30993,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: &434 + items: &433 type: - string - 'null' @@ -29061,7 +31629,7 @@ paths: application/json: schema: *47 examples: - default: *181 + default: *180 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -29089,9 +31657,9 @@ paths: description: Response content: application/json: - schema: *182 + schema: *181 examples: - default: *183 + default: *182 '304': *35 '403': *27 '404': *6 @@ -29143,7 +31711,7 @@ paths: - 32 - 91 responses: - '204': *184 + '204': *183 '400': *14 '403': *27 '404': *6 @@ -29178,7 +31746,7 @@ paths: application/json: schema: *47 examples: - default: *181 + default: *180 '304': *35 '403': *27 '404': *6 @@ -29478,7 +32046,7 @@ paths: - *73 - *49 responses: - '204': *184 + '204': *183 '400': *14 '403': *27 '404': *6 @@ -29616,7 +32184,7 @@ paths: default: value: default_for_new_repos: all - configuration: *181 + configuration: *180 '403': *27 '404': *6 x-github: @@ -29669,13 +32237,13 @@ paths: application/json: schema: type: array - items: *185 + items: *184 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: *186 + repository: *185 '403': *27 '404': *6 x-github: @@ -29715,7 +32283,7 @@ paths: type: integer codespaces: type: array - items: &235 + items: &234 type: object title: Codespace description: A codespace. @@ -29746,11 +32314,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *153 + repository: *152 machine: anyOf: - type: 'null' - - &446 + - &445 type: object title: Codespace machine description: A description of the machine powering a codespace. @@ -30037,7 +32605,7 @@ paths: - pulls_url - recent_folders examples: - default: &236 + default: &235 value: total_count: 3 codespaces: @@ -30661,7 +33229,7 @@ paths: type: integer secrets: type: array - items: &187 + items: &186 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -30702,7 +33270,7 @@ paths: - updated_at - visibility examples: - default: &447 + default: &446 value: total_count: 2 secrets: @@ -30740,7 +33308,7 @@ paths: description: Response content: application/json: - schema: &448 + schema: &447 title: CodespacesPublicKey description: The public key used for setting Codespaces secrets. type: object @@ -30775,7 +33343,7 @@ paths: - key_id - key examples: - default: &449 + default: &448 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -30799,15 +33367,15 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#get-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *187 + schema: *186 examples: - default: &451 + default: &450 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -30835,7 +33403,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -30890,7 +33458,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -30917,7 +33485,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -30943,7 +33511,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -30961,9 +33529,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 '404': *6 x-github: githubCloudOnly: false @@ -30986,7 +33554,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -31037,7 +33605,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -31071,7 +33639,7 @@ paths: url: https://docs.github.com/rest/codespaces/organization-secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -31274,7 +33842,7 @@ paths: currently being billed. seats: type: array - items: &238 + items: &237 title: Copilot Business Seat Detail description: Information about a Copilot Business seat assignment for a user, team, or organization. @@ -31292,7 +33860,7 @@ paths: description: The team through which the assignee is granted access to GitHub Copilot, if applicable. oneOf: - - *188 + - *187 - *66 type: - 'null' @@ -31905,12 +34473,12 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 required: - total_count - repositories examples: - default: *189 + default: *188 '500': *53 '401': *23 '403': *27 @@ -31996,7 +34564,7 @@ paths: url: https://docs.github.com/rest/copilot/copilot-coding-agent-management#enable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No Content @@ -32030,7 +34598,7 @@ paths: url: https://docs.github.com/rest/copilot/copilot-coding-agent-management#disable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: No Content @@ -32245,7 +34813,7 @@ paths: application/json: schema: type: array - items: &318 + items: &317 title: Copilot Usage Metrics description: Copilot usage metrics for a given day. type: object @@ -32560,7 +35128,7 @@ paths: - date additionalProperties: true examples: - default: &319 + default: &318 value: - date: '2024-06-24' total_active_users: 24 @@ -32662,7 +35230,7 @@ paths: '500': *53 '403': *27 '404': *6 - '422': &320 + '422': &319 description: Copilot Usage Metrics API setting is disabled at the organization or enterprise level. content: @@ -32703,7 +35271,7 @@ paths: schema: *55 examples: default: *56 - '204': *184 + '204': *183 '500': *53 '403': *27 '404': *6 @@ -32779,7 +35347,7 @@ paths: schema: *55 examples: default: *56 - '204': *184 + '204': *183 '500': *53 '403': *27 '404': *6 @@ -32842,11 +35410,11 @@ paths: url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-an-organization parameters: - *73 + - *189 - *190 - *191 - *192 - *193 - - *194 - name: artifact_registry_url in: query description: A comma-separated list of artifact registry URLs. If specified, @@ -32876,7 +35444,7 @@ paths: enum: - patch - deployment - - *195 + - *194 - name: runtime_risk in: query description: |- @@ -32885,8 +35453,8 @@ paths: Can be: `critical-resource`, `internet-exposed`, `sensitive-data`, `lateral-movement` schema: type: string + - *195 - *196 - - *197 - *59 - *45 - *46 @@ -32898,9 +35466,9 @@ paths: application/json: schema: type: array - items: *198 + items: *197 examples: - default: *199 + default: *198 '304': *35 '400': *14 '403': *27 @@ -32944,7 +35512,7 @@ paths: type: integer secrets: type: array - items: &200 + items: &199 title: Dependabot Secret for an Organization description: Secrets for GitHub Dependabot for an organization. type: object @@ -33023,7 +35591,7 @@ paths: description: Response content: application/json: - schema: &477 + schema: &476 title: DependabotPublicKey description: The public key used for setting Dependabot Secrets. type: object @@ -33042,7 +35610,7 @@ paths: - key_id - key examples: - default: &478 + default: &477 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -33066,13 +35634,13 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#get-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *200 + schema: *199 examples: default: value: @@ -33101,7 +35669,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#create-or-update-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -33158,7 +35726,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -33191,7 +35759,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#delete-an-organization-secret parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -33216,7 +35784,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#list-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 - *19 - *17 responses: @@ -33234,9 +35802,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -33258,7 +35826,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#set-selected-repositories-for-an-organization-secret parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -33309,7 +35877,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#add-selected-repository-to-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -33341,7 +35909,7 @@ paths: url: https://docs.github.com/rest/dependabot/secrets#remove-selected-repository-from-an-organization-secret parameters: - *73 - - *161 + - *160 - name: repository_id in: path required: true @@ -33379,7 +35947,7 @@ paths: application/json: schema: type: array - items: &247 + items: &246 title: Package description: A software package type: object @@ -33432,7 +36000,7 @@ paths: repository: anyOf: - type: 'null' - - *153 + - *152 created_at: type: string format: date-time @@ -33450,7 +36018,7 @@ paths: - created_at - updated_at examples: - default: &248 + default: &247 value: - id: 197 name: hello_docker @@ -33620,7 +36188,7 @@ paths: application/json: schema: type: array - items: &224 + items: &223 title: Organization Invitation description: Organization Invitation type: object @@ -33674,7 +36242,7 @@ paths: - invitation_teams_url - node_id examples: - default: &225 + default: &224 value: - id: 1 login: monalisa @@ -33741,7 +36309,7 @@ paths: application/json: schema: type: array - items: &201 + items: &200 title: Org Hook description: Org Hook type: object @@ -33926,9 +36494,9 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: - default: &202 + default: &201 value: id: 1 url: https://api.github.com/orgs/octocat/hooks/1 @@ -33976,7 +36544,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-an-organization-webhook parameters: - *73 - - &203 + - &202 name: hook_id description: The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery. @@ -33989,9 +36557,9 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: - default: *202 + default: *201 '404': *6 x-github: githubCloudOnly: false @@ -34019,7 +36587,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#update-an-organization-webhook parameters: - *73 - - *203 + - *202 requestBody: required: false content: @@ -34065,7 +36633,7 @@ paths: description: Response content: application/json: - schema: *201 + schema: *200 examples: default: value: @@ -34107,7 +36675,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#delete-an-organization-webhook parameters: - *73 - - *203 + - *202 responses: '204': description: Response @@ -34135,7 +36703,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization parameters: - *73 - - *203 + - *202 responses: '200': description: Response @@ -34166,7 +36734,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization parameters: - *73 - - *203 + - *202 requestBody: required: false content: @@ -34217,10 +36785,10 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#list-deliveries-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *17 + - *203 - *204 - - *205 responses: '200': description: Response @@ -34228,9 +36796,9 @@ paths: application/json: schema: type: array - items: *206 + items: *205 examples: - default: *207 + default: *206 '400': *14 '422': *15 x-github: @@ -34256,16 +36824,16 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *16 responses: '200': description: Response content: application/json: - schema: *208 + schema: *207 examples: - default: *209 + default: *208 '400': *14 '422': *15 x-github: @@ -34291,7 +36859,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook parameters: - *73 - - *203 + - *202 - *16 responses: '202': *37 @@ -34321,7 +36889,7 @@ paths: url: https://docs.github.com/rest/orgs/webhooks#ping-an-organization-webhook parameters: - *73 - - *203 + - *202 responses: '204': description: Response @@ -34344,7 +36912,7 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-route-stats-by-actor parameters: - *73 - - &214 + - &213 name: actor_type in: path description: The type of the actor @@ -34357,14 +36925,14 @@ paths: - fine_grained_pat - oauth_app - github_app_user_to_server - - &215 + - &214 name: actor_id in: path description: The ID of the actor required: true schema: type: integer - - &210 + - &209 name: min_timestamp description: 'The minimum timestamp to query for stats. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -34372,7 +36940,7 @@ paths: required: true schema: type: string - - &211 + - &210 name: max_timestamp description: 'The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -34467,12 +37035,12 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-subject-stats parameters: - *73 + - *209 - *210 - - *211 - *19 - *17 - *59 - - &220 + - &219 name: sort description: The property to sort the results by. in: query @@ -34551,14 +37119,14 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats parameters: - *73 + - *209 - *210 - - *211 responses: '200': description: Response content: application/json: - schema: &212 + schema: &211 title: Summary Stats description: API Insights usage summary stats for an organization type: object @@ -34574,7 +37142,7 @@ paths: type: integer format: int64 examples: - default: &213 + default: &212 value: total_request_count: 34225 rate_limited_request_count: 23 @@ -34595,23 +37163,23 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-user parameters: - *73 - - &216 + - &215 name: user_id in: path description: The ID of the user to query for stats required: true schema: type: string + - *209 - *210 - - *211 responses: '200': description: Response content: application/json: - schema: *212 + schema: *211 examples: - default: *213 + default: *212 x-github: enabledForGitHubApps: true category: orgs @@ -34630,18 +37198,18 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-summary-stats-by-actor parameters: - *73 + - *209 - *210 - - *211 + - *213 - *214 - - *215 responses: '200': description: Response content: application/json: - schema: *212 + schema: *211 examples: - default: *213 + default: *212 x-github: enabledForGitHubApps: true category: orgs @@ -34659,9 +37227,9 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats parameters: - *73 + - *209 - *210 - - *211 - - &217 + - &216 name: timestamp_increment description: The increment of time used to breakdown the query results (5m, 10m, 1h, etc.) @@ -34674,7 +37242,7 @@ paths: description: Response content: application/json: - schema: &218 + schema: &217 title: Time Stats description: API Insights usage time stats for an organization type: array @@ -34690,7 +37258,7 @@ paths: type: integer format: int64 examples: - default: &219 + default: &218 value: - timestamp: '2024-09-11T15:00:00Z' total_request_count: 34225 @@ -34727,18 +37295,18 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-user parameters: - *73 - - *216 + - *215 + - *209 - *210 - - *211 - - *217 + - *216 responses: '200': description: Response content: application/json: - schema: *218 + schema: *217 examples: - default: *219 + default: *218 x-github: enabledForGitHubApps: true category: orgs @@ -34756,19 +37324,19 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-time-stats-by-actor parameters: - *73 + - *213 - *214 - - *215 + - *209 - *210 - - *211 - - *217 + - *216 responses: '200': description: Response content: application/json: - schema: *218 + schema: *217 examples: - default: *219 + default: *218 x-github: enabledForGitHubApps: true category: orgs @@ -34786,13 +37354,13 @@ paths: url: https://docs.github.com/rest/orgs/api-insights#get-user-stats parameters: - *73 - - *216 + - *215 + - *209 - *210 - - *211 - *19 - *17 - *59 - - *220 + - *219 - name: actor_name_substring in: query description: Providing a substring will filter results where the actor name @@ -34876,7 +37444,7 @@ paths: application/json: schema: *20 examples: - default: &516 + default: &515 value: id: 1 account: @@ -35042,12 +37610,12 @@ paths: application/json: schema: anyOf: - - &222 + - &221 title: Interaction Limits description: Interaction limit settings. type: object properties: - limit: &221 + limit: &220 type: string description: The type of GitHub user that can comment, open issues, or create pull requests while the interaction limit @@ -35075,7 +37643,7 @@ paths: properties: {} additionalProperties: false examples: - default: &223 + default: &222 value: limit: collaborators_only origin: organization @@ -35104,13 +37672,13 @@ paths: required: true content: application/json: - schema: &517 + schema: &516 title: Interaction Restrictions description: Limit interactions to a specific type of user for a specified duration type: object properties: - limit: *221 + limit: *220 expiry: type: string description: 'The duration of the interaction restriction. Default: @@ -35135,9 +37703,9 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: - default: *223 + default: *222 '422': *15 x-github: githubCloudOnly: false @@ -35213,9 +37781,9 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 '404': *6 @@ -35292,7 +37860,7 @@ paths: description: Response content: application/json: - schema: *224 + schema: *223 examples: default: value: @@ -35347,7 +37915,7 @@ paths: url: https://docs.github.com/rest/orgs/members#cancel-an-organization-invitation parameters: - *73 - - &226 + - &225 name: invitation_id description: The unique identifier of the invitation. in: path @@ -35378,7 +37946,7 @@ paths: url: https://docs.github.com/rest/orgs/members#list-organization-invitation-teams parameters: - *73 - - *226 + - *225 - *17 - *19 responses: @@ -35388,9 +37956,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: &246 + default: &245 value: - id: 1 node_id: MDQ6VGVhbTE= @@ -35433,7 +38001,7 @@ paths: application/json: schema: type: array - items: &227 + items: &226 title: Issue Field description: A custom attribute defined at the organization level for attaching structured data to issues. @@ -35676,9 +38244,9 @@ paths: description: Response content: application/json: - schema: *227 + schema: *226 examples: - default: &228 + default: &227 value: id: 512 node_id: IF_kwDNAd3NAZr @@ -35734,7 +38302,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-fields#update-issue-field-for-an-organization parameters: - *73 - - &229 + - &228 name: issue_field_id description: The unique identifier of the issue field. in: path @@ -35835,9 +38403,9 @@ paths: description: Response content: application/json: - schema: *227 + schema: *226 examples: - default: *228 + default: *227 '404': *6 '422': *7 x-github: @@ -35862,9 +38430,9 @@ paths: url: https://docs.github.com/rest/orgs/issue-fields#delete-issue-field-for-an-organization parameters: - *73 - - *229 + - *228 responses: - '204': *184 + '204': *183 '404': *6 '422': *7 x-github: @@ -35892,7 +38460,7 @@ paths: application/json: schema: type: array - items: *230 + items: *229 examples: default: value: @@ -35980,9 +38548,9 @@ paths: description: Response content: application/json: - schema: *230 + schema: *229 examples: - default: &231 + default: &230 value: id: 410 node_id: IT_kwDNAd3NAZo @@ -36015,7 +38583,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-types#update-issue-type-for-an-organization parameters: - *73 - - &232 + - &231 name: issue_type_id description: The unique identifier of the issue type. in: path @@ -36071,9 +38639,9 @@ paths: description: Response content: application/json: - schema: *230 + schema: *229 examples: - default: *231 + default: *230 '404': *6 '422': *7 x-github: @@ -36098,7 +38666,7 @@ paths: url: https://docs.github.com/rest/orgs/issue-types#delete-issue-type-for-an-organization parameters: - *73 - - *232 + - *231 responses: '204': description: Response @@ -36161,7 +38729,7 @@ paths: - closed - all default: open - - *233 + - *232 - name: type description: Can be the name of an issue type. in: query @@ -36192,7 +38760,7 @@ paths: type: array items: *81 examples: - default: *234 + default: *233 headers: Link: *65 '404': *6 @@ -36357,9 +38925,9 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: - default: *236 + default: *235 '304': *35 '500': *53 '401': *23 @@ -36386,7 +38954,7 @@ paths: parameters: - *73 - *69 - - &237 + - &236 name: codespace_name in: path required: true @@ -36421,15 +38989,15 @@ paths: parameters: - *73 - *69 - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: &445 + default: &444 value: id: 1 name: monalisa-octocat-hello-world-g4wpq6h95q @@ -36609,7 +39177,7 @@ paths: description: The user's GitHub Copilot seat details, including usage. content: application/json: - schema: *238 + schema: *237 examples: default: value: @@ -36685,7 +39253,7 @@ paths: description: Response content: application/json: - schema: &239 + schema: &238 title: Org Membership description: Org Membership type: object @@ -36754,7 +39322,7 @@ paths: - organization - user examples: - response-if-user-has-an-active-admin-membership-with-organization: &240 + response-if-user-has-an-active-admin-membership-with-organization: &239 summary: Response if user has an active admin membership with organization value: url: https://api.github.com/orgs/octocat/memberships/defunkt @@ -36855,9 +39423,9 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: - response-if-user-already-had-membership-with-organization: *240 + response-if-user-already-had-membership-with-organization: *239 '422': *15 '403': *27 x-github: @@ -36935,7 +39503,7 @@ paths: application/json: schema: type: array - items: &241 + items: &240 title: Migration description: A migration. type: object @@ -37284,7 +39852,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -37463,7 +40031,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#get-an-organization-migration-status parameters: - *73 - - &242 + - &241 name: migration_id description: The unique identifier of the migration. in: path @@ -37491,7 +40059,7 @@ paths: * `failed`, which means the migration failed. content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -37661,7 +40229,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#download-an-organization-migration-archive parameters: - *73 - - *242 + - *241 responses: '302': description: Response @@ -37683,7 +40251,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#delete-an-organization-migration-archive parameters: - *73 - - *242 + - *241 responses: '204': description: Response @@ -37707,8 +40275,8 @@ paths: url: https://docs.github.com/rest/migrations/orgs#unlock-an-organization-repository parameters: - *73 - - *242 - - &664 + - *241 + - &663 name: repo_name description: repo_name parameter in: path @@ -37736,7 +40304,7 @@ paths: url: https://docs.github.com/rest/migrations/orgs#list-repositories-in-an-organization-migration parameters: - *73 - - *242 + - *241 - *17 - *19 responses: @@ -37746,9 +40314,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: &253 + default: &252 value: - id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -37895,7 +40463,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -37921,7 +40489,7 @@ paths: roles: type: array description: The list of organization roles available to the organization. - items: &244 + items: &243 title: Organization Role description: Organization roles type: object @@ -38098,7 +40666,7 @@ paths: parameters: - *73 - *75 - - &243 + - &242 name: role_id description: The unique identifier of the role. in: path @@ -38135,7 +40703,7 @@ paths: parameters: - *73 - *75 - - *243 + - *242 responses: '204': description: Response @@ -38188,7 +40756,7 @@ paths: parameters: - *73 - *69 - - *243 + - *242 responses: '204': description: Response @@ -38220,7 +40788,7 @@ paths: parameters: - *73 - *69 - - *243 + - *242 responses: '204': description: Response @@ -38238,7 +40806,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -38249,13 +40817,13 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#get-an-organization-role parameters: - *73 - - *243 + - *242 responses: '200': description: Response content: application/json: - schema: *244 + schema: *243 examples: default: value: @@ -38306,7 +40874,7 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#list-teams-that-are-assigned-to-an-organization-role parameters: - *73 - - *243 + - *242 - *17 - *19 responses: @@ -38385,7 +40953,7 @@ paths: parent: anyOf: - type: 'null' - - *245 + - *244 type: description: The ownership type of the team type: string @@ -38418,7 +40986,7 @@ paths: - type - parent examples: - default: *246 + default: *245 headers: Link: *65 '404': @@ -38448,7 +41016,7 @@ paths: url: https://docs.github.com/rest/orgs/organization-roles#list-users-that-are-assigned-to-an-organization-role parameters: - *73 - - *243 + - *242 - *17 - *19 responses: @@ -38477,7 +41045,7 @@ paths: inherited_from: description: Team the user has gotten the role through type: array - items: *245 + items: *244 name: type: - string @@ -38787,7 +41355,7 @@ paths: - nuget - container - *73 - - &665 + - &664 name: visibility description: |- The selected visibility of the packages. This parameter is optional and only filters an existing result set. @@ -38823,12 +41391,12 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *248 + default: *247 '403': *27 '401': *23 - '400': &667 + '400': &666 description: The value of `per_page` multiplied by `page` cannot be greater than 10000. x-github: @@ -38850,7 +41418,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-an-organization parameters: - - &249 + - &248 name: package_type description: The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry @@ -38868,7 +41436,7 @@ paths: - docker - nuget - container - - &250 + - &249 name: package_name description: The name of the package. in: path @@ -38881,7 +41449,7 @@ paths: description: Response content: application/json: - schema: *247 + schema: *246 examples: default: value: @@ -38933,8 +41501,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-an-organization parameters: + - *248 - *249 - - *250 - *73 responses: '204': @@ -38967,8 +41535,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - name: token description: package token @@ -39001,8 +41569,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-an-organization parameters: + - *248 - *249 - - *250 - *73 - *19 - *17 @@ -39023,7 +41591,7 @@ paths: application/json: schema: type: array - items: &251 + items: &250 title: Package Version description: A version of a software package type: object @@ -39158,10 +41726,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - &252 + - &251 name: package_version_id description: Unique identifier of the package version. in: path @@ -39173,7 +41741,7 @@ paths: description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -39209,10 +41777,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - *252 + - *251 responses: '204': description: Response @@ -39244,10 +41812,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-package-version-for-an-organization parameters: + - *248 - *249 - - *250 - *73 - - *252 + - *251 responses: '204': description: Response @@ -39277,7 +41845,7 @@ paths: - *73 - *17 - *19 - - &254 + - &253 name: sort description: The property by which to sort the results. in: query @@ -39288,7 +41856,7 @@ paths: - created_at default: created_at - *59 - - &255 + - &254 name: owner description: A list of owner usernames to use to filter the results. in: query @@ -39300,7 +41868,7 @@ paths: type: string examples: - owner[]=octocat1,owner[]=octocat2 - - &256 + - &255 name: repository description: The name of the repository to use to filter the results. in: query @@ -39309,7 +41877,7 @@ paths: type: string examples: - Hello-World - - &257 + - &256 name: permission description: The permission to use to filter the results. in: query @@ -39318,7 +41886,7 @@ paths: type: string examples: - issues_read - - &258 + - &257 name: last_used_before description: 'Only show fine-grained personal access tokens used before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -39328,7 +41896,7 @@ paths: schema: type: string format: date-time - - &259 + - &258 name: last_used_after description: 'Only show fine-grained personal access tokens used after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -39338,7 +41906,7 @@ paths: schema: type: string format: date-time - - &260 + - &259 name: token_id description: The ID of the token in: query @@ -39614,7 +42182,7 @@ paths: '422': *15 '404': *6 '403': *27 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -39655,9 +42223,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -39683,14 +42251,14 @@ paths: - *73 - *17 - *19 - - *254 + - *253 - *59 + - *254 - *255 - *256 - *257 - *258 - *259 - - *260 responses: '500': *53 '422': *15 @@ -39931,7 +42499,7 @@ paths: responses: '500': *53 '404': *6 - '204': *184 + '204': *183 '403': *27 '422': *15 x-github: @@ -39972,9 +42540,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -40016,7 +42584,7 @@ paths: type: integer configurations: type: array - items: &261 + items: &260 title: Organization private registry description: Private registry configuration for an organization type: object @@ -40450,7 +43018,7 @@ paths: - created_at - updated_at examples: - org-private-registry-with-selected-visibility: &262 + org-private-registry-with-selected-visibility: &261 value: name: MAVEN_REPOSITORY_SECRET registry_type: maven_repository @@ -40542,15 +43110,15 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#get-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 responses: '200': description: The specified private registry configuration for the organization content: application/json: - schema: *261 + schema: *260 examples: - default: *262 + default: *261 '404': *6 x-github: githubCloudOnly: false @@ -40573,7 +43141,7 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#update-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 requestBody: required: true content: @@ -40738,7 +43306,7 @@ paths: url: https://docs.github.com/rest/private-registries/organization-configurations#delete-a-private-registry-for-an-organization parameters: - *73 - - *161 + - *160 responses: '204': description: Response @@ -40778,7 +43346,7 @@ paths: application/json: schema: type: array - items: &263 + items: &262 title: Projects v2 Project description: A projects v2 project type: object @@ -40852,7 +43420,7 @@ paths: latest_status_update: anyOf: - type: 'null' - - &750 + - &749 title: Projects v2 Status Update description: An status update belonging to a project type: object @@ -40937,7 +43505,7 @@ paths: - deleted_at - deleted_by examples: - default: &264 + default: &263 value: id: 2 node_id: MDc6UHJvamVjdDEwMDI2MDM= @@ -41040,7 +43608,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/projects#get-project-for-organization parameters: - - &265 + - &264 name: project_number description: The project's number. in: path @@ -41053,9 +43621,9 @@ paths: description: Response content: application/json: - schema: *263 + schema: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -41078,7 +43646,7 @@ paths: url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true description: Details of the draft item to create in the project. @@ -41112,7 +43680,7 @@ paths: description: Response content: application/json: - schema: &270 + schema: &269 title: Projects v2 Item description: An item belonging to a project type: object @@ -41126,7 +43694,7 @@ paths: content: oneOf: - *81 - - &460 + - &459 title: Pull Request Simple description: Pull Request Simple type: object @@ -41246,7 +43814,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 active_lock_reason: type: - string @@ -41295,7 +43863,7 @@ paths: items: *4 requested_teams: type: array - items: *188 + items: *187 head: type: object properties: @@ -41339,7 +43907,7 @@ paths: _links: type: object properties: - comments: &267 + comments: &266 title: Link description: Hypermedia Link type: object @@ -41348,13 +43916,13 @@ paths: type: string required: - href - commits: *267 - statuses: *267 - html: *267 - issue: *267 - review_comments: *267 - review_comment: *267 - self: *267 + commits: *266 + statuses: *266 + html: *266 + issue: *266 + review_comments: *266 + review_comment: *266 + self: *266 required: - comments - commits @@ -41365,7 +43933,7 @@ paths: - review_comment - self author_association: *78 - auto_merge: &562 + auto_merge: &561 title: Auto merge description: The status of auto merging a pull request. type: @@ -41539,7 +44107,7 @@ paths: - created_at - updated_at description: The content represented by the item. - content_type: &269 + content_type: &268 title: Projects v2 Item Content Type description: The type of content tracked in a project item type: string @@ -41583,7 +44151,7 @@ paths: - updated_at - archived_at examples: - draft_issue: &271 + draft_issue: &270 value: id: 17 node_id: PVTI_lADOANN5s84ACbL0zgBueEI @@ -41657,7 +44225,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#list-project-fields-for-organization parameters: - - *265 + - *264 - *73 - *17 - *45 @@ -41669,7 +44237,7 @@ paths: application/json: schema: type: array - items: &268 + items: &267 title: Projects v2 Field description: A field inside a projects v2 project type: object @@ -41822,7 +44390,7 @@ paths: - updated_at - project_url examples: - default: &686 + default: &685 value: - id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -41952,7 +44520,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#add-a-field-to-an-organization-owned-project parameters: - - *265 + - *264 - *73 requestBody: required: true @@ -41999,7 +44567,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: &687 + items: &686 type: object properties: name: @@ -42036,7 +44604,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: &688 + iteration_configuration: &687 type: object description: The configuration for iteration fields. properties: @@ -42086,7 +44654,7 @@ paths: value: name: Due date data_type: date - single_select_field: &689 + single_select_field: &688 summary: Create a single select field value: name: Priority @@ -42113,7 +44681,7 @@ paths: description: raw: High priority items html: High priority items - iteration_field: &690 + iteration_field: &689 summary: Create an iteration field value: name: Sprint @@ -42137,9 +44705,9 @@ paths: description: Response for adding a field to an organization-owned project. content: application/json: - schema: *268 + schema: *267 examples: - text_field: &691 + text_field: &690 value: id: 24680 node_id: PVTF_lADOABCD2468024680 @@ -42148,7 +44716,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-05-15T08:00:00Z' updated_at: '2022-05-15T08:00:00Z' - number_field: &692 + number_field: &691 value: id: 13579 node_id: PVTF_lADOABCD1357913579 @@ -42157,7 +44725,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-01T14:30:00Z' updated_at: '2022-06-01T14:30:00Z' - date_field: &693 + date_field: &692 value: id: 98765 node_id: PVTF_lADOABCD9876598765 @@ -42166,7 +44734,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-10T09:15:00Z' updated_at: '2022-06-10T09:15:00Z' - single_select_field: &694 + single_select_field: &693 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -42200,7 +44768,7 @@ paths: raw: High priority items created_at: '2022-04-28T12:00:00Z' updated_at: '2022-04-28T12:00:00Z' - iteration_field: &695 + iteration_field: &694 value: id: 11223 node_id: PVTF_lADOABCD1122311223 @@ -42245,8 +44813,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#get-project-field-for-organization parameters: - - *265 - - &696 + - *264 + - &695 name: field_id description: The unique identifier of the field. in: path @@ -42259,9 +44827,9 @@ paths: description: Response content: application/json: - schema: *268 + schema: *267 examples: - default: &697 + default: &696 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -42317,7 +44885,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-an-organization-owned-project parameters: - - *265 + - *264 - *73 - name: q description: Search query to filter items, see [Filtering projects](https://docs.github.com/issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects) @@ -42350,7 +44918,7 @@ paths: application/json: schema: type: array - items: &272 + items: &271 title: Projects v2 Item description: An item belonging to a project type: object @@ -42367,7 +44935,7 @@ paths: description: The API URL of the project that contains this item. examples: - https://api.github.com/users/monalisa/2/projectsV2/3 - content_type: *269 + content_type: *268 content: type: - object @@ -42417,7 +44985,7 @@ paths: - updated_at - archived_at examples: - default: &273 + default: &272 value: id: 13 node_id: PVTI_lAAFAQ0 @@ -43115,7 +45683,7 @@ paths: url: https://docs.github.com/rest/projects/items#add-item-to-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -43185,22 +45753,22 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *271 + value: *270 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *271 + value: *270 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *271 + value: *270 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *271 + value: *270 '304': *35 '403': *27 '401': *23 @@ -43220,9 +45788,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#get-an-item-for-an-organization-owned-project parameters: - - *265 + - *264 - *73 - - &274 + - &273 name: item_id description: The unique identifier of the project item. in: path @@ -43248,9 +45816,9 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -43271,9 +45839,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#update-project-item-for-organization parameters: - - *265 + - *264 - *73 - - *274 + - *273 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -43346,13 +45914,13 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - text_field: *273 - number_field: *273 - date_field: *273 - single_select_field: *273 - iteration_field: *273 + text_field: *272 + number_field: *272 + date_field: *272 + single_select_field: *272 + iteration_field: *272 '401': *23 '403': *27 '404': *6 @@ -43372,9 +45940,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#delete-project-item-for-organization parameters: - - *265 + - *264 - *73 - - *274 + - *273 responses: '204': description: Response @@ -43398,7 +45966,7 @@ paths: url: https://docs.github.com/rest/projects/views#create-a-view-for-an-organization-owned-project parameters: - *73 - - *265 + - *264 requestBody: required: true content: @@ -43472,7 +46040,7 @@ paths: description: Response for creating a view in an organization-owned project. content: application/json: - schema: &678 + schema: &677 title: Projects v2 View description: A view inside a projects v2 project type: object @@ -43576,7 +46144,7 @@ paths: examples: table_view: summary: Response for creating a table view - value: &275 + value: &274 value: id: 1 number: 1 @@ -43622,10 +46190,10 @@ paths: - 456 board_view: summary: Response for creating a board view with filter - value: *275 + value: *274 roadmap_view: summary: Response for creating a roadmap view - value: *275 + value: *274 '304': *35 '403': *27 '401': *23 @@ -43653,9 +46221,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-an-organization-project-view parameters: - - *265 + - *264 - *73 - - &698 + - &697 name: view_number description: The number that identifies the project view. in: path @@ -43687,9 +46255,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -43722,7 +46290,7 @@ paths: application/json: schema: type: array - items: &276 + items: &275 title: Organization Custom Property description: Custom property defined on an organization type: object @@ -43800,7 +46368,7 @@ paths: - property_name - value_type examples: - default: &277 + default: &276 value: - property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -43860,7 +46428,7 @@ paths: properties: type: array description: The array of custom properties to create or update. - items: *276 + items: *275 minItems: 1 maxItems: 100 required: @@ -43890,9 +46458,9 @@ paths: application/json: schema: type: array - items: *276 + items: *275 examples: - default: *277 + default: *276 '403': *27 '404': *6 x-github: @@ -43914,7 +46482,7 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#get-a-custom-property-for-an-organization parameters: - *73 - - &278 + - &277 name: custom_property_name description: The custom property name in: path @@ -43926,9 +46494,9 @@ paths: description: Response content: application/json: - schema: *276 + schema: *275 examples: - default: &279 + default: &278 value: property_name: environment url: https://api.github.com/orgs/github/properties/schema/environment @@ -43963,7 +46531,7 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#create-or-update-a-custom-property-for-an-organization parameters: - *73 - - *278 + - *277 requestBody: required: true content: @@ -44043,9 +46611,9 @@ paths: description: Response content: application/json: - schema: *276 + schema: *275 examples: - default: *279 + default: *278 '403': *27 '404': *6 x-github: @@ -44069,9 +46637,9 @@ paths: url: https://docs.github.com/rest/orgs/custom-properties#remove-a-custom-property-for-an-organization parameters: - *73 - - *278 + - *277 responses: - '204': *184 + '204': *183 '403': *27 '404': *6 x-github: @@ -44133,7 +46701,7 @@ paths: - octocat/Hello-World properties: type: array - items: &280 + items: &279 title: Custom Property Value description: Custom property name and associated value type: object @@ -44223,7 +46791,7 @@ paths: type: array description: List of custom property names and associated values to apply to the repositories. - items: *280 + items: *279 required: - repository_names - properties @@ -44413,9 +46981,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -44618,7 +47186,7 @@ paths: description: Response content: application/json: - schema: &328 + schema: &327 title: Full Repository description: Full Repository type: object @@ -45096,7 +47664,7 @@ paths: description: Whether anonymous git access is allowed. default: true type: boolean - code_of_conduct: &465 + code_of_conduct: &464 title: Code Of Conduct Simple description: Code of Conduct Simple type: object @@ -45126,7 +47694,7 @@ paths: - key - name - html_url - security_and_analysis: *281 + security_and_analysis: *280 custom_properties: type: object description: The custom properties that were defined for the repository. @@ -45221,7 +47789,7 @@ paths: has_downloads: version: '2026-03-10' examples: - default: &330 + default: &329 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -45748,7 +48316,7 @@ paths: - *73 - *17 - *19 - - &584 + - &583 name: targets description: | A comma-separated list of rule targets to filter by. @@ -45767,7 +48335,7 @@ paths: application/json: schema: type: array - items: &308 + items: &307 title: Repository ruleset type: object description: A set of rules to apply when specified conditions are @@ -45802,7 +48370,7 @@ paths: source: type: string description: The name of the source - enforcement: &284 + enforcement: &283 type: string description: The enforcement level of the ruleset. `evaluate` allows admins to test rules before enforcing them. Admins @@ -45815,7 +48383,7 @@ paths: bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: &285 + items: &284 title: Repository Ruleset Bypass Actor type: object description: An actor that can bypass rules in a ruleset @@ -45886,7 +48454,7 @@ paths: description: The html URL of the ruleset conditions: anyOf: - - &282 + - &281 title: Repository ruleset conditions for ref names type: object description: Parameters for a repository ruleset ref name @@ -45910,7 +48478,7 @@ paths: match. items: type: string - - &286 + - &285 title: Organization ruleset conditions type: object description: |- @@ -45924,7 +48492,7 @@ paths: description: Conditions to target repositories by name and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository names type: object description: Parameters for a repository name condition @@ -45958,7 +48526,7 @@ paths: description: Conditions to target repositories by id and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository IDs type: object description: Parameters for a repository ID condition @@ -45980,7 +48548,7 @@ paths: description: Conditions to target repositories by property and refs by name allOf: - - *282 + - *281 - title: Repository ruleset conditions for repository properties type: object description: Parameters for a repository property condition @@ -45993,7 +48561,7 @@ paths: description: The repository properties and values to include. All of these properties must match for the condition to pass. - items: &283 + items: &282 title: Repository ruleset property targeting definition type: object @@ -46026,7 +48594,7 @@ paths: description: The repository properties and values to exclude. The condition will not pass if any of these properties match. - items: *283 + items: *282 required: - repository_property type: @@ -46034,12 +48602,12 @@ paths: - object rules: type: array - items: &585 + items: &584 title: Repository Rule type: object description: A repository rule. oneOf: - - &287 + - &286 title: creation description: Only allow users with bypass permission to create matching refs. @@ -46051,7 +48619,7 @@ paths: type: string enum: - creation - - &288 + - &287 title: update description: Only allow users with bypass permission to update matching refs. @@ -46072,7 +48640,7 @@ paths: repository required: - update_allows_fetch_and_merge - - &289 + - &288 title: deletion description: Only allow users with bypass permissions to delete matching refs. @@ -46084,7 +48652,7 @@ paths: type: string enum: - deletion - - &290 + - &289 title: required_linear_history description: Prevent merge commits from being pushed to matching refs. @@ -46096,7 +48664,7 @@ paths: type: string enum: - required_linear_history - - &583 + - &582 title: merge_queue description: Merges must be performed via a merge queue. type: object @@ -46174,7 +48742,7 @@ paths: - merge_method - min_entries_to_merge - min_entries_to_merge_wait_minutes - - &291 + - &290 title: required_deployments description: Choose which environments must be successfully deployed to before refs can be pushed into a ref that @@ -46198,7 +48766,7 @@ paths: type: string required: - required_deployment_environments - - &292 + - &291 title: required_signatures description: Commits pushed to matching refs must have verified signatures. @@ -46210,7 +48778,7 @@ paths: type: string enum: - required_signatures - - &293 + - &292 title: pull_request description: Require all commits be made to a non-target branch and submitted via a pull request before they can @@ -46316,7 +48884,7 @@ paths: - require_last_push_approval - required_approving_review_count - required_review_thread_resolution - - &294 + - &293 title: required_status_checks description: Choose which status checks must pass before the ref is updated. When enabled, commits must first be @@ -46364,7 +48932,7 @@ paths: required: - required_status_checks - strict_required_status_checks_policy - - &295 + - &294 title: non_fast_forward description: Prevent users with push access from force pushing to refs. @@ -46376,7 +48944,7 @@ paths: type: string enum: - non_fast_forward - - &296 + - &295 title: commit_message_pattern description: Parameters to be used for the commit_message_pattern rule @@ -46413,7 +48981,7 @@ paths: required: - operator - pattern - - &297 + - &296 title: commit_author_email_pattern description: Parameters to be used for the commit_author_email_pattern rule @@ -46450,7 +49018,7 @@ paths: required: - operator - pattern - - &298 + - &297 title: committer_email_pattern description: Parameters to be used for the committer_email_pattern rule @@ -46487,7 +49055,7 @@ paths: required: - operator - pattern - - &299 + - &298 title: branch_name_pattern description: Parameters to be used for the branch_name_pattern rule @@ -46524,7 +49092,7 @@ paths: required: - operator - pattern - - &300 + - &299 title: tag_name_pattern description: Parameters to be used for the tag_name_pattern rule @@ -46561,7 +49129,7 @@ paths: required: - operator - pattern - - &301 + - &300 title: file_path_restriction description: Prevent commits that include changes in specified file and folder paths from being pushed to the commit @@ -46586,7 +49154,7 @@ paths: type: string required: - restricted_file_paths - - &302 + - &301 title: max_file_path_length description: Prevent commits that include file paths that exceed the specified character limit from being pushed @@ -46610,7 +49178,7 @@ paths: maximum: 32767 required: - max_file_path_length - - &303 + - &302 title: file_extension_restriction description: Prevent commits that include files with specified file extensions from being pushed to the commit graph. @@ -46633,7 +49201,7 @@ paths: type: string required: - restricted_file_extensions - - &304 + - &303 title: max_file_size description: Prevent commits with individual files that exceed the specified limit from being pushed to the commit @@ -46658,7 +49226,7 @@ paths: maximum: 100 required: - max_file_size - - &305 + - &304 title: workflows description: Require all changes made to a targeted branch to pass the specified workflows before they can be merged. @@ -46708,7 +49276,7 @@ paths: - repository_id required: - workflows - - &306 + - &305 title: code_scanning description: Choose which tools must provide code scanning results before the reference is updated. When configured, @@ -46769,7 +49337,7 @@ paths: - tool required: - code_scanning_tools - - &307 + - &306 title: copilot_code_review description: Request Copilot code review for new pull requests automatically if the author has access to Copilot code @@ -46868,20 +49436,21 @@ paths: - push - repository default: branch - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *286 + items: *284 + conditions: *285 rules: type: array description: An array of rules within the ruleset. - items: &310 + items: &309 title: Repository Rule type: object description: A repository rule. oneOf: + - *286 - *287 - *288 - *289 @@ -46902,7 +49471,6 @@ paths: - *304 - *305 - *306 - - *307 required: - name - enforcement @@ -46940,9 +49508,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: &309 + default: &308 value: id: 21 name: super cool ruleset @@ -46998,7 +49566,7 @@ paths: url: https://docs.github.com/rest/orgs/rule-suites#list-organization-rule-suites parameters: - *73 - - &586 + - &585 name: ref description: The name of the ref. Cannot contain wildcard characters. Optionally prefix with `refs/heads/` to limit to branches or `refs/tags/` to limit @@ -47013,7 +49581,7 @@ paths: in: query schema: type: string - - &587 + - &586 name: time_period description: |- The time period to filter by. @@ -47029,14 +49597,14 @@ paths: - week - month default: day - - &588 + - &587 name: actor_name description: The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned. in: query schema: type: string - - &589 + - &588 name: rule_suite_result description: The rule suite results to filter on. When specified, only suites with this result will be returned. @@ -47056,7 +49624,7 @@ paths: description: Response content: application/json: - schema: &590 + schema: &589 title: Rule Suites description: Response type: array @@ -47112,7 +49680,7 @@ paths: whether rules would pass or fail if all rules in the rule suite were `active`. examples: - default: &591 + default: &590 value: - id: 21 actor_id: 12 @@ -47156,7 +49724,7 @@ paths: url: https://docs.github.com/rest/orgs/rule-suites#get-an-organization-rule-suite parameters: - *73 - - &592 + - &591 name: rule_suite_id description: |- The unique identifier of the rule suite result. @@ -47172,7 +49740,7 @@ paths: description: Response content: application/json: - schema: &593 + schema: &592 title: Rule Suite description: Response type: object @@ -47279,7 +49847,7 @@ paths: description: The detailed failure message for the rule. Null if the rule passed. examples: - default: &594 + default: &593 value: id: 21 actor_id: 12 @@ -47352,9 +49920,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *309 + default: *308 '404': *6 '500': *53 put: @@ -47398,16 +49966,16 @@ paths: - tag - push - repository - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *286 + items: *284 + conditions: *285 rules: description: An array of rules within the ruleset. type: array - items: *310 + items: *309 examples: default: value: @@ -47442,9 +50010,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *309 + default: *308 '404': *6 '422': *15 '500': *53 @@ -47502,7 +50070,7 @@ paths: application/json: schema: type: array - items: &311 + items: &310 title: Ruleset version type: object description: The historical version of a ruleset @@ -47526,7 +50094,7 @@ paths: type: string format: date-time examples: - default: &596 + default: &595 value: - version_id: 3 actor: @@ -47579,9 +50147,9 @@ paths: description: Response content: application/json: - schema: &597 + schema: &596 allOf: - - *311 + - *310 - type: object required: - state @@ -47651,7 +50219,7 @@ paths: url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization parameters: - *73 - - &598 + - &597 name: state in: query description: Set to `open` or `resolved` to only list secret scanning alerts @@ -47662,7 +50230,7 @@ paths: enum: - open - resolved - - &599 + - &598 name: secret_type in: query description: A comma-separated list of secret types to return. All default @@ -47672,7 +50240,7 @@ paths: required: false schema: type: string - - &600 + - &599 name: resolution in: query description: A comma-separated list of resolutions. Only secret scanning alerts @@ -47681,7 +50249,7 @@ paths: required: false schema: type: string - - &601 + - &600 name: assignee in: query description: Filters alerts by assignee. Use `*` to get all assigned alerts, @@ -47700,7 +50268,7 @@ paths: all-unassigned: value: none summary: Filter for all unassigned alerts - - &602 + - &601 name: sort description: The property to sort the results by. `created` means when the alert was created. `updated` means when the alert was updated or resolved. @@ -47715,7 +50283,7 @@ paths: - *59 - *19 - *17 - - &603 + - &602 name: before description: A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. To @@ -47725,7 +50293,7 @@ paths: required: false schema: type: string - - &604 + - &603 name: after description: A cursor, as given in the [Link header](https://docs.github.com/rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. To @@ -47735,7 +50303,7 @@ paths: required: false schema: type: string - - &605 + - &604 name: validity in: query description: A comma-separated list of validities that, when present, will @@ -47744,7 +50312,7 @@ paths: required: false schema: type: string - - &606 + - &605 name: is_publicly_leaked in: query description: A boolean value representing whether or not to filter alerts @@ -47753,7 +50321,7 @@ paths: schema: type: boolean default: false - - &607 + - &606 name: is_multi_repo in: query description: A boolean value representing whether or not to filter alerts @@ -47762,7 +50330,7 @@ paths: schema: type: boolean default: false - - &608 + - &607 name: hide_secret in: query description: A boolean value representing whether or not to hide literal secrets @@ -47781,27 +50349,27 @@ paths: items: type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: &609 + state: &608 description: Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`. type: string enum: - open - resolved - resolution: &610 + resolution: &609 type: - string - 'null' @@ -47908,14 +50476,14 @@ paths: first_location_detected: anyOf: - type: 'null' - - &611 + - &610 description: 'Details on the location where the token was initially detected. This can be a commit, wiki commit, issue, discussion, pull request. ' oneOf: - - &613 + - &612 description: Represents a 'commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository. @@ -47962,6 +50530,13 @@ paths: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit + resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -47972,7 +50547,7 @@ paths: - blob_url - commit_sha - commit_url - - &614 + - &613 description: Represents a 'wiki_commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository wiki. @@ -48033,7 +50608,7 @@ paths: - page_url - commit_sha - commit_url - - &615 + - &614 description: Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue. @@ -48046,9 +50621,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url - - &616 + - &615 description: Represents an 'issue_body' secret scanning location type. This location type shows that a secret was detected in the body of an issue. @@ -48061,9 +50643,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url - - &617 + - &616 description: Represents an 'issue_comment' secret scanning location type. This location type shows that a secret was detected in a comment on an issue. @@ -48076,9 +50665,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url - - &618 + - &617 description: Represents a 'discussion_title' secret scanning location type. This location type shows that a secret was detected in the title of a discussion. @@ -48093,7 +50689,7 @@ paths: - https://github.com/community/community/discussions/39082 required: - discussion_title_url - - &619 + - &618 description: Represents a 'discussion_body' secret scanning location type. This location type shows that a secret was detected in the body of a discussion. @@ -48108,7 +50704,7 @@ paths: - https://github.com/community/community/discussions/39082#discussion-4566270 required: - discussion_body_url - - &620 + - &619 description: Represents a 'discussion_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a discussion. @@ -48123,7 +50719,7 @@ paths: - https://github.com/community/community/discussions/39082#discussioncomment-4158232 required: - discussion_comment_url - - &621 + - &620 description: Represents a 'pull_request_title' secret scanning location type. This location type shows that a secret was detected in the title of a pull request. @@ -48136,9 +50732,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url - - &622 + - &621 description: Represents a 'pull_request_body' secret scanning location type. This location type shows that a secret was detected in the body of a pull request. @@ -48151,9 +50754,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url - - &623 + - &622 description: Represents a 'pull_request_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a pull request. @@ -48166,9 +50776,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url - - &624 + - &623 description: Represents a 'pull_request_review' secret scanning location type. This location type shows that a secret was detected in a review on a pull request. @@ -48181,9 +50798,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url - - &625 + - &624 description: Represents a 'pull_request_review_comment' secret scanning location type. This location type shows that a secret was detected in a review comment on a pull @@ -48197,6 +50821,13 @@ paths: comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url has_more_locations: @@ -48423,7 +51054,7 @@ paths: related to push protection. type: object properties: - pattern_config_version: &313 + pattern_config_version: &312 type: - string - 'null' @@ -48433,7 +51064,7 @@ paths: provider_pattern_overrides: type: array description: Overrides for partner patterns. - items: &312 + items: &311 type: object properties: token_type: @@ -48502,7 +51133,7 @@ paths: custom_pattern_overrides: type: array description: Overrides for custom patterns defined by the organization. - items: *312 + items: *311 examples: default: value: @@ -48559,7 +51190,7 @@ paths: schema: type: object properties: - pattern_config_version: *313 + pattern_config_version: *312 provider_pattern_settings: type: array description: Pattern settings for provider patterns. @@ -48585,7 +51216,7 @@ paths: token_type: type: string description: The ID of the pattern to configure. - custom_pattern_version: *313 + custom_pattern_version: *312 push_protection_setting: type: string description: Push protection setting to set for the pattern. @@ -48683,7 +51314,7 @@ paths: application/json: schema: type: array - items: &629 + items: &628 description: A repository security advisory. type: object properties: @@ -48927,7 +51558,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 credits_detailed: type: - array @@ -48938,7 +51569,7 @@ paths: type: object properties: user: *4 - type: *314 + type: *313 state: type: string description: The state of the user's acceptance of the @@ -48964,7 +51595,7 @@ paths: - array - 'null' description: A list of teams that collaborate on the advisory. - items: *188 + items: *187 private_fork: readOnly: true description: A temporary private fork of the advisory's repository @@ -49034,7 +51665,7 @@ paths: - private_fork version: '2026-03-10' examples: - default: &630 + default: &629 value: - ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -49421,7 +52052,7 @@ paths: application/json: schema: type: array - items: *245 + items: *244 examples: default: value: @@ -49641,9 +52272,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *165 + default: *164 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -49712,7 +52343,7 @@ paths: url: https://docs.github.com/rest/orgs/orgs#enable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -49735,7 +52366,7 @@ paths: url: https://docs.github.com/rest/orgs/orgs#disable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *73 - - *142 + - *141 responses: '204': description: Response @@ -49776,7 +52407,7 @@ paths: type: integer network_configurations: type: array - items: &315 + items: &314 title: Hosted compute network configuration description: A hosted compute network configuration. type: object @@ -49901,6 +52532,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -49916,9 +52560,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: &316 + default: &315 value: id: 123456789ABCDEF name: My network configuration @@ -49947,7 +52591,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#get-a-hosted-compute-network-configuration-for-an-organization parameters: - *73 - - &317 + - &316 name: network_configuration_id description: Unique identifier of the hosted compute network configuration. in: path @@ -49959,9 +52603,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: *316 + default: *315 headers: Link: *65 x-github: @@ -49983,7 +52627,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#update-a-hosted-compute-network-configuration-for-an-organization parameters: - *73 - - *317 + - *316 requestBody: required: true content: @@ -50011,6 +52655,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -50023,9 +52680,9 @@ paths: description: Response content: application/json: - schema: *315 + schema: *314 examples: - default: *316 + default: *315 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -50045,7 +52702,7 @@ paths: url: https://docs.github.com/rest/orgs/network-configurations#delete-a-hosted-compute-network-configuration-from-an-organization parameters: - *73 - - *317 + - *316 responses: '204': description: Response @@ -50190,13 +52847,13 @@ paths: application/json: schema: type: array - items: *318 + items: *317 examples: - default: *319 + default: *318 '500': *53 '403': *27 '404': *6 - '422': *320 + '422': *319 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -50236,9 +52893,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 headers: Link: *65 '403': *27 @@ -50332,7 +52989,7 @@ paths: description: Response content: application/json: - schema: &321 + schema: &320 title: Full Team description: Groups of organization members that gives permissions on specified repositories. @@ -50406,7 +53063,7 @@ paths: parent: anyOf: - type: 'null' - - *245 + - *244 members_count: type: integer examples: @@ -50731,7 +53388,7 @@ paths: - repos_count - organization examples: - default: &322 + default: &321 value: id: 1 node_id: MDQ6VGVhbTE= @@ -50819,9 +53476,9 @@ paths: description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 x-github: githubCloudOnly: false @@ -50906,16 +53563,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '201': description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 '422': *15 '403': *27 @@ -50945,7 +53602,7 @@ paths: responses: '204': description: Response - '422': &323 + '422': &322 description: Unprocessable entity if you attempt to modify an enterprise team at the organization level. x-github: @@ -50979,12 +53636,12 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 - '422': *323 + '422': *322 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -51066,7 +53723,7 @@ paths: description: Response content: application/json: - schema: &324 + schema: &323 title: Team Membership description: Team Membership type: object @@ -51094,7 +53751,7 @@ paths: - state - url examples: - response-if-user-is-a-team-maintainer: &646 + response-if-user-is-a-team-maintainer: &645 summary: Response if user is a team maintainer value: url: https://api.github.com/teams/1/memberships/octocat @@ -51157,9 +53814,9 @@ paths: description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-users-membership-with-team-is-now-pending: &647 + response-if-users-membership-with-team-is-now-pending: &646 summary: Response if user's membership with team is now pending value: url: https://api.github.com/teams/1/memberships/octocat @@ -51233,9 +53890,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -51266,14 +53923,14 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 responses: '200': description: Alternative response with repository permissions content: application/json: - schema: &648 + schema: &647 title: Team Repository description: A team's access to a repository. type: object @@ -51995,8 +54652,8 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 requestBody: required: false content: @@ -52043,8 +54700,8 @@ paths: parameters: - *73 - *75 + - *324 - *325 - - *326 responses: '204': description: Response @@ -52079,9 +54736,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - response-if-child-teams-exist: &649 + response-if-child-teams-exist: &648 value: - id: 2 node_id: MDQ6VGVhbTI= @@ -52235,7 +54892,7 @@ paths: resources: type: object properties: - core: &327 + core: &326 title: Rate Limit type: object properties: @@ -52252,21 +54909,21 @@ paths: - remaining - reset - used - graphql: *327 - search: *327 - code_search: *327 - source_import: *327 - integration_manifest: *327 - code_scanning_upload: *327 - actions_runner_registration: *327 - scim: *327 - dependency_snapshots: *327 - dependency_sbom: *327 - code_scanning_autofix: *327 + graphql: *326 + search: *326 + code_search: *326 + source_import: *326 + integration_manifest: *326 + code_scanning_upload: *326 + actions_runner_registration: *326 + scim: *326 + dependency_snapshots: *326 + dependency_sbom: *326 + code_scanning_autofix: *326 required: - core - search - rate: *327 + rate: *326 required: - rate - resources @@ -52379,14 +55036,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#get-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *328 + schema: *327 examples: default-response: summary: Default response @@ -52891,7 +55548,7 @@ paths: status: disabled '403': *27 '404': *6 - '301': *329 + '301': *328 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -52909,8 +55566,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#update-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -53202,10 +55859,10 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 - '307': &331 + default: *329 + '307': &330 description: Temporary Redirect content: application/json: @@ -53234,8 +55891,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#delete-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -53257,7 +55914,7 @@ paths: value: message: Organization members cannot delete repositories. documentation_url: https://docs.github.com/rest/repos/repos#delete-a-repository - '307': *331 + '307': *330 '404': *6 '409': *52 x-github: @@ -53281,11 +55938,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#list-artifacts-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 - - &364 + - &363 name: name description: The name field of an artifact. When specified, only artifacts with this name will be returned. @@ -53308,7 +55965,7 @@ paths: type: integer artifacts: type: array - items: &332 + items: &331 title: Artifact description: An artifact type: object @@ -53403,7 +56060,7 @@ paths: - expires_at - updated_at examples: - default: &365 + default: &364 value: total_count: 2 artifacts: @@ -53464,9 +56121,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#get-an-artifact parameters: + - *324 - *325 - - *326 - - &333 + - &332 name: artifact_id description: The unique identifier of the artifact. in: path @@ -53478,7 +56135,7 @@ paths: description: Response content: application/json: - schema: *332 + schema: *331 examples: default: value: @@ -53516,9 +56173,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#delete-an-artifact parameters: + - *324 - *325 - - *326 - - *333 + - *332 responses: '204': description: Response @@ -53542,9 +56199,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#download-an-artifact parameters: + - *324 - *325 - - *326 - - *333 + - *332 - name: archive_format in: path required: true @@ -53558,7 +56215,7 @@ paths: example: https://pipelines.actions.githubusercontent.com/OhgS4QRKqmgx7bKC27GKU83jnQjyeqG8oIMTge8eqtheppcmw8/_apis/pipelines/1/runs/176/signedlogcontent?urlExpires=2020-01-24T18%3A10%3A31.5729946Z&urlSigningMethod=HMACV1&urlSignature=agG73JakPYkHrh06seAkvmH7rBR4Ji4c2%2B6a2ejYh3E%3D schema: type: string - '410': &520 + '410': &519 description: Gone content: application/json: @@ -53583,14 +56240,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-retention-limit-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &334 + schema: &333 title: Actions cache retention limit for a repository description: GitHub Actions cache retention policy for a repository. type: object @@ -53624,13 +56281,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#set-github-actions-cache-retention-limit-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *334 + schema: *333 examples: selected_actions: *40 responses: @@ -53659,14 +56316,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-storage-limit-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &335 + schema: &334 title: Actions cache storage limit for a repository description: GitHub Actions cache storage policy for a repository. type: object @@ -53700,13 +56357,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#set-github-actions-cache-storage-limit-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *335 + schema: *334 examples: selected_actions: *42 responses: @@ -53737,14 +56394,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#get-github-actions-cache-usage-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *336 + schema: *335 examples: default: value: @@ -53770,11 +56427,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#list-github-actions-caches-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 - - &337 + - &336 name: ref description: The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/`. To reference @@ -53808,7 +56465,7 @@ paths: description: Response content: application/json: - schema: &338 + schema: &337 title: Repository actions caches description: Repository actions caches type: object @@ -53858,7 +56515,7 @@ paths: - total_count - actions_caches examples: - default: &339 + default: &338 value: total_count: 1 actions_caches: @@ -53890,23 +56547,23 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#delete-github-actions-caches-for-a-repository-using-a-cache-key parameters: + - *324 - *325 - - *326 - name: key description: A key for identifying the cache. in: query required: true schema: type: string - - *337 + - *336 responses: '200': description: Response content: application/json: - schema: *338 + schema: *337 examples: - default: *339 + default: *338 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -53926,8 +56583,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/cache#delete-a-github-actions-cache-for-a-repository-using-a-cache-id parameters: + - *324 - *325 - - *326 - name: cache_id description: The unique identifier of the GitHub Actions cache. in: path @@ -53958,9 +56615,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#get-a-job-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - &340 + - &339 name: job_id description: The unique identifier of the job. in: path @@ -53972,7 +56629,7 @@ paths: description: Response content: application/json: - schema: &368 + schema: &367 title: Job description: Information of a job execution in a workflow run type: object @@ -54319,9 +56976,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *340 + - *339 responses: '302': description: Response @@ -54349,9 +57006,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run parameters: + - *324 - *325 - - *326 - - *340 + - *339 requestBody: required: false content: @@ -54373,7 +57030,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -54397,8 +57054,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Status response @@ -54448,8 +57105,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -54483,7 +57140,7 @@ paths: description: Empty response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -54512,8 +57169,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-repository-organization-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -54531,7 +57188,7 @@ paths: type: integer secrets: type: array - items: &370 + items: &369 title: Actions Secret description: Set secrets for GitHub Actions. type: object @@ -54552,7 +57209,7 @@ paths: - created_at - updated_at examples: - default: &371 + default: &370 value: total_count: 2 secrets: @@ -54585,9 +57242,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-repository-organization-variables parameters: + - *324 - *325 - - *326 - - *341 + - *340 - *19 responses: '200': @@ -54604,7 +57261,7 @@ paths: type: integer variables: type: array - items: &374 + items: &373 title: Actions Variable type: object properties: @@ -54638,7 +57295,7 @@ paths: - created_at - updated_at examples: - default: &375 + default: &374 value: total_count: 2 variables: @@ -54671,8 +57328,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-github-actions-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -54681,12 +57338,12 @@ paths: schema: type: object properties: - enabled: &343 + enabled: &342 type: boolean description: Whether GitHub Actions is enabled on the repository. - allowed_actions: *138 - selected_actions_url: *342 - sha_pinning_required: *139 + allowed_actions: *137 + selected_actions_url: *341 + sha_pinning_required: *138 required: - enabled examples: @@ -54714,8 +57371,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-github-actions-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -54726,9 +57383,9 @@ paths: schema: type: object properties: - enabled: *343 - allowed_actions: *138 - sha_pinning_required: *139 + enabled: *342 + allowed_actions: *137 + sha_pinning_required: *138 required: - enabled examples: @@ -54758,14 +57415,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &344 + schema: &343 type: object properties: access_level: @@ -54782,7 +57439,7 @@ paths: required: - access_level examples: - default: &345 + default: &344 value: access_level: organization x-github: @@ -54806,15 +57463,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *344 + schema: *343 examples: - default: *345 + default: *344 responses: '204': description: Response @@ -54838,14 +57495,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-artifact-and-log-retention-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *346 + schema: *345 examples: default: value: @@ -54869,8 +57526,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-artifact-and-log-retention-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Empty response for successful settings update @@ -54880,7 +57537,7 @@ paths: required: true content: application/json: - schema: *347 + schema: *346 examples: default: summary: Set retention days @@ -54904,16 +57561,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *140 + schema: *139 examples: - default: *348 + default: *347 '404': *6 x-github: enabledForGitHubApps: true @@ -54932,8 +57589,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -54943,7 +57600,7 @@ paths: required: true content: application/json: - schema: *140 + schema: *139 examples: default: summary: Set approval policy to first time contributors @@ -54967,16 +57624,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *349 + schema: *348 examples: - default: *141 + default: *140 '403': *27 '404': *6 x-github: @@ -54996,15 +57653,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *350 + schema: *349 examples: - default: *141 + default: *140 responses: '204': description: Empty response for successful settings update @@ -55028,16 +57685,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *143 + schema: *142 examples: - default: *144 + default: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -55056,8 +57713,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -55065,9 +57722,9 @@ paths: required: false content: application/json: - schema: *143 + schema: *142 examples: - selected_actions: *144 + selected_actions: *143 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -55089,16 +57746,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#get-default-workflow-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *351 + schema: *350 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55119,8 +57776,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/permissions#set-default-workflow-permissions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Success response @@ -55131,9 +57788,9 @@ paths: required: true content: application/json: - schema: *352 + schema: *351 examples: - default: *148 + default: *147 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55160,8 +57817,8 @@ paths: in: query schema: type: string + - *324 - *325 - - *326 - *17 - *19 responses: @@ -55179,9 +57836,9 @@ paths: type: integer runners: type: array - items: *155 + items: *154 examples: - default: *156 + default: *155 headers: Link: *65 x-github: @@ -55205,8 +57862,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#list-runner-applications-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -55214,9 +57871,9 @@ paths: application/json: schema: type: array - items: *353 + items: *352 examples: - default: *354 + default: *353 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55238,8 +57895,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -55282,7 +57939,7 @@ paths: - no-gpu work_folder: _work responses: - '201': *355 + '201': *354 '404': *6 '422': *7 '409': *52 @@ -55313,16 +57970,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-a-registration-token-for-a-repository parameters: + - *324 - *325 - - *326 responses: '201': description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: *356 + default: *355 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55350,16 +58007,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#create-a-remove-token-for-a-repository parameters: + - *324 - *325 - - *326 responses: '201': description: Response content: application/json: - schema: *157 + schema: *156 examples: - default: *357 + default: *356 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55381,17 +58038,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: '200': description: Response content: application/json: - schema: *155 + schema: *154 examples: - default: *358 + default: *357 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -55412,9 +58069,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: '204': description: Response @@ -55440,11 +58097,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: - '200': *159 + '200': *158 '404': *6 x-github: githubCloudOnly: false @@ -55466,9 +58123,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 requestBody: required: true content: @@ -55492,7 +58149,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -55516,9 +58173,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 requestBody: required: true content: @@ -55543,7 +58200,7 @@ paths: - gpu - accelerated responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -55567,11 +58224,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 + - *153 responses: - '200': *359 + '200': *358 '404': *6 x-github: githubCloudOnly: false @@ -55598,12 +58255,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-a-repository parameters: + - *324 - *325 - - *326 - - *154 - - *360 + - *153 + - *359 responses: - '200': *159 + '200': *158 '404': *6 '422': *7 x-github: @@ -55629,9 +58286,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#list-workflow-runs-for-a-repository parameters: + - *324 - *325 - - *326 - - &378 + - &377 name: actor description: Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. @@ -55639,7 +58296,7 @@ paths: required: false schema: type: string - - &379 + - &378 name: branch description: Returns workflow runs associated with a branch. Use the name of the branch of the `push`. @@ -55647,7 +58304,7 @@ paths: required: false schema: type: string - - &380 + - &379 name: event description: Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events @@ -55656,7 +58313,7 @@ paths: required: false schema: type: string - - &381 + - &380 name: status description: Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status @@ -55683,7 +58340,7 @@ paths: - pending - *17 - *19 - - &382 + - &381 name: created description: Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." @@ -55692,7 +58349,7 @@ paths: schema: type: string format: date-time - - &361 + - &360 name: exclude_pull_requests description: If `true` pull requests are omitted from the response (empty array). @@ -55701,13 +58358,13 @@ paths: schema: type: boolean default: false - - &383 + - &382 name: check_suite_id description: Returns workflow runs with the `check_suite_id` that you specify. in: query schema: type: integer - - &384 + - &383 name: head_sha description: Only returns workflow runs that are associated with the specified `head_sha`. @@ -55730,7 +58387,7 @@ paths: type: integer workflow_runs: type: array - items: &362 + items: &361 title: Workflow Run description: An invocation of a workflow type: object @@ -55908,7 +58565,7 @@ paths: head_commit: anyOf: - type: 'null' - - &406 + - &405 title: Simple Commit description: A commit. type: object @@ -55982,8 +58639,8 @@ paths: - timestamp - author - committer - repository: *153 - head_repository: *153 + repository: *152 + head_repository: *152 head_repository_id: type: integer examples: @@ -56023,7 +58680,7 @@ paths: - workflow_url - pull_requests examples: - default: &385 + default: &384 value: total_count: 1 workflow_runs: @@ -56259,24 +58916,24 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-a-workflow-run parameters: + - *324 - *325 - - *326 - - &363 + - &362 name: run_id description: The unique identifier of the workflow run. in: path required: true schema: type: integer - - *361 + - *360 responses: '200': description: Response content: application/json: - schema: *362 + schema: *361 examples: - default: &366 + default: &365 value: id: 30433642 name: Build @@ -56517,9 +59174,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#delete-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '204': description: Response @@ -56542,9 +59199,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-the-review-history-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -56672,15 +59329,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#approve-a-workflow-run-for-a-fork-pull-request parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56707,12 +59364,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/artifacts#list-workflow-run-artifacts parameters: + - *324 - *325 - - *326 - - *363 + - *362 - *17 - *19 - - *364 + - *363 - *59 responses: '200': @@ -56729,9 +59386,9 @@ paths: type: integer artifacts: type: array - items: *332 + items: *331 examples: - default: *365 + default: *364 headers: Link: *65 x-github: @@ -56755,25 +59412,25 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-a-workflow-run-attempt parameters: + - *324 - *325 - - *326 - - *363 - - &367 + - *362 + - &366 name: attempt_number description: The attempt number of the workflow run. in: path required: true schema: type: integer - - *361 + - *360 responses: '200': description: Response content: application/json: - schema: *362 + schema: *361 examples: - default: *366 + default: *365 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -56796,10 +59453,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run-attempt parameters: + - *324 - *325 - - *326 - - *363 - - *367 + - *362 + - *366 - *17 - *19 responses: @@ -56817,9 +59474,9 @@ paths: type: integer jobs: type: array - items: *368 + items: *367 examples: - default: &369 + default: &368 value: total_count: 1 jobs: @@ -56932,10 +59589,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#download-workflow-run-attempt-logs parameters: + - *324 - *325 - - *326 - - *363 - - *367 + - *362 + - *366 responses: '302': description: Response @@ -56963,15 +59620,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#cancel-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '202': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -56998,9 +59655,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: true content: @@ -57067,15 +59724,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#force-cancel-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '202': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57102,9 +59759,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-jobs#list-jobs-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 - name: filter description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all @@ -57134,9 +59791,9 @@ paths: type: integer jobs: type: array - items: *368 + items: *367 examples: - default: *369 + default: *368 headers: Link: *65 x-github: @@ -57161,9 +59818,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#download-workflow-run-logs parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '302': description: Response @@ -57190,9 +59847,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#delete-workflow-run-logs parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '204': description: Response @@ -57219,9 +59876,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -57290,7 +59947,7 @@ paths: items: type: object properties: - type: &486 + type: &485 type: string description: The type of reviewer. enum: @@ -57301,7 +59958,7 @@ paths: reviewer: anyOf: - *4 - - *188 + - *187 required: - environment - wait_timer @@ -57376,9 +60033,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: true content: @@ -57428,7 +60085,7 @@ paths: application/json: schema: type: array - items: &481 + items: &480 title: Deployment description: A request for a specific ref(branch,sha,tag) to be deployed @@ -57540,7 +60197,7 @@ paths: - created_at - updated_at examples: - default: &482 + default: &481 value: - url: https://api.github.com/repos/octocat/example/deployments/1 id: 1 @@ -57596,9 +60253,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-a-workflow parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: false content: @@ -57620,7 +60277,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57643,9 +60300,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#re-run-failed-jobs-from-a-workflow-run parameters: + - *324 - *325 - - *326 - - *363 + - *362 requestBody: required: false content: @@ -57667,7 +60324,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -57699,9 +60356,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#get-workflow-run-usage parameters: + - *324 - *325 - - *326 - - *363 + - *362 responses: '200': description: Response @@ -57838,8 +60495,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -57857,9 +60514,9 @@ paths: type: integer secrets: type: array - items: *370 + items: *369 examples: - default: *371 + default: *370 headers: Link: *65 x-github: @@ -57884,16 +60541,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -57915,17 +60572,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *370 + schema: *369 examples: - default: &499 + default: &498 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -57951,9 +60608,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -57984,7 +60641,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -58010,9 +60667,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -58037,9 +60694,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-repository-variables parameters: + - *324 - *325 - - *326 - - *341 + - *340 - *19 responses: '200': @@ -58056,9 +60713,9 @@ paths: type: integer variables: type: array - items: *374 + items: *373 examples: - default: *375 + default: *374 headers: Link: *65 x-github: @@ -58081,8 +60738,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#create-a-repository-variable parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -58109,7 +60766,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -58134,17 +60791,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#get-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 responses: '200': description: Response content: application/json: - schema: *374 + schema: *373 examples: - default: &500 + default: &499 value: name: USERNAME value: octocat @@ -58170,9 +60827,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#update-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 requestBody: required: true content: @@ -58214,9 +60871,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#delete-a-repository-variable parameters: + - *324 - *325 - - *326 - - *164 + - *163 responses: '204': description: Response @@ -58241,8 +60898,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#list-repository-workflows parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -58260,7 +60917,7 @@ paths: type: integer workflows: type: array - items: &376 + items: &375 title: Workflow description: A GitHub Actions workflow type: object @@ -58378,9 +61035,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#get-a-workflow parameters: + - *324 - *325 - - *326 - - &377 + - &376 name: workflow_id in: path description: The ID of the workflow. You can also pass the workflow file name @@ -58395,7 +61052,7 @@ paths: description: Response content: application/json: - schema: *376 + schema: *375 examples: default: value: @@ -58428,9 +61085,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#disable-a-workflow parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Response @@ -58455,9 +61112,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#create-a-workflow-dispatch-event parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Empty response when `return_run_details` parameter is `false`. @@ -58552,9 +61209,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#enable-a-workflow parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '204': description: Response @@ -58581,19 +61238,19 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflow-runs#list-workflow-runs-for-a-workflow parameters: + - *324 - *325 - - *326 + - *376 - *377 - *378 - *379 - *380 - - *381 - *17 - *19 + - *381 + - *360 - *382 - - *361 - *383 - - *384 responses: '200': description: Response @@ -58609,9 +61266,9 @@ paths: type: integer workflow_runs: type: array - items: *362 + items: *361 examples: - default: *385 + default: *384 headers: Link: *65 x-github: @@ -58643,9 +61300,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/workflows#get-workflow-usage parameters: + - *324 - *325 - - *326 - - *377 + - *376 responses: '200': description: Response @@ -58706,8 +61363,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-activities parameters: + - *324 - *325 - - *326 - *59 - *17 - *45 @@ -58875,8 +61532,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#list-assignees parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -58913,8 +61570,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#check-if-a-user-can-be-assigned parameters: + - *324 - *325 - - *326 - name: assignee in: path required: true @@ -58950,8 +61607,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/attestations#create-an-attestation parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -59061,8 +61718,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/attestations#list-attestations parameters: + - *324 - *325 - - *326 - *17 - *45 - *46 @@ -59119,7 +61776,7 @@ paths: initiator: type: string examples: - default: *386 + default: *385 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -59153,8 +61810,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#get-all-autolinks-of-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -59162,7 +61819,7 @@ paths: application/json: schema: type: array - items: &387 + items: &386 title: Autolink reference description: An autolink reference. type: object @@ -59221,8 +61878,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#create-an-autolink-reference-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -59261,9 +61918,9 @@ paths: description: response content: application/json: - schema: *387 + schema: *386 examples: - default: &388 + default: &387 value: id: 1 key_prefix: TICKET- @@ -59294,9 +61951,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#get-an-autolink-reference-of-a-repository parameters: + - *324 - *325 - - *326 - - &389 + - &388 name: autolink_id description: The unique identifier of the autolink. in: path @@ -59308,9 +61965,9 @@ paths: description: Response content: application/json: - schema: *387 + schema: *386 examples: - default: *388 + default: *387 '404': *6 x-github: githubCloudOnly: false @@ -59330,9 +61987,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/autolinks#delete-an-autolink-reference-from-a-repository parameters: + - *324 - *325 - - *326 - - *389 + - *388 responses: '204': description: Response @@ -59356,8 +62013,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-dependabot-security-updates-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response if Dependabot is enabled @@ -59407,8 +62064,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-dependabot-security-updates parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -59429,8 +62086,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-dependabot-security-updates parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -59450,8 +62107,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#list-branches parameters: + - *324 - *325 - - *326 - name: protected description: Setting to `true` returns only branches protected by branch protections or rulesets. When set to `false`, only unprotected branches are returned. @@ -59489,7 +62146,7 @@ paths: - url protected: type: boolean - protection: &391 + protection: &390 title: Branch Protection description: Branch Protection type: object @@ -59532,7 +62189,7 @@ paths: required: - contexts - checks - enforce_admins: &394 + enforce_admins: &393 title: Protected Branch Admin Enforced description: Protected Branch Admin Enforced type: object @@ -59549,7 +62206,7 @@ paths: required: - url - enabled - required_pull_request_reviews: &396 + required_pull_request_reviews: &395 title: Protected Branch Pull Request Review description: Protected Branch Pull Request Review type: object @@ -59571,7 +62228,7 @@ paths: description: The list of teams with review dismissal access. type: array - items: *188 + items: *187 apps: description: The list of apps with review dismissal access. @@ -59603,7 +62260,7 @@ paths: description: The list of teams allowed to bypass pull request requirements. type: array - items: *188 + items: *187 apps: description: The list of apps allowed to bypass pull request requirements. @@ -59633,7 +62290,7 @@ paths: required: - dismiss_stale_reviews - require_code_owner_reviews - restrictions: &393 + restrictions: &392 title: Branch Restriction Policy description: Branch Restriction Policy type: object @@ -59696,7 +62353,7 @@ paths: type: string teams: type: array - items: *188 + items: *187 apps: type: array items: @@ -59926,9 +62583,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#get-a-branch parameters: + - *324 - *325 - - *326 - - &392 + - &391 name: branch description: The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use [the GraphQL API](https://docs.github.com/graphql). @@ -59942,14 +62599,14 @@ paths: description: Response content: application/json: - schema: &402 + schema: &401 title: Branch With Protection description: Branch With Protection type: object properties: name: type: string - commit: &456 + commit: &455 title: Commit description: Commit type: object @@ -59988,7 +62645,7 @@ paths: author: anyOf: - type: 'null' - - &390 + - &389 title: Git User description: Metaproperties for Git author/committer information. @@ -60010,7 +62667,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 message: type: string examples: @@ -60034,7 +62691,7 @@ paths: required: - sha - url - verification: &506 + verification: &505 title: Verification type: object properties: @@ -60070,14 +62727,14 @@ paths: author: oneOf: - *4 - - *162 + - *161 type: - 'null' - object committer: oneOf: - *4 - - *162 + - *161 type: - 'null' - object @@ -60114,7 +62771,7 @@ paths: type: integer files: type: array - items: &467 + items: &466 title: Diff Entry description: Diff Entry type: object @@ -60210,7 +62867,7 @@ paths: - self protected: type: boolean - protection: *391 + protection: *390 protection_url: type: string format: uri @@ -60319,7 +62976,7 @@ paths: contexts: [] checks: [] protection_url: https://api.github.com/repos/octocat/Hello-World/branches/main/protection - '301': *329 + '301': *328 '404': *6 x-github: githubCloudOnly: false @@ -60341,15 +62998,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *391 + schema: *390 examples: default: value: @@ -60543,9 +63200,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -60805,7 +63462,7 @@ paths: url: type: string format: uri - required_status_checks: &399 + required_status_checks: &398 title: Status Check Policy description: Status Check Policy type: object @@ -60886,7 +63543,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 apps: type: array items: *5 @@ -60904,7 +63561,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 apps: type: array items: *5 @@ -60964,7 +63621,7 @@ paths: additionalProperties: false required: - enabled - restrictions: *393 + restrictions: *392 required_conversation_resolution: type: object properties: @@ -61076,9 +63733,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61103,17 +63760,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: &395 + default: &394 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins enabled: true @@ -61135,17 +63792,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: *395 + default: *394 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -61164,9 +63821,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-admin-branch-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61191,17 +63848,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *396 + schema: *395 examples: - default: &397 + default: &396 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews dismissal_restrictions: @@ -61297,9 +63954,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61397,9 +64054,9 @@ paths: description: Response content: application/json: - schema: *396 + schema: *395 examples: - default: *397 + default: *396 '422': *15 x-github: githubCloudOnly: false @@ -61420,9 +64077,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-pull-request-review-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61449,17 +64106,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: &398 + default: &397 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_signatures enabled: true @@ -61482,17 +64139,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#create-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *394 + schema: *393 examples: - default: *398 + default: *397 '404': *6 x-github: githubCloudOnly: false @@ -61512,9 +64169,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-commit-signature-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61539,17 +64196,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-status-checks-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *399 + schema: *398 examples: - default: &400 + default: &399 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks strict: true @@ -61575,9 +64232,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#update-status-check-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61629,9 +64286,9 @@ paths: description: Response content: application/json: - schema: *399 + schema: *398 examples: - default: *400 + default: *399 '404': *6 '422': *15 x-github: @@ -61653,9 +64310,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-status-check-protection parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -61679,9 +64336,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-all-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -61715,9 +64372,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61784,9 +64441,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -61850,9 +64507,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-status-check-contexts parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: content: application/json: @@ -61918,15 +64575,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *393 + schema: *392 examples: default: value: @@ -62017,9 +64674,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#delete-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '204': description: Response @@ -62042,9 +64699,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-apps-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -62054,7 +64711,7 @@ paths: type: array items: *5 examples: - default: &401 + default: &400 value: - id: 1 slug: octoapp @@ -62111,9 +64768,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62147,7 +64804,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -62168,9 +64825,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62204,7 +64861,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -62225,9 +64882,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-app-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62261,7 +64918,7 @@ paths: type: array items: *5 examples: - default: *401 + default: *400 '422': *15 x-github: githubCloudOnly: false @@ -62283,9 +64940,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-teams-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -62293,9 +64950,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '404': *6 x-github: githubCloudOnly: false @@ -62315,9 +64972,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -62353,9 +65010,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -62376,9 +65033,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: false content: @@ -62414,9 +65071,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -62437,9 +65094,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-team-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: content: application/json: @@ -62474,9 +65131,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 '422': *15 x-github: githubCloudOnly: false @@ -62498,9 +65155,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#get-users-with-access-to-the-protected-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 responses: '200': description: Response @@ -62534,9 +65191,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#add-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62594,9 +65251,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#set-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62654,9 +65311,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branch-protection#remove-user-access-restrictions parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62716,9 +65373,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#rename-a-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 requestBody: required: true content: @@ -62740,7 +65397,7 @@ paths: description: Response content: application/json: - schema: *402 + schema: *401 examples: default: value: @@ -62856,8 +65513,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#create-a-check-run parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -63136,7 +65793,7 @@ paths: description: Response content: application/json: - schema: &403 + schema: &402 title: CheckRun description: A check performed on the code of a given code change type: object @@ -63272,7 +65929,7 @@ paths: check. type: array items: *84 - deployment: &711 + deployment: &710 title: Deployment description: A deployment created as the result of an Actions check run from a workflow that references an environment @@ -63559,9 +66216,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#get-a-check-run parameters: + - *324 - *325 - - *326 - - &404 + - &403 name: check_run_id description: The unique identifier of the check run. in: path @@ -63573,9 +66230,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: &405 + default: &404 value: id: 4 head_sha: ce587453ced02b1526dfb4cb910479d431683101 @@ -63675,9 +66332,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#update-a-check-run parameters: + - *324 - *325 - - *326 - - *404 + - *403 requestBody: required: true content: @@ -63917,9 +66574,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: *405 + default: *404 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -63939,9 +66596,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-run-annotations parameters: + - *324 - *325 - - *326 - - *404 + - *403 - *17 - *19 responses: @@ -64051,15 +66708,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#rerequest-a-check-run parameters: + - *324 - *325 - - *326 - - *404 + - *403 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -64097,8 +66754,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#create-a-check-suite parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -64120,7 +66777,7 @@ paths: description: Response when the suite already exists content: application/json: - schema: &407 + schema: &406 title: CheckSuite description: A suite of checks performed on the code of a given code change @@ -64207,7 +66864,7 @@ paths: anyOf: - type: 'null' - *5 - repository: *153 + repository: *152 created_at: type: - string @@ -64218,7 +66875,7 @@ paths: - string - 'null' format: date-time - head_commit: *406 + head_commit: *405 latest_check_runs_count: type: integer check_runs_url: @@ -64246,7 +66903,7 @@ paths: - check_runs_url - pull_requests examples: - default: &408 + default: &407 value: id: 5 node_id: MDEwOkNoZWNrU3VpdGU1 @@ -64537,9 +67194,9 @@ paths: description: Response when the suite was created content: application/json: - schema: *407 + schema: *406 examples: - default: *408 + default: *407 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -64558,8 +67215,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#update-repository-preferences-for-check-suites parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -64620,7 +67277,7 @@ paths: required: - app_id - setting - repository: *153 + repository: *152 examples: default: value: @@ -64868,9 +67525,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#get-a-check-suite parameters: + - *324 - *325 - - *326 - - &409 + - &408 name: check_suite_id description: The unique identifier of the check suite. in: path @@ -64882,9 +67539,9 @@ paths: description: Response content: application/json: - schema: *407 + schema: *406 examples: - default: *408 + default: *407 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -64907,17 +67564,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-runs-in-a-check-suite parameters: + - *324 - *325 - - *326 - - *409 - - &462 + - *408 + - &461 name: check_name description: Returns check runs with the specified `name`. in: query required: false schema: type: string - - &463 + - &462 name: status description: Returns check runs with the specified `status`. in: query @@ -64956,9 +67613,9 @@ paths: type: integer check_runs: type: array - items: *403 + items: *402 examples: - default: &464 + default: &463 value: total_count: 1 check_runs: @@ -65060,15 +67717,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#rerequest-a-check-suite parameters: + - *324 - *325 - - *326 - - *409 + - *408 responses: '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -65095,21 +67752,21 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *409 - *410 - - *411 - *19 - *17 - - &428 + - &427 name: ref description: The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. in: query required: false - schema: *412 - - &429 + schema: *411 + - &428 name: pr description: The number of the pull request for the results you want to list. in: query @@ -65134,13 +67791,13 @@ paths: be returned. in: query required: false - schema: *413 + schema: *412 - name: severity description: If specified, only code scanning alerts with this severity will be returned. in: query required: false - schema: *414 + schema: *413 - name: assignees description: | Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., `octocat` or `octocat,hubot`). @@ -65159,24 +67816,24 @@ paths: items: type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: *415 - state: *180 - fixed_at: *176 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: *414 + state: *179 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: *416 - dismissed_comment: *417 - rule: *418 - tool: *419 - most_recent_instance: *420 + dismissed_at: *176 + dismissed_reason: *415 + dismissed_comment: *416 + rule: *417 + tool: *418 + most_recent_instance: *419 dismissal_approved_by: anyOf: - type: 'null' @@ -65299,7 +67956,7 @@ paths: classifications: [] instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/3/instances '304': *35 - '403': &421 + '403': &420 description: Response if GitHub Advanced Security is not enabled for this repository content: @@ -65326,9 +67983,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - &422 + - &421 name: alert_number in: path description: The number that identifies an alert. You can find this at the @@ -65336,30 +67993,30 @@ paths: field in the response from the `GET /repos/{owner}/{repo}/code-scanning/alerts` operation. required: true - schema: *171 + schema: *170 responses: '200': description: Response content: application/json: - schema: &423 + schema: &422 type: object properties: - number: *171 - created_at: *172 - updated_at: *173 - url: *174 - html_url: *175 - instances_url: *415 - state: *180 - fixed_at: *176 + number: *170 + created_at: *171 + updated_at: *172 + url: *173 + html_url: *174 + instances_url: *414 + state: *179 + fixed_at: *175 dismissed_by: anyOf: - type: 'null' - *4 - dismissed_at: *177 - dismissed_reason: *416 - dismissed_comment: *417 + dismissed_at: *176 + dismissed_reason: *415 + dismissed_comment: *416 rule: type: object properties: @@ -65421,8 +68078,8 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: *419 - most_recent_instance: *420 + tool: *418 + most_recent_instance: *419 dismissal_approved_by: anyOf: - type: 'null' @@ -65518,7 +68175,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '304': *35 - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65538,9 +68195,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#update-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: true content: @@ -65555,8 +68212,8 @@ paths: enum: - open - dismissed - dismissed_reason: *416 - dismissed_comment: *417 + dismissed_reason: *415 + dismissed_comment: *416 create_request: type: boolean description: If `true`, attempt to create an alert dismissal request. @@ -65584,7 +68241,7 @@ paths: description: Response content: application/json: - schema: *423 + schema: *422 examples: default: value: @@ -65660,7 +68317,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '400': *14 - '403': &427 + '403': &426 description: Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository content: @@ -65687,15 +68344,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 responses: '200': description: Response content: application/json: - schema: &424 + schema: &423 type: object properties: status: @@ -65722,13 +68379,13 @@ paths: - description - started_at examples: - default: &425 + default: &424 value: status: success description: This fixes an XSS vulnerability by escaping the user input. started_at: '2024-02-14T12:29:18Z' - '400': &426 + '400': &425 description: Bad Request content: application/json: @@ -65739,7 +68396,7 @@ paths: message: The alert_number is not valid documentation_url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert status: '400' - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -65764,29 +68421,29 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 responses: '200': description: OK content: application/json: - schema: *424 + schema: *423 examples: - default: *425 + default: *424 '202': description: Accepted content: application/json: - schema: *424 + schema: *423 examples: default: value: status: pending description: started_at: '2024-02-14T12:29:18Z' - '400': *426 + '400': *425 '403': description: Response if the repository is archived, if GitHub Advanced Security is not enabled for this repository or if rate limit is exceeded @@ -65818,9 +68475,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: false content: @@ -65866,8 +68523,8 @@ paths: value: target_ref: refs/heads/main sha: 178f4f6090b3fccad4a65b3e83d076a622d59652 - '400': *426 - '403': *427 + '400': *425 + '403': *426 '404': *6 '422': description: Unprocessable Entity @@ -65891,13 +68548,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 - *19 - *17 + - *427 - *428 - - *429 responses: '200': description: Response @@ -65908,10 +68565,10 @@ paths: items: type: object properties: - ref: *412 - analysis_key: *430 - environment: *431 - category: *432 + ref: *411 + analysis_key: *429 + environment: *430 + category: *431 state: type: - string @@ -65928,7 +68585,7 @@ paths: properties: text: type: string - location: *433 + location: *432 html_url: type: string classifications: @@ -65936,7 +68593,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: *434 + items: *433 examples: default: value: @@ -65973,7 +68630,7 @@ paths: end_column: 50 classifications: - source - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66007,25 +68664,25 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository parameters: + - *324 - *325 - - *326 + - *409 - *410 - - *411 - *19 - *17 - - *429 + - *428 - name: ref in: query description: The Git reference for the analyses you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. required: false - schema: *412 + schema: *411 - name: sarif_id in: query description: Filter analyses belonging to the same SARIF upload. required: false - schema: &435 + schema: &434 type: string description: An identifier for the upload. examples: @@ -66047,23 +68704,23 @@ paths: application/json: schema: type: array - items: &436 + items: &435 type: object properties: - ref: *412 - commit_sha: &444 + ref: *411 + commit_sha: &443 description: The SHA of the commit to which the analysis you are uploading relates. type: string minLength: 40 maxLength: 40 pattern: "^[0-9a-fA-F]+$" - analysis_key: *430 + analysis_key: *429 environment: type: string description: Identifies the variable values associated with the environment in which this analysis was performed. - category: *432 + category: *431 error: type: string examples: @@ -66088,8 +68745,8 @@ paths: description: The REST API URL of the analysis resource. format: uri readOnly: true - sarif_id: *435 - tool: *419 + sarif_id: *434 + tool: *418 deletable: type: boolean warning: @@ -66151,7 +68808,7 @@ paths: version: 1.2.0 deletable: true warning: '' - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66187,8 +68844,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository parameters: + - *324 - *325 - - *326 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -66201,7 +68858,7 @@ paths: description: Response content: application/json: - schema: *436 + schema: *435 examples: response: summary: application/json response @@ -66255,7 +68912,7 @@ paths: properties: - github/alertNumber: 2 - github/alertUrl: https://api.github.com/repos/monalisa/monalisa/code-scanning/alerts/2 - '403': *421 + '403': *420 '404': *6 '422': description: Response if analysis could not be processed @@ -66342,8 +68999,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository parameters: + - *324 - *325 - - *326 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -66399,7 +69056,7 @@ paths: next_analysis_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41 confirm_delete_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41?confirm_delete '400': *14 - '403': *427 + '403': *426 '404': *6 '503': *113 x-github: @@ -66421,8 +69078,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -66430,7 +69087,7 @@ paths: application/json: schema: type: array - items: &437 + items: &436 title: CodeQL Database description: A CodeQL database. type: object @@ -66542,7 +69199,7 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66571,8 +69228,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository parameters: + - *324 - *325 - - *326 - name: language in: path description: The language of the CodeQL database. @@ -66584,7 +69241,7 @@ paths: description: Response content: application/json: - schema: *437 + schema: *436 examples: default: value: @@ -66616,9 +69273,9 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '302': &469 + '302': &468 description: Found - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -66640,8 +69297,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#delete-a-codeql-database parameters: + - *324 - *325 - - *326 - name: language in: path description: The language of the CodeQL database. @@ -66651,7 +69308,7 @@ paths: responses: '204': description: Response - '403': *427 + '403': *426 '404': *6 '503': *113 x-github: @@ -66679,8 +69336,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#create-a-codeql-variant-analysis parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -66689,7 +69346,7 @@ paths: type: object additionalProperties: false properties: - language: &438 + language: &437 type: string description: The language targeted by the CodeQL query enum: @@ -66769,7 +69426,7 @@ paths: description: Variant analysis submitted for processing content: application/json: - schema: &442 + schema: &441 title: Variant Analysis description: A run of a CodeQL query against one or more repositories. type: object @@ -66779,7 +69436,7 @@ paths: description: The ID of the variant analysis. controller_repo: *64 actor: *4 - query_language: *438 + query_language: *437 query_pack_url: type: string description: The download url for the query pack. @@ -66827,7 +69484,7 @@ paths: items: type: object properties: - repository: &439 + repository: &438 title: Repository Identifier description: Repository Identifier type: object @@ -66869,7 +69526,7 @@ paths: - private - stargazers_count - updated_at - analysis_status: &443 + analysis_status: &442 type: string description: The new status of the CodeQL variant analysis repository task. @@ -66901,7 +69558,7 @@ paths: from processing. This information is only available to the user that initiated the variant analysis. properties: - access_mismatch_repos: &440 + access_mismatch_repos: &439 type: object properties: repository_count: @@ -66916,7 +69573,7 @@ paths: This list may not include all repositories that were skipped. This is only available when the repository was found and the user has access to it. - items: *439 + items: *438 required: - repository_count - repositories @@ -66939,8 +69596,8 @@ paths: required: - repository_count - repository_full_names - no_codeql_db_repos: *440 - over_limit_repos: *440 + no_codeql_db_repos: *439 + over_limit_repos: *439 required: - access_mismatch_repos - not_found_repos @@ -66956,7 +69613,7 @@ paths: examples: repositories_parameter: summary: Response for a successful variant analysis submission - value: &441 + value: &440 summary: Default response value: id: 1 @@ -67102,10 +69759,10 @@ paths: private: false repository_owners: summary: Response for a successful variant analysis submission - value: *441 + value: *440 repository_lists: summary: Response for a successful variant analysis submission - value: *441 + value: *440 '404': *6 '422': description: Unable to process variant analysis submission @@ -67133,8 +69790,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-summary-of-a-codeql-variant-analysis parameters: + - *324 - *325 - - *326 - name: codeql_variant_analysis_id in: path description: The unique identifier of the variant analysis. @@ -67146,9 +69803,9 @@ paths: description: Response content: application/json: - schema: *442 + schema: *441 examples: - default: *441 + default: *440 '404': *6 '503': *113 x-github: @@ -67171,7 +69828,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-analysis-status-of-a-repository-in-a-codeql-variant-analysis parameters: - - *325 + - *324 - name: repo in: path description: The name of the controller repository. @@ -67206,7 +69863,7 @@ paths: type: object properties: repository: *64 - analysis_status: *443 + analysis_status: *442 artifact_size_in_bytes: type: integer description: The size of the artifact. This is only available @@ -67331,8 +69988,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -67442,7 +70099,7 @@ paths: threat_model: remote updated_at: '2023-01-19T11:21:34Z' schedule: weekly - '403': *421 + '403': *420 '404': *6 '503': *113 x-github: @@ -67463,8 +70120,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -67533,7 +70190,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -67558,7 +70215,7 @@ paths: value: run_id: 42 run_url: https://api.github.com/repos/octoorg/octocat/actions/runs/42 - '403': *427 + '403': *426 '404': *6 '409': description: Response if there is already a validation run in progress with @@ -67629,8 +70286,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#upload-an-analysis-as-sarif-data parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -67638,7 +70295,7 @@ paths: schema: type: object properties: - commit_sha: *444 + commit_sha: *443 ref: type: string description: |- @@ -67698,7 +70355,7 @@ paths: schema: type: object properties: - id: *435 + id: *434 url: type: string description: The REST API URL for checking the status of the upload. @@ -67712,7 +70369,7 @@ paths: url: https://api.github.com/repos/octocat/hello-world/code-scanning/sarifs/47177e22-5596-11eb-80a1-c1e54ef945c6 '400': description: Bad Request if the sarif field is invalid - '403': *427 + '403': *426 '404': *6 '413': description: Payload Too Large if the sarif field is too large @@ -67735,8 +70392,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-scanning/code-scanning#get-information-about-a-sarif-upload parameters: + - *324 - *325 - - *326 - name: sarif_id description: The SARIF ID obtained after uploading. in: path @@ -67784,7 +70441,7 @@ paths: value: processing_status: complete analyses_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses?sarif_id=47177e22-5596-11eb-80a1-c1e54ef945c6 - '403': *421 + '403': *420 '404': description: Not Found if the sarif id does not match any upload '503': *113 @@ -67809,8 +70466,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/code-security/configurations#get-the-code-security-configuration-associated-with-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -67866,7 +70523,7 @@ paths: html_url: https://github.com/organizations/octo-org/settings/security_products/configurations/edit/1325 created_at: '2024-05-01T00:00:00Z' updated_at: '2024-05-01T00:00:00Z' - '204': *184 + '204': *183 '304': *35 '403': *27 '404': *6 @@ -67891,8 +70548,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-codeowners-errors parameters: + - *324 - *325 - - *326 - name: ref description: 'A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository''s default branch @@ -68020,8 +70677,8 @@ paths: parameters: - *17 - *19 + - *324 - *325 - - *326 responses: '200': description: Response @@ -68037,7 +70694,7 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: default: value: @@ -68335,8 +70992,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-codespace-in-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -68400,17 +71057,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '400': *14 '401': *23 '403': *27 @@ -68439,8 +71096,8 @@ paths: parameters: - *17 - *19 + - *324 - *325 - - *326 responses: '200': description: Response @@ -68504,8 +71161,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/machines#list-available-machine-types-for-a-repository parameters: + - *324 - *325 - - *326 - name: location description: The location to check for available machines. Assigned by IP if not provided. @@ -68542,9 +71199,9 @@ paths: type: integer machines: type: array - items: *446 + items: *445 examples: - default: &655 + default: &654 value: total_count: 2 machines: @@ -68584,8 +71241,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-default-attributes-for-a-codespace parameters: + - *324 - *325 - - *326 - name: ref description: The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked. @@ -68672,8 +71329,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user parameters: + - *324 - *325 - - *326 - name: ref description: The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of `ref` will typically @@ -68742,8 +71399,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -68761,7 +71418,7 @@ paths: type: integer secrets: type: array - items: &450 + items: &449 title: Codespaces Secret description: Set repository secrets for GitHub Codespaces. type: object @@ -68782,7 +71439,7 @@ paths: - created_at - updated_at examples: - default: *447 + default: *446 headers: Link: *65 x-github: @@ -68805,16 +71462,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *448 + schema: *447 examples: - default: *449 + default: *448 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -68834,17 +71491,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *450 + schema: *449 examples: - default: *451 + default: *450 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -68864,9 +71521,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -68894,7 +71551,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -68918,9 +71575,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/repository-secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -68948,8 +71605,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#list-repository-collaborators parameters: + - *324 - *325 - - *326 - name: affiliation description: Filter collaborators returned by their affiliation. `outside` means all outside collaborators of an organization-owned repository. `direct` @@ -68987,7 +71644,7 @@ paths: application/json: schema: type: array - items: &452 + items: &451 title: Collaborator description: Collaborator type: object @@ -69180,8 +71837,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 responses: '204': @@ -69228,8 +71885,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#add-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 requestBody: required: false @@ -69256,7 +71913,7 @@ paths: description: Response when a new invitation is created content: application/json: - schema: &519 + schema: &518 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -69268,7 +71925,7 @@ paths: format: int64 examples: - 42 - repository: *153 + repository: *152 invitee: anyOf: - type: 'null' @@ -69484,8 +72141,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#remove-a-repository-collaborator parameters: + - *324 - *325 - - *326 - *69 responses: '204': @@ -69517,8 +72174,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/collaborators#get-repository-permissions-for-a-user parameters: + - *324 - *325 - - *326 - *69 responses: '200': @@ -69539,7 +72196,7 @@ paths: user: anyOf: - type: 'null' - - *452 + - *451 required: - permission - role_name @@ -69593,8 +72250,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#list-commit-comments-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -69604,7 +72261,7 @@ paths: application/json: schema: type: array - items: &453 + items: &452 title: Commit Comment description: Commit Comment type: object @@ -69662,7 +72319,7 @@ paths: - created_at - updated_at examples: - default: &458 + default: &457 value: - html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -69721,17 +72378,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#get-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': description: Response content: application/json: - schema: *453 + schema: *452 examples: - default: &459 + default: &458 value: html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -69788,8 +72445,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#update-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -69812,7 +72469,7 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: default: value: @@ -69863,8 +72520,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#delete-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -69886,8 +72543,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -69914,7 +72571,7 @@ paths: application/json: schema: type: array - items: &454 + items: &453 title: Reaction description: Reactions to conversations provide a way to help people express their feelings more simply and effectively. @@ -69958,7 +72615,7 @@ paths: - content - created_at examples: - default: &522 + default: &521 value: - id: 1 node_id: MDg6UmVhY3Rpb24x @@ -70003,8 +72660,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-commit-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -70037,9 +72694,9 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: &455 + default: &454 value: id: 1 node_id: MDg6UmVhY3Rpb24x @@ -70068,9 +72725,9 @@ paths: description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -70092,10 +72749,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-commit-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - &523 + - &522 name: reaction_id description: The unique identifier of the reaction. in: path @@ -70150,8 +72807,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-commits parameters: + - *324 - *325 - - *326 - name: sha description: 'SHA or branch to start listing commits from. Default: the repository’s default branch (usually `main`).' @@ -70207,9 +72864,9 @@ paths: application/json: schema: type: array - items: *456 + items: *455 examples: - default: &569 + default: &568 value: - url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -70303,9 +72960,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-branches-for-head-commit parameters: + - *324 - *325 - - *326 - - &457 + - &456 name: commit_sha description: The SHA of the commit. in: path @@ -70377,9 +73034,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#list-commit-comments parameters: + - *324 - *325 - - *326 - - *457 + - *456 - *17 - *19 responses: @@ -70389,9 +73046,9 @@ paths: application/json: schema: type: array - items: *453 + items: *452 examples: - default: *458 + default: *457 headers: Link: *65 x-github: @@ -70419,9 +73076,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/comments#create-a-commit-comment parameters: + - *324 - *325 - - *326 - - *457 + - *456 requestBody: required: true content: @@ -70456,9 +73113,9 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: - default: *459 + default: *458 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -70486,9 +73143,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#list-pull-requests-associated-with-a-commit parameters: + - *324 - *325 - - *326 - - *457 + - *456 - *17 - *19 responses: @@ -70498,9 +73155,9 @@ paths: application/json: schema: type: array - items: *460 + items: *459 examples: - default: &561 + default: &560 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -71037,11 +73694,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#get-a-commit parameters: + - *324 - *325 - - *326 - *19 - *17 - - &461 + - &460 name: ref description: 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](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" @@ -71056,9 +73713,9 @@ paths: description: Response content: application/json: - schema: *456 + schema: *455 examples: - default: &549 + default: &548 value: url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -71171,11 +73828,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/runs#list-check-runs-for-a-git-reference parameters: + - *324 - *325 - - *326 + - *460 - *461 - *462 - - *463 - name: filter description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. @@ -71209,9 +73866,9 @@ paths: type: integer check_runs: type: array - items: *403 + items: *402 examples: - default: *464 + default: *463 headers: Link: *65 x-github: @@ -71236,9 +73893,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/checks/suites#list-check-suites-for-a-git-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - name: app_id description: Filters check suites by GitHub App `id`. in: query @@ -71246,7 +73903,7 @@ paths: schema: type: integer example: 1 - - *462 + - *461 - *17 - *19 responses: @@ -71264,7 +73921,7 @@ paths: type: integer check_suites: type: array - items: *407 + items: *406 examples: default: value: @@ -71464,9 +74121,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#get-the-combined-status-for-a-specific-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - *17 - *19 responses: @@ -71537,7 +74194,7 @@ paths: type: string total_count: type: integer - repository: *153 + repository: *152 commit_url: type: string format: uri @@ -71668,9 +74325,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#list-commit-statuses-for-a-reference parameters: + - *324 - *325 - - *326 - - *461 + - *460 - *17 - *19 responses: @@ -71680,7 +74337,7 @@ paths: application/json: schema: type: array - items: &634 + items: &633 title: Status description: The status of a commit. type: object @@ -71761,7 +74418,7 @@ paths: site_admin: false headers: Link: *65 - '301': *329 + '301': *328 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -71789,8 +74446,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/community#get-community-profile-metrics parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -71823,11 +74480,11 @@ paths: code_of_conduct: anyOf: - type: 'null' - - *465 + - *464 code_of_conduct_file: anyOf: - type: 'null' - - &466 + - &465 title: Community Health File type: object properties: @@ -71847,19 +74504,19 @@ paths: contributing: anyOf: - type: 'null' - - *466 + - *465 readme: anyOf: - type: 'null' - - *466 + - *465 issue_template: anyOf: - type: 'null' - - *466 + - *465 pull_request_template: anyOf: - type: 'null' - - *466 + - *465 required: - code_of_conduct - code_of_conduct_file @@ -71988,8 +74645,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/commits#compare-two-commits parameters: + - *324 - *325 - - *326 - *19 - *17 - name: basehead @@ -72037,8 +74694,8 @@ paths: format: uri examples: - https://github.com/octocat/Hello-World/compare/master...topic.patch - base_commit: *456 - merge_base_commit: *456 + base_commit: *455 + merge_base_commit: *455 status: type: string enum: @@ -72062,10 +74719,10 @@ paths: - 6 commits: type: array - items: *456 + items: *455 files: type: array - items: *467 + items: *466 required: - url - html_url @@ -72351,8 +75008,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-repository-content parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -72522,7 +75179,7 @@ paths: - type - url examples: - response-if-content-is-a-file-github-object: &468 + response-if-content-is-a-file-github-object: &467 summary: Response if content is a file value: type: file @@ -72659,7 +75316,7 @@ paths: - size - type - url - - &574 + - &573 title: Content File description: Content File type: object @@ -72877,7 +75534,7 @@ paths: - url - submodule_git_url examples: - response-if-content-is-a-file: *468 + response-if-content-is-a-file: *467 response-if-content-is-a-directory: summary: Response if content is a directory and the application/json media type is requested @@ -72946,7 +75603,7 @@ paths: html: https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9 '404': *6 '403': *27 - '302': *469 + '302': *468 '304': *35 x-github: githubCloudOnly: false @@ -72999,8 +75656,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#create-or-update-file-contents parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -73095,7 +75752,7 @@ paths: description: Response content: application/json: - schema: &470 + schema: &469 title: File Commit description: File Commit type: object @@ -73251,7 +75908,7 @@ paths: description: Response content: application/json: - schema: *470 + schema: *469 examples: example-for-creating-a-file: value: @@ -73305,7 +75962,7 @@ paths: schema: oneOf: - *3 - - &501 + - &500 description: Repository rule violation was detected type: object properties: @@ -73326,7 +75983,7 @@ paths: items: type: object properties: - placeholder_id: &626 + placeholder_id: &625 description: The ID of the push protection bypass placeholder. This value is returned on any push protected routes. @@ -73358,8 +76015,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#delete-a-file parameters: + - *324 - *325 - - *326 - name: path description: path parameter in: path @@ -73420,7 +76077,7 @@ paths: description: Response content: application/json: - schema: *470 + schema: *469 examples: default: value: @@ -73475,8 +76132,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-contributors parameters: + - *324 - *325 - - *326 - name: anon description: Set to `1` or `true` to include anonymous contributors in results. in: query @@ -73600,23 +76257,23 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#list-dependabot-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *189 - *190 - *191 - *192 - - *193 - name: manifest in: query description: A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned. schema: type: string + - *193 + - *470 - *194 - - *471 - *195 - *196 - - *197 - *59 - *45 - *46 @@ -73628,11 +76285,11 @@ paths: application/json: schema: type: array - items: &475 + items: &474 type: object description: A Dependabot alert. properties: - number: *171 + number: *170 state: type: string description: The state of the Dependabot alert. @@ -73677,14 +76334,15 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: *472 + security_advisory: *471 security_vulnerability: *63 - url: *174 - html_url: *175 - created_at: *172 - updated_at: *173 - dismissed_at: *177 + url: *173 + html_url: *174 + created_at: *171 + updated_at: *172 + dismissed_at: *176 dismissed_by: anyOf: - type: 'null' @@ -73708,9 +76366,9 @@ paths: description: An optional comment associated with the alert's dismissal. maxLength: 280 - fixed_at: *176 - auto_dismissed_at: *473 - dismissal_request: *474 + fixed_at: *175 + auto_dismissed_at: *472 + dismissal_request: *473 assignees: type: array description: The users assigned to this alert. @@ -73782,7 +76440,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -73965,9 +76623,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#get-a-dependabot-alert parameters: + - *324 - *325 - - *326 - - &476 + - &475 name: alert_number in: path description: |- @@ -73976,13 +76634,13 @@ paths: or in `number` fields in the response from the `GET /repos/{owner}/{repo}/dependabot/alerts` operation. required: true - schema: *171 + schema: *170 responses: '200': description: Response content: application/json: - schema: *475 + schema: *474 examples: default: value: @@ -74039,7 +76697,7 @@ paths: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 @@ -74114,9 +76772,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/alerts#update-a-dependabot-alert parameters: + - *324 - *325 - - *326 - - *476 + - *475 requestBody: required: true content: @@ -74172,7 +76830,7 @@ paths: description: Response content: application/json: - schema: *475 + schema: *474 examples: default: value: @@ -74302,8 +76960,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#list-repository-secrets parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -74321,7 +76979,7 @@ paths: type: integer secrets: type: array - items: &479 + items: &478 title: Dependabot Secret description: Set secrets for Dependabot. type: object @@ -74375,16 +77033,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#get-a-repository-public-key parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *477 + schema: *476 examples: - default: *478 + default: *477 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -74404,15 +77062,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#get-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *479 + schema: *478 examples: default: value: @@ -74438,9 +77096,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#create-or-update-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 requestBody: required: true content: @@ -74468,7 +77126,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -74492,9 +77150,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependabot/secrets#delete-a-repository-secret parameters: + - *324 - *325 - - *326 - - *161 + - *160 responses: '204': description: Response @@ -74516,8 +77174,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits parameters: + - *324 - *325 - - *326 - name: basehead description: The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their @@ -74691,8 +77349,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -74952,8 +77610,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -75036,7 +77694,7 @@ paths: - version - url additionalProperties: false - metadata: &480 + metadata: &479 title: metadata description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -75075,7 +77733,7 @@ paths: examples: - "/src/build/package-lock.json" additionalProperties: false - metadata: *480 + metadata: *479 resolved: type: object description: A collection of resolved package dependencies. @@ -75089,7 +77747,7 @@ paths: pattern: "^pkg" examples: - pkg:/npm/%40actions/http-client@1.0.11 - metadata: *480 + metadata: *479 relationship: type: string description: A notation of whether a dependency is requested @@ -75222,8 +77880,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#list-deployments parameters: + - *324 - *325 - - *326 - name: sha description: The SHA recorded at creation time. in: query @@ -75264,9 +77922,9 @@ paths: application/json: schema: type: array - items: *481 + items: *480 examples: - default: *482 + default: *481 headers: Link: *65 x-github: @@ -75332,8 +77990,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#create-a-deployment parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -75415,7 +78073,7 @@ paths: description: Response content: application/json: - schema: *481 + schema: *480 examples: simple-example: summary: Simple example @@ -75488,9 +78146,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#get-a-deployment parameters: + - *324 - *325 - - *326 - - &483 + - &482 name: deployment_id description: deployment_id parameter in: path @@ -75502,7 +78160,7 @@ paths: description: Response content: application/json: - schema: *481 + schema: *480 examples: default: value: @@ -75567,9 +78225,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/deployments#delete-a-deployment parameters: + - *324 - *325 - - *326 - - *483 + - *482 responses: '204': description: Response @@ -75591,9 +78249,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#list-deployment-statuses parameters: + - *324 - *325 - - *326 - - *483 + - *482 - *17 - *19 responses: @@ -75603,7 +78261,7 @@ paths: application/json: schema: type: array - items: &484 + items: &483 title: Deployment Status description: The status of a deployment. type: object @@ -75767,9 +78425,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#create-a-deployment-status parameters: + - *324 - *325 - - *326 - - *483 + - *482 requestBody: required: true content: @@ -75844,9 +78502,9 @@ paths: description: Response content: application/json: - schema: *484 + schema: *483 examples: - default: &485 + default: &484 value: url: https://api.github.com/repos/octocat/example/deployments/42/statuses/1 id: 1 @@ -75902,9 +78560,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/statuses#get-a-deployment-status parameters: + - *324 - *325 - - *326 - - *483 + - *482 - name: status_id in: path required: true @@ -75915,9 +78573,9 @@ paths: description: Response content: application/json: - schema: *484 + schema: *483 examples: - default: *485 + default: *484 '404': *6 x-github: githubCloudOnly: false @@ -75942,8 +78600,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#create-a-repository-dispatch-event parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -76000,8 +78658,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#list-environments parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -76019,7 +78677,7 @@ paths: - 5 environments: type: array - items: &487 + items: &486 title: Environment description: Details of a deployment environment type: object @@ -76081,7 +78739,7 @@ paths: type: string examples: - wait_timer - wait_timer: &489 + wait_timer: &488 type: integer description: The amount of time to delay a job after the job is initially triggered. The time (in minutes) @@ -76123,11 +78781,11 @@ paths: items: type: object properties: - type: *486 + type: *485 reviewer: anyOf: - *4 - - *188 + - *187 required: - id - node_id @@ -76150,7 +78808,7 @@ paths: - id - node_id - type - deployment_branch_policy: &490 + deployment_branch_policy: &489 type: - object - 'null' @@ -76267,9 +78925,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#get-an-environment parameters: + - *324 - *325 - - *326 - - &488 + - &487 name: environment_name in: path required: true @@ -76282,9 +78940,9 @@ paths: description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: &491 + default: &490 value: id: 161088068 node_id: MDExOkVudmlyb25tZW50MTYxMDg4MDY4 @@ -76368,9 +79026,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#create-or-update-an-environment parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: false content: @@ -76380,7 +79038,7 @@ paths: - object - 'null' properties: - wait_timer: *489 + wait_timer: *488 prevent_self_review: type: boolean description: Whether or not a user who created the job is prevented @@ -76399,14 +79057,14 @@ paths: items: type: object properties: - type: *486 + type: *485 id: type: integer description: The id of the user or team who can review the deployment examples: - 4532992 - deployment_branch_policy: *490 + deployment_branch_policy: *489 additionalProperties: false examples: default: @@ -76426,9 +79084,9 @@ paths: description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: *491 + default: *490 '422': description: Validation error when the environment name is invalid or when `protected_branches` and `custom_branch_policies` in `deployment_branch_policy` @@ -76452,9 +79110,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/environments#delete-an-environment parameters: + - *324 - *325 - - *326 - - *488 + - *487 responses: '204': description: Default response @@ -76479,9 +79137,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#list-deployment-branch-policies parameters: + - *324 - *325 - - *326 - - *488 + - *487 - *17 - *19 responses: @@ -76500,7 +79158,7 @@ paths: - 2 branch_policies: type: array - items: &492 + items: &491 title: Deployment branch policy description: Details of a deployment branch or tag policy. type: object @@ -76561,9 +79219,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#create-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: true content: @@ -76611,9 +79269,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - example-wildcard: &493 + example-wildcard: &492 value: id: 364662 node_id: MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI= @@ -76655,10 +79313,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#get-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - &494 + - *487 + - &493 name: branch_policy_id in: path required: true @@ -76670,9 +79328,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - default: *493 + default: *492 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76691,10 +79349,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#update-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - *494 + - *487 + - *493 requestBody: required: true content: @@ -76723,9 +79381,9 @@ paths: description: Response content: application/json: - schema: *492 + schema: *491 examples: - default: *493 + default: *492 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76744,10 +79402,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/branch-policies#delete-a-deployment-branch-policy parameters: + - *324 - *325 - - *326 - - *488 - - *494 + - *487 + - *493 responses: '204': description: Response @@ -76772,9 +79430,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#get-all-deployment-protection-rules-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 responses: '200': description: List of deployment protection rules @@ -76791,7 +79449,7 @@ paths: - 10 custom_deployment_protection_rules: type: array - items: &495 + items: &494 title: Deployment protection rule description: Deployment protection rule type: object @@ -76813,7 +79471,7 @@ paths: for the environment. examples: - true - app: &496 + app: &495 title: Custom deployment protection rule app description: A GitHub App that is providing a custom deployment protection rule. @@ -76916,9 +79574,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#create-a-custom-deployment-protection-rule-on-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 requestBody: content: application/json: @@ -76939,9 +79597,9 @@ paths: description: The enabled custom deployment protection rule content: application/json: - schema: *495 + schema: *494 examples: - default: &497 + default: &496 value: id: 3 node_id: IEH37kRlcGxveW1lbnRTdGF0ddiv @@ -76976,9 +79634,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#list-custom-deployment-rule-integrations-available-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 + - *324 - *19 - *17 responses: @@ -76998,7 +79656,7 @@ paths: - 35 available_custom_deployment_protection_rule_integrations: type: array - items: *496 + items: *495 examples: default: value: @@ -77033,10 +79691,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#get-a-custom-deployment-protection-rule parameters: + - *324 - *325 - - *326 - - *488 - - &498 + - *487 + - &497 name: protection_rule_id description: The unique identifier of the protection rule. in: path @@ -77048,9 +79706,9 @@ paths: description: Response content: application/json: - schema: *495 + schema: *494 examples: - default: *497 + default: *496 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77071,10 +79729,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/deployments/protection-rules#disable-a-custom-protection-rule-for-an-environment parameters: - - *488 - - *326 + - *487 - *325 - - *498 + - *324 + - *497 responses: '204': description: Response @@ -77100,9 +79758,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#list-environment-secrets parameters: + - *324 - *325 - - *326 - - *488 + - *487 - *17 - *19 responses: @@ -77120,9 +79778,9 @@ paths: type: integer secrets: type: array - items: *370 + items: *369 examples: - default: *371 + default: *370 headers: Link: *65 x-github: @@ -77147,17 +79805,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-an-environment-public-key parameters: + - *324 - *325 - - *326 - - *488 + - *487 responses: '200': description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77179,18 +79837,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#get-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 responses: '200': description: Response content: application/json: - schema: *370 + schema: *369 examples: - default: *499 + default: *498 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77212,10 +79870,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#create-or-update-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 requestBody: required: true content: @@ -77246,7 +79904,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -77272,10 +79930,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/secrets#delete-an-environment-secret parameters: + - *324 - *325 - - *326 - - *488 - - *161 + - *487 + - *160 responses: '204': description: Default response @@ -77300,10 +79958,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#list-environment-variables parameters: + - *324 - *325 - - *326 - - *488 - - *341 + - *487 + - *340 - *19 responses: '200': @@ -77320,9 +79978,9 @@ paths: type: integer variables: type: array - items: *374 + items: *373 examples: - default: *375 + default: *374 headers: Link: *65 x-github: @@ -77345,9 +80003,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#create-an-environment-variable parameters: + - *324 - *325 - - *326 - - *488 + - *487 requestBody: required: true content: @@ -77374,7 +80032,7 @@ paths: description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -77399,18 +80057,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#get-an-environment-variable parameters: + - *324 - *325 - - *326 - - *488 - - *164 + - *487 + - *163 responses: '200': description: Response content: application/json: - schema: *374 + schema: *373 examples: - default: *500 + default: *499 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77431,10 +80089,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#update-an-environment-variable parameters: + - *324 - *325 - - *326 - - *164 - - *488 + - *163 + - *487 requestBody: required: true content: @@ -77476,10 +80134,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/actions/variables#delete-an-environment-variable parameters: + - *324 - *325 - - *326 - - *164 - - *488 + - *163 + - *487 responses: '204': description: Response @@ -77501,8 +80159,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/events#list-repository-events parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -77570,8 +80228,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/forks#list-forks parameters: + - *324 - *325 - - *326 - name: sort description: The sort order. `stargazers` will sort by star count. in: query @@ -77593,7 +80251,7 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: default: value: @@ -77730,8 +80388,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/forks#create-a-fork parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -77764,9 +80422,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 '400': *14 '422': *15 '403': *27 @@ -77787,8 +80445,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/blobs#create-a-blob parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -77848,7 +80506,7 @@ paths: schema: oneOf: - *121 - - *501 + - *500 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77873,8 +80531,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/blobs#get-a-blob parameters: + - *324 - *325 - - *326 - name: file_sha in: path required: true @@ -77974,8 +80632,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/commits#create-a-commit parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -78084,7 +80742,7 @@ paths: description: Response content: application/json: - schema: &502 + schema: &501 title: Git Commit description: Low-level Git commit operations within a repository type: object @@ -78311,15 +80969,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/commits#get-a-commit-object parameters: + - *324 - *325 - - *326 - - *457 + - *456 responses: '200': description: Response content: application/json: - schema: *502 + schema: *501 examples: default: value: @@ -78375,9 +81033,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#list-matching-references parameters: + - *324 - *325 - - *326 - - &503 + - &502 name: ref description: The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. @@ -78394,7 +81052,7 @@ paths: application/json: schema: type: array - items: &504 + items: &503 title: Git Reference description: Git references within a repository type: object @@ -78470,17 +81128,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#get-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 responses: '200': description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: &505 + default: &504 value: ref: refs/heads/featureA node_id: MDM6UmVmcmVmcy9oZWFkcy9mZWF0dXJlQQ== @@ -78509,8 +81167,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#create-a-reference parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -78539,9 +81197,9 @@ paths: description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: *505 + default: *504 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA @@ -78567,9 +81225,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#update-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 requestBody: required: true content: @@ -78598,9 +81256,9 @@ paths: description: Response content: application/json: - schema: *504 + schema: *503 examples: - default: *505 + default: *504 '422': *15 '409': *52 x-github: @@ -78618,9 +81276,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/refs#delete-a-reference parameters: + - *324 - *325 - - *326 - - *503 + - *502 responses: '204': description: Response @@ -78675,8 +81333,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/tags#create-a-tag-object parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -78743,7 +81401,7 @@ paths: description: Response content: application/json: - schema: &507 + schema: &506 title: Git Tag description: Metadata for a Git tag type: object @@ -78799,7 +81457,7 @@ paths: - sha - type - url - verification: *506 + verification: *505 required: - sha - url @@ -78809,7 +81467,7 @@ paths: - tag - message examples: - default: &508 + default: &507 value: node_id: MDM6VGFnOTQwYmQzMzYyNDhlZmFlMGY5ZWU1YmM3YjJkNWM5ODU4ODdiMTZhYw== tag: v0.0.1 @@ -78882,8 +81540,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/tags#get-a-tag parameters: + - *324 - *325 - - *326 - name: tag_sha in: path required: true @@ -78894,9 +81552,9 @@ paths: description: Response content: application/json: - schema: *507 + schema: *506 examples: - default: *508 + default: *507 '404': *6 '409': *52 x-github: @@ -78920,8 +81578,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/trees#create-a-tree parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -78995,7 +81653,7 @@ paths: description: Response content: application/json: - schema: &509 + schema: &508 title: Git Tree description: The hierarchy between files in a Git repository. type: object @@ -79097,8 +81755,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/git/trees#get-a-tree parameters: + - *324 - *325 - - *326 - name: tree_sha description: The SHA1 value or ref (branch or tag) name of the tree. in: path @@ -79121,7 +81779,7 @@ paths: description: Response content: application/json: - schema: *509 + schema: *508 examples: default-response: summary: Default response @@ -79180,8 +81838,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#list-repository-webhooks parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -79191,7 +81849,7 @@ paths: application/json: schema: type: array - items: &510 + items: &509 title: Webhook description: Webhooks for repositories. type: object @@ -79254,7 +81912,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/hooks/1/deliveries - last_response: &742 + last_response: &741 title: Hook Response type: object properties: @@ -79331,8 +81989,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#create-a-repository-webhook parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -79385,9 +82043,9 @@ paths: description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: &511 + default: &510 value: type: Repository id: 12345678 @@ -79435,17 +82093,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '200': description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: *511 + default: *510 '404': *6 x-github: githubCloudOnly: false @@ -79465,9 +82123,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#update-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 requestBody: required: true content: @@ -79512,9 +82170,9 @@ paths: description: Response content: application/json: - schema: *510 + schema: *509 examples: - default: *511 + default: *510 '422': *15 '404': *6 x-github: @@ -79535,9 +82193,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#delete-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -79561,9 +82219,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-webhook-configuration-for-a-repository parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '200': description: Response @@ -79590,9 +82248,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#update-a-webhook-configuration-for-a-repository parameters: + - *324 - *325 - - *326 - - *203 + - *202 requestBody: required: false content: @@ -79636,12 +82294,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#list-deliveries-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *17 + - *203 - *204 - - *205 responses: '200': description: Response @@ -79649,9 +82307,9 @@ paths: application/json: schema: type: array - items: *206 + items: *205 examples: - default: *207 + default: *206 '400': *14 '422': *15 x-github: @@ -79670,18 +82328,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#get-a-delivery-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *16 responses: '200': description: Response content: application/json: - schema: *208 + schema: *207 examples: - default: *209 + default: *208 '400': *14 '422': *15 x-github: @@ -79700,9 +82358,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#redeliver-a-delivery-for-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 - *16 responses: '202': *37 @@ -79725,9 +82383,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#ping-a-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -79752,9 +82410,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/webhooks#test-the-push-repository-webhook parameters: + - *324 - *325 - - *326 - - *203 + - *202 responses: '204': description: Response @@ -79777,8 +82435,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-immutable-releases-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response if immutable releases are enabled @@ -79826,10 +82484,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-immutable-releases parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '409': *52 x-github: githubCloudOnly: false @@ -79847,10 +82505,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-immutable-releases parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '409': *52 x-github: githubCloudOnly: false @@ -79905,14 +82563,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-an-import-status parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &512 + schema: &511 title: Import description: A repository import from an external source. type: object @@ -80019,7 +82677,7 @@ paths: - html_url - authors_url examples: - default: &515 + default: &514 value: vcs: subversion use_lfs: true @@ -80035,7 +82693,7 @@ paths: authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm '404': *6 - '503': &513 + '503': &512 description: Unavailable due to service under maintenance. content: application/json: @@ -80064,8 +82722,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#start-an-import parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -80113,7 +82771,7 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: default: value: @@ -80138,7 +82796,7 @@ paths: type: string '422': *15 '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80166,8 +82824,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#update-an-import parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -80219,7 +82877,7 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: example-1: summary: Example 1 @@ -80267,7 +82925,7 @@ paths: html_url: https://import.github.com/octocat/socm/import authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80290,12 +82948,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#cancel-an-import parameters: + - *324 - *325 - - *326 responses: '204': description: Response - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80321,9 +82979,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-commit-authors parameters: + - *324 - *325 - - *326 - - &676 + - &675 name: since description: A user ID. Only return users with an ID greater than this ID. in: query @@ -80337,7 +82995,7 @@ paths: application/json: schema: type: array - items: &514 + items: &513 title: Porter Author description: Porter Author type: object @@ -80391,7 +83049,7 @@ paths: url: https://api.github.com/repos/octocat/socm/import/authors/2268559 import_url: https://api.github.com/repos/octocat/socm/import '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80416,8 +83074,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#map-a-commit-author parameters: + - *324 - *325 - - *326 - name: author_id in: path required: true @@ -80447,7 +83105,7 @@ paths: description: Response content: application/json: - schema: *514 + schema: *513 examples: default: value: @@ -80460,7 +83118,7 @@ paths: import_url: https://api.github.com/repos/octocat/socm/import '422': *15 '404': *6 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80484,8 +83142,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#get-large-files parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -80526,7 +83184,7 @@ paths: path: foo/bar/3 oid: c20ad4d76fe97759aa27a0c99bff6710 size: 12582912 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80554,8 +83212,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/source-imports#update-git-lfs-preference parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -80582,11 +83240,11 @@ paths: description: Response content: application/json: - schema: *512 + schema: *511 examples: - default: *515 + default: *514 '422': *15 - '503': *513 + '503': *512 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -80609,8 +83267,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/apps/apps#get-a-repository-installation-for-the-authenticated-app parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -80618,8 +83276,8 @@ paths: application/json: schema: *20 examples: - default: *516 - '301': *329 + default: *515 + '301': *328 '404': *6 x-github: githubCloudOnly: false @@ -80639,8 +83297,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#get-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -80648,12 +83306,12 @@ paths: application/json: schema: anyOf: - - *222 + - *221 - type: object properties: {} additionalProperties: false examples: - default: &518 + default: &517 value: limit: collaborators_only origin: repository @@ -80678,13 +83336,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#set-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: application/json: - schema: *517 + schema: *516 examples: default: summary: Example request body @@ -80696,9 +83354,9 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: - default: *518 + default: *517 '409': description: Response x-github: @@ -80720,8 +83378,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/interactions/repos#remove-interaction-restrictions-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -80744,8 +83402,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#list-repository-invitations parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -80755,9 +83413,9 @@ paths: application/json: schema: type: array - items: *519 + items: *518 examples: - default: &669 + default: &668 value: - id: 1 repository: @@ -80888,9 +83546,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#update-a-repository-invitation parameters: + - *324 - *325 - - *326 - - *226 + - *225 requestBody: required: false content: @@ -80919,7 +83577,7 @@ paths: description: Response content: application/json: - schema: *519 + schema: *518 examples: default: value: @@ -81050,9 +83708,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#delete-a-repository-invitation parameters: + - *324 - *325 - - *326 - - *226 + - *225 responses: '204': description: Response @@ -81083,8 +83741,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#list-repository-issues parameters: + - *324 - *325 - - *326 - name: milestone description: If an `integer` is passed, it should refer to a milestone by its `number` field. If the string `*` is passed, issues with any milestone @@ -81132,7 +83790,7 @@ paths: required: false schema: type: string - - *233 + - *232 - name: sort description: What to sort results by. in: query @@ -81157,7 +83815,7 @@ paths: type: array items: *81 examples: - default: &528 + default: &527 value: - id: 1 node_id: MDU6SXNzdWUx @@ -81306,7 +83964,7 @@ paths: state_reason: completed headers: Link: *65 - '301': *329 + '301': *328 '422': *15 '404': *6 x-github: @@ -81335,8 +83993,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#create-an-issue parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -81428,7 +84086,7 @@ paths: application/json: schema: *81 examples: - default: &525 + default: &524 value: id: 1 node_id: MDU6SXNzdWUx @@ -81585,7 +84243,7 @@ paths: '422': *15 '503': *113 '404': *6 - '410': *520 + '410': *519 x-github: triggersNotification: true githubCloudOnly: false @@ -81623,8 +84281,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#list-issue-comments-for-a-repository parameters: + - *324 - *325 - - *326 - *103 - name: direction description: Either `asc` or `desc`. Ignored without the `sort` parameter. @@ -81647,7 +84305,7 @@ paths: type: array items: *82 examples: - default: &527 + default: &526 value: - id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -81705,8 +84363,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#get-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': @@ -81715,7 +84373,7 @@ paths: application/json: schema: *82 examples: - default: &521 + default: &520 value: id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -81770,8 +84428,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#update-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -81796,7 +84454,7 @@ paths: application/json: schema: *82 examples: - default: *521 + default: *520 '422': *15 x-github: githubCloudOnly: false @@ -81814,8 +84472,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#delete-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -81844,8 +84502,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#pin-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '200': @@ -81908,7 +84566,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -81925,8 +84583,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#unpin-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -81934,7 +84592,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 '503': *113 x-github: githubCloudOnly: false @@ -81952,8 +84610,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -81980,9 +84638,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -82003,8 +84661,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-an-issue-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -82037,16 +84695,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -82068,10 +84726,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-an-issue-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - *523 + - *522 responses: '204': description: Response @@ -82091,8 +84749,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#list-issue-events-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -82102,7 +84760,7 @@ paths: application/json: schema: type: array - items: &524 + items: &523 title: Issue Event description: Issue Event type: object @@ -82182,7 +84840,7 @@ paths: anyOf: - type: 'null' - *4 - requested_team: *188 + requested_team: *187 dismissed_review: title: Issue Event Dismissed Review type: object @@ -82442,8 +85100,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#get-an-issue-event parameters: + - *324 - *325 - - *326 - name: event_id in: path required: true @@ -82454,7 +85112,7 @@ paths: description: Response content: application/json: - schema: *524 + schema: *523 examples: default: value: @@ -82647,7 +85305,7 @@ paths: author_association: COLLABORATOR state_reason: completed '404': *6 - '410': *520 + '410': *519 '403': *27 x-github: githubCloudOnly: false @@ -82681,9 +85339,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#get-an-issue parameters: + - *324 - *325 - - *326 - - &526 + - &525 name: issue_number description: The number that identifies the issue. in: path @@ -82699,7 +85357,7 @@ paths: examples: default: summary: Issue - value: *525 + value: *524 pinned_comment: summary: Issue with pinned comment value: @@ -82898,9 +85556,9 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 '304': *35 x-github: githubCloudOnly: false @@ -82925,9 +85583,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#update-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83068,13 +85726,13 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 '422': *15 '503': *113 '403': *27 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83102,9 +85760,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#add-assignees-to-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -83132,7 +85790,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83148,9 +85806,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#remove-assignees-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: content: application/json: @@ -83177,7 +85835,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83199,9 +85857,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/assignees#check-if-a-user-can-be-assigned-to-a-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: assignee in: path required: true @@ -83241,9 +85899,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#list-issue-comments parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *86 - *17 - *19 @@ -83256,11 +85914,11 @@ paths: type: array items: *82 examples: - default: *527 + default: *526 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83289,9 +85947,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/comments#create-an-issue-comment parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -83315,14 +85973,14 @@ paths: application/json: schema: *82 examples: - default: *521 + default: *520 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/comments/1 schema: type: string '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -83350,9 +86008,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83364,12 +86022,12 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83397,9 +86055,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#add-a-dependency-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -83423,15 +86081,15 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/dependencies/blocked_by schema: type: string - '301': *329 + '301': *328 '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -83462,9 +86120,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#remove-dependency-an-issue-is-blocked-by parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: issue_id in: path description: The id of the blocking issue to remove as a dependency @@ -83478,13 +86136,13 @@ paths: application/json: schema: *81 examples: - default: *525 - '301': *329 + default: *524 + '301': *328 '400': *14 '401': *23 '403': *27 '404': *6 - '410': *520 + '410': *519 x-github: triggersNotification: true githubCloudOnly: false @@ -83510,9 +86168,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocking parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83524,12 +86182,12 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -83546,9 +86204,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/events#list-issue-events parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -83562,7 +86220,7 @@ paths: title: Issue Event for Issue description: Issue Event for Issue anyOf: - - &531 + - &530 title: Labeled Issue Event description: Labeled Issue Event type: object @@ -83611,7 +86269,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &532 + - &531 title: Unlabeled Issue Event description: Unlabeled Issue Event type: object @@ -83739,7 +86397,7 @@ paths: - performed_via_github_app - assignee - assigner - - &533 + - &532 title: Milestoned Issue Event description: Milestoned Issue Event type: object @@ -83785,7 +86443,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &534 + - &533 title: Demilestoned Issue Event description: Demilestoned Issue Event type: object @@ -83831,7 +86489,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &535 + - &534 title: Renamed Issue Event description: Renamed Issue Event type: object @@ -83880,7 +86538,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &536 + - &535 title: Review Requested Issue Event description: Review Requested Issue Event type: object @@ -83909,7 +86567,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *188 + requested_team: *187 requested_reviewer: *4 required: - review_requester @@ -83922,7 +86580,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &537 + - &536 title: Review Request Removed Issue Event description: Review Request Removed Issue Event type: object @@ -83951,7 +86609,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *188 + requested_team: *187 requested_reviewer: *4 required: - review_requester @@ -83964,7 +86622,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &538 + - &537 title: Review Dismissed Issue Event description: Review Dismissed Issue Event type: object @@ -84020,7 +86678,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &539 + - &538 title: Locked Issue Event description: Locked Issue Event type: object @@ -84065,7 +86723,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &540 + - &539 title: Added to Project Issue Event description: Added to Project Issue Event type: object @@ -84126,7 +86784,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &541 + - &540 title: Moved Column in Project Issue Event description: Moved Column in Project Issue Event type: object @@ -84187,7 +86845,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &542 + - &541 title: Removed from Project Issue Event description: Removed from Project Issue Event type: object @@ -84248,7 +86906,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &543 + - &542 title: Converted Note to Issue Issue Event description: Converted Note to Issue Issue Event type: object @@ -84341,7 +86999,7 @@ paths: color: red headers: Link: *65 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84358,9 +87016,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#list-issue-field-values-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -84370,9 +87028,9 @@ paths: application/json: schema: type: array - items: *529 + items: *528 examples: - default: &640 + default: &639 value: - issue_field_id: 1 node_id: IFT_GDKND @@ -84396,9 +87054,9 @@ paths: value: '2025-12-25' headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84415,9 +87073,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -84429,7 +87087,7 @@ paths: type: array items: *80 examples: - default: &530 + default: &529 value: - id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -84447,9 +87105,9 @@ paths: default: false headers: Link: *65 - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84465,9 +87123,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#add-labels-to-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -84512,10 +87170,10 @@ paths: type: array items: *80 examples: - default: *530 - '301': *329 + default: *529 + '301': *328 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -84532,9 +87190,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#set-labels-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -84596,10 +87254,10 @@ paths: type: array items: *80 examples: - default: *530 - '301': *329 + default: *529 + '301': *328 '404': *6 - '410': *520 + '410': *519 '422': *15 x-github: githubCloudOnly: false @@ -84616,15 +87274,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#remove-all-labels-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '204': description: Response - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84643,9 +87301,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#remove-a-label-from-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: name in: path required: true @@ -84669,9 +87327,9 @@ paths: description: Something isn't working color: f29513 default: true - '301': *329 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84691,9 +87349,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#lock-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: false content: @@ -84722,7 +87380,7 @@ paths: '204': description: Response '403': *27 - '410': *520 + '410': *519 '404': *6 '422': *15 x-github: @@ -84740,9 +87398,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issues#unlock-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '204': description: Response @@ -84772,9 +87430,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#get-parent-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 responses: '200': description: Response @@ -84782,10 +87440,10 @@ paths: application/json: schema: *81 examples: - default: *525 - '301': *329 + default: *524 + '301': *328 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84802,9 +87460,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue. @@ -84830,13 +87488,13 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84854,9 +87512,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84888,16 +87546,16 @@ paths: description: Response content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Response content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -84919,10 +87577,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-an-issue-reaction parameters: + - *324 - *325 - - *326 - - *526 - - *523 + - *525 + - *522 responses: '204': description: Response @@ -84951,9 +87609,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#remove-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -84977,7 +87635,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/sub-issue @@ -85010,9 +87668,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#list-sub-issues parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -85024,11 +87682,11 @@ paths: type: array items: *81 examples: - default: *528 + default: *527 headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -85056,9 +87714,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#add-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -85087,14 +87745,14 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/sub-issues/1 schema: type: string '403': *27 - '410': *520 + '410': *519 '422': *15 '404': *6 x-github: @@ -85114,9 +87772,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/sub-issues#reprioritize-sub-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 requestBody: required: true content: @@ -85149,7 +87807,7 @@ paths: application/json: schema: *81 examples: - default: *525 + default: *524 '403': *27 '404': *6 '422': *7 @@ -85171,9 +87829,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/timeline#list-timeline-events-for-an-issue parameters: + - *324 - *325 - - *326 - - *526 + - *525 - *17 - *19 responses: @@ -85188,6 +87846,7 @@ paths: description: Timeline Event type: object anyOf: + - *530 - *531 - *532 - *533 @@ -85200,7 +87859,6 @@ paths: - *540 - *541 - *542 - - *543 - title: Timeline Comment Event description: Timeline Comment Event type: object @@ -85257,7 +87915,7 @@ paths: pin: anyOf: - type: 'null' - - *544 + - *543 required: - event - actor @@ -85533,7 +88191,7 @@ paths: type: string comments: type: array - items: &563 + items: &562 title: Pull Request Review Comment description: Pull Request Review Comments are comments on a portion of the Pull Request's diff. @@ -85774,7 +88432,7 @@ paths: type: string comments: type: array - items: *453 + items: *452 - title: Timeline Assigned Issue Event description: Timeline Assigned Issue Event type: object @@ -86049,7 +88707,7 @@ paths: headers: Link: *65 '404': *6 - '410': *520 + '410': *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -86066,8 +88724,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#list-deploy-keys parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -86077,7 +88735,7 @@ paths: application/json: schema: type: array - items: &545 + items: &544 title: Deploy Key description: An SSH key granting access to a single repository. type: object @@ -86145,8 +88803,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#create-a-deploy-key parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86182,9 +88840,9 @@ paths: description: Response content: application/json: - schema: *545 + schema: *544 examples: - default: &546 + default: &545 value: id: 1 key: ssh-rsa AAA... @@ -86218,9 +88876,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#get-a-deploy-key parameters: + - *324 - *325 - - *326 - - &547 + - &546 name: key_id description: The unique identifier of the key. in: path @@ -86232,9 +88890,9 @@ paths: description: Response content: application/json: - schema: *545 + schema: *544 examples: - default: *546 + default: *545 '404': *6 x-github: githubCloudOnly: false @@ -86252,9 +88910,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/deploy-keys/deploy-keys#delete-a-deploy-key parameters: + - *324 - *325 - - *326 - - *547 + - *546 responses: '204': description: Response @@ -86274,8 +88932,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-a-repository parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -86287,7 +88945,7 @@ paths: type: array items: *80 examples: - default: *530 + default: *529 headers: Link: *65 '404': *6 @@ -86308,8 +88966,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#create-a-label parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86347,7 +89005,7 @@ paths: application/json: schema: *80 examples: - default: &548 + default: &547 value: id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -86379,8 +89037,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#get-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -86393,7 +89051,7 @@ paths: application/json: schema: *80 examples: - default: *548 + default: *547 '404': *6 x-github: githubCloudOnly: false @@ -86410,8 +89068,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#update-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -86476,8 +89134,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#delete-a-label parameters: + - *324 - *325 - - *326 - name: name in: path required: true @@ -86503,8 +89161,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-languages parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -86543,9 +89201,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/licenses/licenses#get-the-license-for-a-repository parameters: + - *324 - *325 - - *326 - - *428 + - *427 responses: '200': description: Response @@ -86692,8 +89350,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86758,8 +89416,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/branches/branches#merge-a-branch parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86793,9 +89451,9 @@ paths: description: Successful Response (The resulting merge commit) content: application/json: - schema: *456 + schema: *455 examples: - default: *549 + default: *548 '204': description: Response when already merged '404': @@ -86820,8 +89478,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#list-milestones parameters: + - *324 - *325 - - *326 - name: state description: The state of the milestone. Either `open`, `closed`, or `all`. in: query @@ -86862,7 +89520,7 @@ paths: application/json: schema: type: array - items: *266 + items: *265 examples: default: value: @@ -86918,8 +89576,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#create-a-milestone parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -86959,9 +89617,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: &550 + default: &549 value: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -87020,9 +89678,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#get-a-milestone parameters: + - *324 - *325 - - *326 - - &551 + - &550 name: milestone_number description: The number that identifies the milestone. in: path @@ -87034,9 +89692,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: *550 + default: *549 '404': *6 x-github: githubCloudOnly: false @@ -87053,9 +89711,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#update-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 requestBody: required: false content: @@ -87093,9 +89751,9 @@ paths: description: Response content: application/json: - schema: *266 + schema: *265 examples: - default: *550 + default: *549 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -87111,9 +89769,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/milestones#delete-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 responses: '204': description: Response @@ -87134,9 +89792,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/labels#list-labels-for-issues-in-a-milestone parameters: + - *324 - *325 - - *326 - - *551 + - *550 - *17 - *19 responses: @@ -87148,7 +89806,7 @@ paths: type: array items: *80 examples: - default: *530 + default: *529 headers: Link: *65 x-github: @@ -87167,12 +89825,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#list-repository-notifications-for-the-authenticated-user parameters: + - *324 - *325 - - *326 + - *551 - *552 - - *553 - *86 - - *554 + - *553 - *17 - *19 responses: @@ -87184,7 +89842,7 @@ paths: type: array items: *106 examples: - default: *555 + default: *554 headers: Link: *65 x-github: @@ -87208,8 +89866,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/notifications#mark-repository-notifications-as-read parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -87267,14 +89925,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-a-apiname-pages-site parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: &556 + schema: &555 title: GitHub Pages description: The configuration for GitHub Pages for a repository. type: object @@ -87418,7 +90076,7 @@ paths: - custom_404 - public examples: - default: &557 + default: &556 value: url: https://api.github.com/repos/github/developer.github.com/pages status: built @@ -87459,8 +90117,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#create-a-apiname-pages-site parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -87515,9 +90173,9 @@ paths: description: Response content: application/json: - schema: *556 + schema: *555 examples: - default: *557 + default: *556 '422': *15 '409': *52 x-github: @@ -87540,8 +90198,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#update-information-about-a-apiname-pages-site parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -87641,8 +90299,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#delete-a-apiname-pages-site parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -87668,8 +90326,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#list-apiname-pages-builds parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -87679,7 +90337,7 @@ paths: application/json: schema: type: array - items: &558 + items: &557 title: Page Build description: Page Build type: object @@ -87771,8 +90429,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#request-a-apiname-pages-build parameters: + - *324 - *325 - - *326 responses: '201': description: Response @@ -87819,16 +90477,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-latest-pages-build parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *558 + schema: *557 examples: - default: &559 + default: &558 value: url: https://api.github.com/repos/github/developer.github.com/pages/builds/5472601 status: built @@ -87876,8 +90534,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-apiname-pages-build parameters: + - *324 - *325 - - *326 - name: build_id in: path required: true @@ -87888,9 +90546,9 @@ paths: description: Response content: application/json: - schema: *558 + schema: *557 examples: - default: *559 + default: *558 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -87910,8 +90568,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#create-a-github-pages-deployment parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -88019,9 +90677,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-the-status-of-a-github-pages-deployment parameters: + - *324 - *325 - - *326 - - &560 + - &559 name: pages_deployment_id description: The ID of the Pages deployment. You can also give the commit SHA of the deployment. @@ -88079,11 +90737,11 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#cancel-a-github-pages-deployment parameters: + - *324 - *325 - - *326 - - *560 + - *559 responses: - '204': *184 + '204': *183 '404': *6 x-github: githubCloudOnly: false @@ -88108,8 +90766,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pages/pages#get-a-dns-health-check-for-github-pages parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -88377,7 +91035,7 @@ paths: description: Empty response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -88404,8 +91062,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-private-vulnerability-reporting-is-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Private vulnerability reporting status @@ -88442,10 +91100,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-private-vulnerability-reporting-for-a-repository parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '422': *14 x-github: githubCloudOnly: false @@ -88464,10 +91122,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-private-vulnerability-reporting-for-a-repository parameters: + - *324 - *325 - - *326 responses: - '204': *184 + '204': *183 '422': *14 x-github: githubCloudOnly: false @@ -88487,8 +91145,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/custom-properties#get-all-custom-property-values-for-a-repository parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -88496,7 +91154,7 @@ paths: application/json: schema: type: array - items: *280 + items: *279 examples: default: value: @@ -88527,8 +91185,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/custom-properties#create-or-update-custom-property-values-for-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -88540,7 +91198,7 @@ paths: type: array description: A list of custom property names and associated values to apply to the repositories. - items: *280 + items: *279 required: - properties examples: @@ -88590,8 +91248,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-pull-requests parameters: + - *324 - *325 - - *326 - name: state description: Either `open`, `closed`, or `all` to filter by state. in: query @@ -88651,9 +91309,9 @@ paths: application/json: schema: type: array - items: *460 + items: *459 examples: - default: *561 + default: *560 headers: Link: *65 '304': *35 @@ -88685,8 +91343,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#create-a-pull-request parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -88753,7 +91411,7 @@ paths: description: Response content: application/json: - schema: &565 + schema: &564 type: object title: Pull Request description: Pull requests let you tell others about changes you've @@ -88882,7 +91540,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 active_lock_reason: type: - string @@ -88931,7 +91589,7 @@ paths: items: *4 requested_teams: type: array - items: *245 + items: *244 head: type: object properties: @@ -88969,14 +91627,14 @@ paths: _links: type: object properties: - comments: *267 - commits: *267 - statuses: *267 - html: *267 - issue: *267 - review_comments: *267 - review_comment: *267 - self: *267 + comments: *266 + commits: *266 + statuses: *266 + html: *266 + issue: *266 + review_comments: *266 + review_comment: *266 + self: *266 required: - comments - commits @@ -88987,7 +91645,7 @@ paths: - review_comment - self author_association: *78 - auto_merge: *562 + auto_merge: *561 draft: description: Indicates whether or not the pull request is a draft. type: boolean @@ -89183,7 +91841,7 @@ paths: - review_comments version: '2026-03-10' examples: - default: &566 + default: &565 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -89710,8 +92368,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#list-review-comments-in-a-repository parameters: + - *324 - *325 - - *326 - name: sort in: query required: false @@ -89740,9 +92398,9 @@ paths: application/json: schema: type: array - items: *563 + items: *562 examples: - default: &568 + default: &567 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -89819,17 +92477,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 responses: '200': description: Response content: application/json: - schema: *563 + schema: *562 examples: - default: &564 + default: &563 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -89904,8 +92562,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#update-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -89928,9 +92586,9 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: - default: *564 + default: *563 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -89946,8 +92604,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#delete-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - *95 responses: '204': @@ -89969,8 +92627,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-pull-request-review-comment parameters: + - *324 - *325 - - *326 - *95 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). @@ -89997,9 +92655,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -90020,8 +92678,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-pull-request-review-comment parameters: + - *324 - *325 - - *326 - *95 requestBody: required: true @@ -90054,16 +92712,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -90085,10 +92743,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-pull-request-comment-reaction parameters: + - *324 - *325 - - *326 - *95 - - *523 + - *522 responses: '204': description: Response @@ -90131,9 +92789,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#get-a-pull-request parameters: + - *324 - *325 - - *326 - - &567 + - &566 name: pull_number description: The number that identifies the pull request. in: path @@ -90146,9 +92804,9 @@ paths: to fetch diff and patch formats. content: application/json: - schema: *565 + schema: *564 examples: - default: *566 + default: *565 '304': *35 '404': *6 '406': @@ -90183,9 +92841,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#update-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -90227,9 +92885,9 @@ paths: description: Response content: application/json: - schema: *565 + schema: *564 examples: - default: *566 + default: *565 '422': *15 '403': *27 x-github: @@ -90251,9 +92909,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-codespace-from-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -90314,17 +92972,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -90354,9 +93012,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#list-review-comments-on-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *103 - name: direction description: The direction to sort results. Ignored without `sort` parameter. @@ -90377,9 +93035,9 @@ paths: application/json: schema: type: array - items: *563 + items: *562 examples: - default: *568 + default: *567 headers: Link: *65 x-github: @@ -90412,9 +93070,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#create-a-review-comment-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -90520,7 +93178,7 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: example-for-a-multi-line-comment: value: @@ -90608,9 +93266,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/comments#create-a-reply-for-a-review-comment parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *95 requestBody: required: true @@ -90633,7 +93291,7 @@ paths: description: Response content: application/json: - schema: *563 + schema: *562 examples: default: value: @@ -90719,9 +93377,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-commits-on-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -90731,9 +93389,9 @@ paths: application/json: schema: type: array - items: *456 + items: *455 examples: - default: *569 + default: *568 headers: Link: *65 x-github: @@ -90763,9 +93421,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#list-pull-requests-files parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -90775,7 +93433,7 @@ paths: application/json: schema: type: array - items: *467 + items: *466 examples: default: value: @@ -90813,9 +93471,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#check-if-a-pull-request-has-been-merged parameters: + - *324 - *325 - - *326 - - *567 + - *566 responses: '204': description: Response if pull request has been merged @@ -90838,9 +93496,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#merge-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -90952,9 +93610,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 responses: '200': description: Response @@ -90970,7 +93628,7 @@ paths: items: *4 teams: type: array - items: *188 + items: *187 required: - users - teams @@ -91029,9 +93687,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#request-reviewers-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -91068,7 +93726,7 @@ paths: description: Response content: application/json: - schema: *460 + schema: *459 examples: default: value: @@ -91604,9 +94262,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: true content: @@ -91640,7 +94298,7 @@ paths: description: Response content: application/json: - schema: *460 + schema: *459 examples: default: value: @@ -92145,9 +94803,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#list-reviews-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 - *17 - *19 responses: @@ -92157,7 +94815,7 @@ paths: application/json: schema: type: array - items: &570 + items: &569 title: Pull Request Review description: Pull Request Reviews are reviews on pull requests. type: object @@ -92313,9 +94971,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#create-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -92405,9 +95063,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: &572 + default: &571 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -92470,10 +95128,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#get-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - &571 + - *566 + - &570 name: review_id description: The unique identifier of the review. in: path @@ -92485,9 +95143,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: &573 + default: &572 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -92546,10 +95204,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#update-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -92572,7 +95230,7 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: default: value: @@ -92634,18 +95292,18 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#delete-a-pending-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 responses: '200': description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: *572 + default: *571 '422': *7 '404': *6 x-github: @@ -92672,10 +95330,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#list-comments-for-a-pull-request-review parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 - *17 - *19 responses: @@ -92773,9 +95431,9 @@ paths: _links: type: object properties: - self: *267 - html: *267 - pull_request: *267 + self: *266 + html: *266 + pull_request: *266 required: - self - html @@ -92933,10 +95591,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#dismiss-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -92965,7 +95623,7 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: default: value: @@ -93028,10 +95686,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/reviews#submit-a-review-for-a-pull-request parameters: + - *324 - *325 - - *326 - - *567 - - *571 + - *566 + - *570 requestBody: required: true content: @@ -93066,9 +95724,9 @@ paths: description: Response content: application/json: - schema: *570 + schema: *569 examples: - default: *573 + default: *572 '404': *6 '422': *7 '403': *27 @@ -93090,9 +95748,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/pulls/pulls#update-a-pull-request-branch parameters: + - *324 - *325 - - *326 - - *567 + - *566 requestBody: required: false content: @@ -93156,8 +95814,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-a-repository-readme parameters: + - *324 - *325 - - *326 - name: ref description: 'The name of the commit/branch/tag. Default: the repository’s default branch.' @@ -93170,9 +95828,9 @@ paths: description: Response content: application/json: - schema: *574 + schema: *573 examples: - default: &575 + default: &574 value: type: file encoding: base64 @@ -93214,8 +95872,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/contents#get-a-repository-readme-for-a-directory parameters: + - *324 - *325 - - *326 - name: dir description: The alternate path to look for a README file in: path @@ -93235,9 +95893,9 @@ paths: description: Response content: application/json: - schema: *574 + schema: *573 examples: - default: *575 + default: *574 '404': *6 '422': *15 x-github: @@ -93259,8 +95917,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#list-releases parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -93270,7 +95928,7 @@ paths: application/json: schema: type: array - items: *576 + items: *575 examples: default: value: @@ -93364,8 +96022,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#create-a-release parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -93441,9 +96099,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: &580 + default: &579 value: url: https://api.github.com/repos/octocat/Hello-World/releases/1 html_url: https://github.com/octocat/Hello-World/releases/v1.0.0 @@ -93548,9 +96206,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#get-a-release-asset parameters: + - *324 - *325 - - *326 - - &578 + - &577 name: asset_id description: The unique identifier of the asset. in: path @@ -93562,9 +96220,9 @@ paths: description: Response content: application/json: - schema: *577 + schema: *576 examples: - default: &579 + default: &578 value: url: https://api.github.com/repos/octocat/Hello-World/releases/assets/1 browser_download_url: https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip @@ -93599,7 +96257,7 @@ paths: type: User site_admin: false '404': *6 - '302': *469 + '302': *468 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93615,9 +96273,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#update-a-release-asset parameters: + - *324 - *325 - - *326 - - *578 + - *577 requestBody: required: false content: @@ -93646,9 +96304,9 @@ paths: description: Response content: application/json: - schema: *577 + schema: *576 examples: - default: *579 + default: *578 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93664,9 +96322,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#delete-a-release-asset parameters: + - *324 - *325 - - *326 - - *578 + - *577 responses: '204': description: Response @@ -93691,8 +96349,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#generate-release-notes-content-for-a-release parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -93778,16 +96436,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-the-latest-release parameters: + - *324 - *325 - - *326 responses: '200': description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': *6 x-github: githubCloudOnly: false @@ -93805,8 +96463,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-a-release-by-tag-name parameters: + - *324 - *325 - - *326 - name: tag description: tag parameter in: path @@ -93819,9 +96477,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': *6 x-github: githubCloudOnly: false @@ -93843,9 +96501,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#get-a-release parameters: + - *324 - *325 - - *326 - - &581 + - &580 name: release_id description: The unique identifier of the release. in: path @@ -93859,9 +96517,9 @@ paths: For more information, see "[Getting started with the REST API](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia)."' content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '401': description: Unauthorized x-github: @@ -93879,9 +96537,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#update-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 requestBody: required: false content: @@ -93945,9 +96603,9 @@ paths: description: Response content: application/json: - schema: *576 + schema: *575 examples: - default: *580 + default: *579 '404': description: Not Found if the discussion category name is invalid content: @@ -93968,9 +96626,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/releases#delete-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 responses: '204': description: Response @@ -93991,9 +96649,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/releases/assets#list-release-assets parameters: + - *324 - *325 - - *326 - - *581 + - *580 - *17 - *19 responses: @@ -94003,7 +96661,7 @@ paths: application/json: schema: type: array - items: *577 + items: *576 examples: default: value: @@ -94084,9 +96742,9 @@ paths: description: The URL origin (protocol + host name + port) is included in `upload_url` returned in the response of the "Create a release" endpoint parameters: + - *324 - *325 - - *326 - - *581 + - *580 - name: name in: query required: true @@ -94112,7 +96770,7 @@ paths: description: Response for successful upload content: application/json: - schema: *577 + schema: *576 examples: response-for-successful-upload: value: @@ -94167,9 +96825,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#list-reactions-for-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 - name: content description: Returns a single [reaction type](https://docs.github.com/rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a release. @@ -94193,9 +96851,9 @@ paths: application/json: schema: type: array - items: *454 + items: *453 examples: - default: *522 + default: *521 headers: Link: *65 '404': *6 @@ -94216,9 +96874,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#create-reaction-for-a-release parameters: + - *324 - *325 - - *326 - - *581 + - *580 requestBody: required: true content: @@ -94248,16 +96906,16 @@ paths: description: Reaction exists content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '201': description: Reaction created content: application/json: - schema: *454 + schema: *453 examples: - default: *455 + default: *454 '422': *15 x-github: githubCloudOnly: false @@ -94279,10 +96937,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/reactions/reactions#delete-a-release-reaction parameters: + - *324 - *325 - - *326 - - *581 - - *523 + - *580 + - *522 responses: '204': description: Response @@ -94306,9 +96964,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-rules-for-a-branch parameters: + - *324 - *325 - - *326 - - *392 + - *391 - *17 - *19 responses: @@ -94324,8 +96982,8 @@ paths: description: A repository rule with ruleset details. oneOf: - allOf: - - *287 - - &582 + - *286 + - &581 title: repository ruleset data for rule description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -94344,69 +97002,69 @@ paths: ruleset_id: type: integer description: The ID of the ruleset that includes this rule. + - allOf: + - *287 + - *581 - allOf: - *288 - - *582 + - *581 - allOf: - *289 - - *582 + - *581 - allOf: - - *290 - *582 + - *581 - allOf: - - *583 - - *582 + - *290 + - *581 - allOf: - *291 - - *582 + - *581 - allOf: - *292 - - *582 + - *581 - allOf: - *293 - - *582 + - *581 - allOf: - *294 - - *582 + - *581 - allOf: - *295 - - *582 + - *581 - allOf: - *296 - - *582 + - *581 - allOf: - *297 - - *582 + - *581 - allOf: - *298 - - *582 + - *581 - allOf: - *299 - - *582 + - *581 - allOf: - *300 - - *582 + - *581 - allOf: - *301 - - *582 + - *581 - allOf: - *302 - - *582 + - *581 - allOf: - *303 - - *582 + - *581 - allOf: - *304 - - *582 + - *581 - allOf: - *305 - - *582 + - *581 - allOf: - *306 - - *582 - - allOf: - - *307 - - *582 + - *581 examples: default: value: @@ -94445,8 +97103,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - *17 - *19 - name: includes_parents @@ -94457,7 +97115,7 @@ paths: schema: type: boolean default: true - - *584 + - *583 responses: '200': description: Response @@ -94465,7 +97123,7 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: default: value: @@ -94512,8 +97170,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 requestBody: description: Request body required: true @@ -94533,16 +97191,16 @@ paths: - tag - push default: branch - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *282 + items: *284 + conditions: *281 rules: type: array description: An array of rules within the ruleset. - items: *585 + items: *584 required: - name - enforcement @@ -94573,9 +97231,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: &595 + default: &594 value: id: 42 name: super cool ruleset @@ -94623,12 +97281,12 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rule-suites#list-repository-rule-suites parameters: + - *324 - *325 - - *326 + - *585 - *586 - *587 - *588 - - *589 - *17 - *19 responses: @@ -94636,9 +97294,9 @@ paths: description: Response content: application/json: - schema: *590 + schema: *589 examples: - default: *591 + default: *590 '404': *6 '500': *53 x-github: @@ -94659,17 +97317,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rule-suites#get-a-repository-rule-suite parameters: + - *324 - *325 - - *326 - - *592 + - *591 responses: '200': description: Response content: application/json: - schema: *593 + schema: *592 examples: - default: *594 + default: *593 '404': *6 '500': *53 x-github: @@ -94697,8 +97355,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94718,9 +97376,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *595 + default: *594 '404': *6 '500': *53 put: @@ -94738,8 +97396,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94764,16 +97422,16 @@ paths: - branch - tag - push - enforcement: *284 + enforcement: *283 bypass_actors: type: array description: The actors that can bypass the rules in this ruleset - items: *285 - conditions: *282 + items: *284 + conditions: *281 rules: description: An array of rules within the ruleset. type: array - items: *585 + items: *584 examples: default: value: @@ -94801,9 +97459,9 @@ paths: description: Response content: application/json: - schema: *308 + schema: *307 examples: - default: *595 + default: *594 '404': *6 '422': *15 '500': *53 @@ -94822,8 +97480,8 @@ paths: category: repos subcategory: rules parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94846,8 +97504,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-repository-ruleset-history parameters: + - *324 - *325 - - *326 - *17 - *19 - name: ruleset_id @@ -94863,9 +97521,9 @@ paths: application/json: schema: type: array - items: *311 + items: *310 examples: - default: *596 + default: *595 '404': *6 '500': *53 x-github: @@ -94884,8 +97542,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/rules#get-repository-ruleset-version parameters: + - *324 - *325 - - *326 - name: ruleset_id description: The ID of the ruleset. in: path @@ -94903,7 +97561,7 @@ paths: description: Response content: application/json: - schema: *597 + schema: *596 examples: default: value: @@ -94958,22 +97616,22 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository parameters: + - *324 - *325 - - *326 + - *597 - *598 - *599 - *600 - *601 - - *602 - *59 - *19 - *17 + - *602 - *603 - *604 - *605 - *606 - *607 - - *608 responses: '200': description: Response @@ -94981,24 +97639,24 @@ paths: application/json: schema: type: array - items: &612 + items: &611 type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri description: The REST API URL of the code locations for this alert. - state: *609 - resolution: *610 + state: *608 + resolution: *609 resolved_at: type: - string @@ -95092,7 +97750,7 @@ paths: first_location_detected: anyOf: - type: 'null' - - *611 + - *610 has_more_locations: type: boolean description: A boolean value representing whether or not the @@ -95237,16 +97895,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 - - *608 + - *421 + - *607 responses: '200': description: Response content: application/json: - schema: *612 + schema: *611 examples: default: value: @@ -95300,9 +97958,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#update-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 requestBody: required: true content: @@ -95310,8 +97968,8 @@ paths: schema: type: object properties: - state: *609 - resolution: *610 + state: *608 + resolution: *609 resolution_comment: description: An optional comment when closing or reopening an alert. Cannot be updated or deleted. @@ -95349,7 +98007,7 @@ paths: description: Response content: application/json: - schema: *612 + schema: *611 examples: default: value: @@ -95444,9 +98102,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert parameters: + - *324 - *325 - - *326 - - *422 + - *421 - *19 - *17 responses: @@ -95457,7 +98115,7 @@ paths: schema: type: array description: List of locations where the secret was detected - items: &762 + items: &761 type: object properties: type: @@ -95484,6 +98142,7 @@ paths: - commit details: oneOf: + - *612 - *613 - *614 - *615 @@ -95496,7 +98155,6 @@ paths: - *622 - *623 - *624 - - *625 examples: default: value: @@ -95582,8 +98240,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#create-a-push-protection-bypass parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -95591,14 +98249,14 @@ paths: schema: type: object properties: - reason: &627 + reason: &626 description: The reason for bypassing push protection. type: string enum: - false_positive - used_in_tests - will_fix_later - placeholder_id: *626 + placeholder_id: *625 required: - reason - placeholder_id @@ -95615,7 +98273,7 @@ paths: schema: type: object properties: - reason: *627 + reason: *626 expire_at: type: - string @@ -95662,8 +98320,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/secret-scanning/secret-scanning#get-secret-scanning-scan-history-for-a-repository parameters: + - *324 - *325 - - *326 responses: '404': description: Repository does not have GitHub Advanced Security or secret @@ -95678,7 +98336,7 @@ paths: properties: incremental_scans: type: array - items: &628 + items: &627 description: Information on a single scan performed by secret scanning on the repository type: object @@ -95706,15 +98364,15 @@ paths: the scan is pending pattern_update_scans: type: array - items: *628 + items: *627 backfill_scans: type: array - items: *628 + items: *627 custom_pattern_backfill_scans: type: array items: allOf: - - *628 + - *627 - type: object properties: pattern_name: @@ -95784,8 +98442,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#list-repository-security-advisories parameters: + - *324 - *325 - - *326 - *59 - name: sort description: The property to sort the results by. @@ -95829,9 +98487,9 @@ paths: application/json: schema: type: array - items: *629 + items: *628 examples: - default: *630 + default: *629 '400': *14 '404': *6 x-github: @@ -95854,8 +98512,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#create-a-repository-security-advisory parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -95935,7 +98593,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 required: - login - type @@ -96025,9 +98683,9 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: &632 + default: &631 value: ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -96260,8 +98918,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -96374,7 +99032,7 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: default: value: @@ -96521,17 +99179,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#get-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '200': description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *632 + default: *631 '403': *27 '404': *6 x-github: @@ -96555,9 +99213,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#update-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 requestBody: required: true content: @@ -96637,7 +99295,7 @@ paths: login: type: string description: The username of the user credited. - type: *314 + type: *313 required: - login - type @@ -96728,10 +99386,10 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *632 - add_credit: *632 + default: *631 + add_credit: *631 '403': *27 '404': *6 '422': @@ -96769,9 +99427,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#request-a-cve-for-a-repository-security-advisory parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '202': *37 '400': *14 @@ -96798,17 +99456,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/security-advisories/repository-advisories#create-a-temporary-private-fork parameters: + - *324 - *325 - - *326 - - *631 + - *630 responses: '202': description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 '400': *14 '422': *15 '403': *27 @@ -96834,8 +99492,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#list-stargazers parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -96931,8 +99589,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-weekly-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Returns a weekly aggregate of the number of additions and deletions @@ -96941,7 +99599,7 @@ paths: application/json: schema: type: array - items: &633 + items: &632 title: Code Frequency Stat description: Code Frequency Stat type: array @@ -96954,7 +99612,7 @@ paths: - 1124 - -435 '202': *37 - '204': *184 + '204': *183 '422': description: Repository contains more than 10,000 commits x-github: @@ -96974,8 +99632,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-last-year-of-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -97026,7 +99684,7 @@ paths: total: 89 week: 1336280400 '202': *37 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97053,8 +99711,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-all-contributor-commit-activity parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -97126,7 +99784,7 @@ paths: d: 77 c: 10 '202': *37 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97148,8 +99806,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-weekly-commit-count parameters: + - *324 - *325 - - *326 responses: '200': description: The array order is oldest week (index 0) to most recent week. @@ -97303,8 +99961,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/statistics#get-the-hourly-commit-count-for-each-day parameters: + - *324 - *325 - - *326 responses: '200': description: For example, `[2, 14, 25]` indicates that there were 25 total @@ -97314,7 +99972,7 @@ paths: application/json: schema: type: array - items: *633 + items: *632 examples: default: value: @@ -97327,7 +99985,7 @@ paths: - - 0 - 2 - 21 - '204': *184 + '204': *183 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97347,8 +100005,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/commits/statuses#create-a-commit-status parameters: + - *324 - *325 - - *326 - name: sha in: path required: true @@ -97404,7 +100062,7 @@ paths: description: Response content: application/json: - schema: *634 + schema: *633 examples: default: value: @@ -97458,8 +100116,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#list-watchers parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -97491,14 +100149,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#get-a-repository-subscription parameters: + - *324 - *325 - - *326 responses: '200': description: if you subscribe to the repository content: application/json: - schema: &635 + schema: &634 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -97571,8 +100229,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#set-a-repository-subscription parameters: + - *324 - *325 - - *326 requestBody: required: false content: @@ -97598,7 +100256,7 @@ paths: description: Response content: application/json: - schema: *635 + schema: *634 examples: default: value: @@ -97625,8 +100283,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/watching#delete-a-repository-subscription parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -97646,8 +100304,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-tags parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -97729,8 +100387,8 @@ paths: url: https://docs.github.com/rest/repos/contents#download-a-repository-archive-tar operationId: repos/download-tarball-archive parameters: + - *324 - *325 - - *326 - name: ref in: path required: true @@ -97766,8 +100424,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#list-repository-teams parameters: + - *324 - *325 - - *326 - *17 - *19 responses: @@ -97777,9 +100435,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - default: *246 + default: *245 headers: Link: *65 '404': *6 @@ -97799,8 +100457,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#get-all-repository-topics parameters: + - *324 - *325 - - *326 - *19 - *17 responses: @@ -97808,7 +100466,7 @@ paths: description: Response content: application/json: - schema: &636 + schema: &635 title: Topic description: A topic aggregates entities that are related to a subject. type: object @@ -97820,7 +100478,7 @@ paths: required: - names examples: - default: &637 + default: &636 value: names: - octocat @@ -97843,8 +100501,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#replace-all-repository-topics parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -97875,9 +100533,9 @@ paths: description: Response content: application/json: - schema: *636 + schema: *635 examples: - default: *637 + default: *636 '404': *6 '422': *7 x-github: @@ -97898,9 +100556,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-repository-clones parameters: + - *324 - *325 - - *326 - - &638 + - &637 name: per description: The time frame to display results for. in: query @@ -97931,7 +100589,7 @@ paths: - 128 clones: type: array - items: &639 + items: &638 title: Traffic type: object properties: @@ -98018,8 +100676,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-top-referral-paths parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -98113,8 +100771,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-top-referral-sources parameters: + - *324 - *325 - - *326 responses: '200': description: Response @@ -98177,9 +100835,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/metrics/traffic#get-page-views parameters: + - *324 - *325 - - *326 - - *638 + - *637 responses: '200': description: Response @@ -98200,7 +100858,7 @@ paths: - 3782 views: type: array - items: *639 + items: *638 required: - uniques - count @@ -98277,8 +100935,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#transfer-a-repository parameters: + - *324 - *325 - - *326 requestBody: required: true content: @@ -98314,7 +100972,7 @@ paths: description: Response content: application/json: - schema: *153 + schema: *152 examples: default: value: @@ -98552,8 +101210,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository parameters: + - *324 - *325 - - *326 responses: '204': description: Response if repository is enabled with vulnerability alerts @@ -98576,8 +101234,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#enable-vulnerability-alerts parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -98599,8 +101257,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/repos/repos#disable-vulnerability-alerts parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -98626,8 +101284,8 @@ paths: url: https://docs.github.com/rest/repos/contents#download-a-repository-archive-zip operationId: repos/download-zipball-archive parameters: + - *324 - *325 - - *326 - name: ref in: path required: true @@ -98719,9 +101377,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -98762,7 +101420,7 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: default: value: @@ -98868,8 +101526,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#add-issue-field-values-to-an-issue parameters: - - *142 - - *526 + - *141 + - *525 requestBody: required: true content: @@ -98935,9 +101593,9 @@ paths: type: array description: The current issue field values for this issue after adding the new values - items: *529 + items: *528 examples: - default: *640 + default: *639 '400': *14 '403': *27 '404': *6 @@ -98973,8 +101631,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#set-issue-field-values-for-an-issue parameters: - - *142 - - *526 + - *141 + - *525 requestBody: required: true content: @@ -99041,9 +101699,9 @@ paths: type: array description: The current issue field values for this issue after setting the new values - items: *529 + items: *528 examples: - default: *640 + default: *639 '400': *14 '403': *27 '404': *6 @@ -99074,9 +101732,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/issues/issue-field-values#delete-an-issue-field-value-from-an-issue parameters: - - *142 - - *526 - - *229 + - *141 + - *525 + - *228 responses: '204': description: Issue field value deleted successfully @@ -99197,7 +101855,7 @@ paths: html_url: type: string format: uri - repository: *153 + repository: *152 score: type: number file_size: @@ -99216,7 +101874,7 @@ paths: examples: - 73..77 - 77..78 - text_matches: &641 + text_matches: &640 title: Search Result Text Matches type: array items: @@ -99379,7 +102037,7 @@ paths: enum: - author-date - committer-date - - &642 + - &641 name: order description: Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter @@ -99448,7 +102106,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 comment_count: type: integer message: @@ -99467,7 +102125,7 @@ paths: url: type: string format: uri - verification: *506 + verification: *505 required: - author - committer @@ -99482,7 +102140,7 @@ paths: committer: anyOf: - type: 'null' - - *390 + - *389 parents: type: array items: @@ -99494,12 +102152,12 @@ paths: type: string sha: type: string - repository: *153 + repository: *152 score: type: number node_id: type: string - text_matches: *641 + text_matches: *640 required: - sha - node_id @@ -99691,7 +102349,7 @@ paths: - interactions - created - updated - - *642 + - *641 - *17 - *19 - name: advanced_search @@ -99805,11 +102463,11 @@ paths: type: - string - 'null' - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: type: string state_reason: @@ -99823,7 +102481,7 @@ paths: milestone: anyOf: - type: 'null' - - *266 + - *265 comments: type: integer created_at: @@ -99837,7 +102495,7 @@ paths: - string - 'null' format: date-time - text_matches: *641 + text_matches: *640 pull_request: type: object properties: @@ -99886,7 +102544,7 @@ paths: timeline_url: type: string format: uri - type: *230 + type: *229 performed_via_github_app: anyOf: - type: 'null' @@ -100131,7 +102789,7 @@ paths: enum: - created - updated - - *642 + - *641 - *17 - *19 responses: @@ -100176,7 +102834,7 @@ paths: - 'null' score: type: number - text_matches: *641 + text_matches: *640 required: - id - node_id @@ -100261,7 +102919,7 @@ paths: - forks - help-wanted-issues - updated - - *642 + - *641 - *17 - *19 responses: @@ -100507,7 +103165,7 @@ paths: - admin - pull - push - text_matches: *641 + text_matches: *640 temp_clone_token: type: string allow_merge_commit: @@ -100815,7 +103473,7 @@ paths: - string - 'null' format: uri - text_matches: *641 + text_matches: *640 related: type: - array @@ -101008,7 +103666,7 @@ paths: - followers - repositories - joined - - *642 + - *641 - *17 - *19 responses: @@ -101118,7 +103776,7 @@ paths: type: - boolean - 'null' - text_matches: *641 + text_matches: *640 blog: type: - string @@ -101200,7 +103858,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#get-a-team-legacy parameters: - - &645 + - &644 name: team_id description: The unique identifier of the team. in: path @@ -101212,9 +103870,9 @@ paths: description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 x-github: githubCloudOnly: false @@ -101241,7 +103899,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#update-a-team-legacy parameters: - - *645 + - *644 requestBody: required: true content: @@ -101305,16 +103963,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '201': description: Response content: application/json: - schema: *321 + schema: *320 examples: - default: *322 + default: *321 '404': *6 '422': *15 '403': *27 @@ -101342,7 +104000,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#delete-a-team-legacy parameters: - - *645 + - *644 responses: '204': description: Response @@ -101371,7 +104029,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#list-pending-team-invitations-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -101381,9 +104039,9 @@ paths: application/json: schema: type: array - items: *224 + items: *223 examples: - default: *225 + default: *224 headers: Link: *65 x-github: @@ -101409,7 +104067,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#list-team-members-legacy parameters: - - *645 + - *644 - name: role description: Filters members returned by their role in the team. in: query @@ -101460,7 +104118,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#get-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -101497,7 +104155,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#add-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -101537,7 +104195,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#remove-team-member-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -101574,16 +104232,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#get-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 responses: '200': description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-user-is-a-team-maintainer: *646 + response-if-user-is-a-team-maintainer: *645 '404': *6 x-github: githubCloudOnly: false @@ -101616,7 +104274,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 requestBody: required: false @@ -101642,9 +104300,9 @@ paths: description: Response content: application/json: - schema: *324 + schema: *323 examples: - response-if-users-membership-with-team-is-now-pending: *647 + response-if-users-membership-with-team-is-now-pending: *646 '403': description: Forbidden if team synchronization is set up '422': @@ -101678,7 +104336,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - - *645 + - *644 - *69 responses: '204': @@ -101706,7 +104364,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#list-team-repositories-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -101716,9 +104374,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 '404': *6 @@ -101748,15 +104406,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#check-team-permissions-for-a-repository-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 responses: '200': description: Alternative response with extra repository information content: application/json: - schema: *648 + schema: *647 examples: alternative-response-with-extra-repository-information: value: @@ -101907,9 +104565,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#add-or-update-team-repository-permissions-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 requestBody: required: false content: @@ -101959,9 +104617,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#remove-a-repository-from-a-team-legacy parameters: - - *645 + - *644 + - *324 - *325 - - *326 responses: '204': description: Response @@ -101986,7 +104644,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/teams/teams#list-child-teams-legacy parameters: - - *645 + - *644 - *17 - *19 responses: @@ -101996,9 +104654,9 @@ paths: application/json: schema: type: array - items: *188 + items: *187 examples: - response-if-child-teams-exist: *649 + response-if-child-teams-exist: *648 headers: Link: *65 '404': *6 @@ -102031,7 +104689,7 @@ paths: application/json: schema: oneOf: - - &651 + - &650 title: Private User description: Private User type: object @@ -102281,7 +104939,7 @@ paths: - private_gists - total_private_repos - two_factor_authentication - - *650 + - *649 examples: response-with-public-and-private-profile-information: summary: Response with public and private profile information @@ -102441,7 +105099,7 @@ paths: description: Response content: application/json: - schema: *651 + schema: *650 examples: default: value: @@ -102644,9 +105302,9 @@ paths: type: integer codespaces: type: array - items: *235 + items: *234 examples: - default: *236 + default: *235 '304': *35 '500': *53 '401': *23 @@ -102785,17 +105443,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -102839,7 +105497,7 @@ paths: type: integer secrets: type: array - items: &652 + items: &651 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -102881,7 +105539,7 @@ paths: - visibility - selected_repositories_url examples: - default: *447 + default: *446 headers: Link: *65 x-github: @@ -102953,13 +105611,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#get-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 responses: '200': description: Response content: application/json: - schema: *652 + schema: *651 examples: default: value: @@ -102989,7 +105647,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#create-or-update-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 requestBody: required: true content: @@ -103034,7 +105692,7 @@ paths: description: Response after successfully creating a secret content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -103062,7 +105720,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#delete-a-secret-for-the-authenticated-user parameters: - - *161 + - *160 responses: '204': description: Response @@ -103087,7 +105745,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#list-selected-repositories-for-a-user-secret parameters: - - *161 + - *160 responses: '200': description: Response @@ -103103,9 +105761,9 @@ paths: type: integer repositories: type: array - items: *153 + items: *152 examples: - default: *189 + default: *188 '401': *23 '403': *27 '404': *6 @@ -103130,7 +105788,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#set-selected-repositories-for-a-user-secret parameters: - - *161 + - *160 requestBody: required: true content: @@ -103184,7 +105842,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#add-a-selected-repository-to-a-user-secret parameters: - - *161 + - *160 - name: repository_id in: path required: true @@ -103217,7 +105875,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/secrets#remove-a-selected-repository-from-a-user-secret parameters: - - *161 + - *160 - name: repository_id in: path required: true @@ -103249,15 +105907,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '304': *35 '500': *53 '401': *23 @@ -103283,7 +105941,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#update-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 requestBody: required: false content: @@ -103313,9 +105971,9 @@ paths: description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '401': *23 '403': *27 '404': *6 @@ -103337,7 +105995,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#delete-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '202': *37 '304': *35 @@ -103366,13 +106024,13 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#export-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '202': description: Response content: application/json: - schema: &653 + schema: &652 type: object title: Fetches information about an export of a codespace. description: An export of a codespace. Also, latest export details @@ -103425,7 +106083,7 @@ paths: examples: - https://github.com/octocat/hello-world/tree/:branch examples: - default: &654 + default: &653 value: state: succeeded completed_at: '2022-01-01T14:59:22Z' @@ -103457,7 +106115,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#get-details-about-a-codespace-export parameters: - - *237 + - *236 - name: export_id in: path required: true @@ -103470,9 +106128,9 @@ paths: description: Response content: application/json: - schema: *653 + schema: *652 examples: - default: *654 + default: *653 '404': *6 x-github: githubCloudOnly: false @@ -103493,7 +106151,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/machines#list-machine-types-for-a-codespace parameters: - - *237 + - *236 responses: '200': description: Response @@ -103509,9 +106167,9 @@ paths: type: integer machines: type: array - items: *446 + items: *445 examples: - default: *655 + default: *654 '304': *35 '500': *53 '401': *23 @@ -103540,7 +106198,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#create-a-repository-from-an-unpublished-codespace parameters: - - *237 + - *236 requestBody: required: true content: @@ -103596,11 +106254,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *328 + repository: *327 machine: anyOf: - type: 'null' - - *446 + - *445 devcontainer_path: description: Path to devcontainer.json from repo root used to create Codespace. @@ -104397,15 +107055,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#start-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '304': *35 '500': *53 '400': *14 @@ -104437,15 +107095,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/codespaces/codespaces#stop-a-codespace-for-the-authenticated-user parameters: - - *237 + - *236 responses: '200': description: Response content: application/json: - schema: *235 + schema: *234 examples: - default: *445 + default: *444 '500': *53 '401': *23 '403': *27 @@ -104475,9 +107133,9 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: &666 + default: &665 value: - id: 197 name: hello_docker @@ -104578,7 +107236,7 @@ paths: application/json: schema: type: array - items: &656 + items: &655 title: Email description: Email type: object @@ -104648,9 +107306,9 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: - default: &668 + default: &667 value: - email: octocat@github.com verified: true @@ -104727,7 +107385,7 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: default: value: @@ -104985,7 +107643,7 @@ paths: application/json: schema: type: array - items: &657 + items: &656 title: GPG Key description: A unique encryption key type: object @@ -105130,7 +107788,7 @@ paths: - subkeys - revoked examples: - default: &684 + default: &683 value: - id: 3 name: Octocat's GPG Key @@ -105215,9 +107873,9 @@ paths: description: Response content: application/json: - schema: *657 + schema: *656 examples: - default: &658 + default: &657 value: id: 3 name: Octocat's GPG Key @@ -105274,7 +107932,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/gpg-keys#get-a-gpg-key-for-the-authenticated-user parameters: - - &659 + - &658 name: gpg_key_id description: The unique identifier of the GPG key. in: path @@ -105286,9 +107944,9 @@ paths: description: Response content: application/json: - schema: *657 + schema: *656 examples: - default: *658 + default: *657 '404': *6 '304': *35 '403': *27 @@ -105311,7 +107969,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/gpg-keys#delete-a-gpg-key-for-the-authenticated-user parameters: - - *659 + - *658 responses: '204': description: Response @@ -105504,7 +108162,7 @@ paths: allOf: - *77 examples: - default: *145 + default: *144 headers: Link: *65 '404': *6 @@ -105530,7 +108188,7 @@ paths: url: https://docs.github.com/rest/apps/installations#add-a-repository-to-an-app-installation parameters: - *21 - - *142 + - *141 responses: '204': description: Response @@ -105556,7 +108214,7 @@ paths: url: https://docs.github.com/rest/apps/installations#remove-a-repository-from-an-app-installation parameters: - *21 - - *142 + - *141 responses: '204': description: Response @@ -105590,12 +108248,12 @@ paths: application/json: schema: anyOf: - - *222 + - *221 - type: object properties: {} additionalProperties: false examples: - default: *223 + default: *222 '204': description: Response when there are no restrictions x-github: @@ -105619,7 +108277,7 @@ paths: required: true content: application/json: - schema: *517 + schema: *516 examples: default: value: @@ -105630,7 +108288,7 @@ paths: description: Response content: application/json: - schema: *222 + schema: *221 examples: default: value: @@ -105711,7 +108369,7 @@ paths: - closed - all default: open - - *233 + - *232 - name: sort description: What to sort results by. in: query @@ -105736,7 +108394,7 @@ paths: type: array items: *81 examples: - default: *234 + default: *233 headers: Link: *65 '404': *6 @@ -105769,7 +108427,7 @@ paths: application/json: schema: type: array - items: &660 + items: &659 title: Key description: Key type: object @@ -105872,9 +108530,9 @@ paths: description: Response content: application/json: - schema: *660 + schema: *659 examples: - default: &661 + default: &660 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -105907,15 +108565,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/keys#get-a-public-ssh-key-for-the-authenticated-user parameters: - - *547 + - *546 responses: '200': description: Response content: application/json: - schema: *660 + schema: *659 examples: - default: *661 + default: *660 '404': *6 '304': *35 '403': *27 @@ -105938,7 +108596,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/keys#delete-a-public-ssh-key-for-the-authenticated-user parameters: - - *547 + - *546 responses: '204': description: Response @@ -105971,7 +108629,7 @@ paths: application/json: schema: type: array - items: &662 + items: &661 title: User Marketplace Purchase description: User Marketplace Purchase type: object @@ -106050,7 +108708,7 @@ paths: - account - plan examples: - default: &663 + default: &662 value: - billing_cycle: monthly next_billing_date: '2017-11-11T00:00:00Z' @@ -106112,9 +108770,9 @@ paths: application/json: schema: type: array - items: *662 + items: *661 examples: - default: *663 + default: *662 headers: Link: *65 '304': *35 @@ -106154,7 +108812,7 @@ paths: application/json: schema: type: array - items: *239 + items: *238 examples: default: value: @@ -106268,7 +108926,7 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: default: value: @@ -106355,7 +109013,7 @@ paths: description: Response content: application/json: - schema: *239 + schema: *238 examples: default: value: @@ -106427,7 +109085,7 @@ paths: application/json: schema: type: array - items: *241 + items: *240 examples: default: value: @@ -106689,7 +109347,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -106869,7 +109527,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#get-a-user-migration-status parameters: - - *242 + - *241 - name: exclude in: query required: false @@ -106882,7 +109540,7 @@ paths: description: Response content: application/json: - schema: *241 + schema: *240 examples: default: value: @@ -107076,7 +109734,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#download-a-user-migration-archive parameters: - - *242 + - *241 responses: '302': description: Response @@ -107102,7 +109760,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#delete-a-user-migration-archive parameters: - - *242 + - *241 responses: '204': description: Response @@ -107131,8 +109789,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#unlock-a-user-repository parameters: - - *242 - - *664 + - *241 + - *663 responses: '204': description: Response @@ -107156,7 +109814,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/migrations/users#list-repositories-for-a-user-migration parameters: - - *242 + - *241 - *17 - *19 responses: @@ -107166,9 +109824,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 '404': *6 @@ -107265,7 +109923,7 @@ paths: - docker - nuget - container - - *665 + - *664 - *19 - *17 responses: @@ -107275,10 +109933,10 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *666 - '400': *667 + default: *665 + '400': *666 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -107298,16 +109956,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 responses: '200': description: Response content: application/json: - schema: *247 + schema: *246 examples: - default: &685 + default: &684 value: id: 40201 name: octo-name @@ -107420,8 +110078,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 responses: '204': description: Response @@ -107451,8 +110109,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - name: token description: package token schema: @@ -107484,8 +110142,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user parameters: + - *248 - *249 - - *250 - *19 - *17 - name: state @@ -107505,7 +110163,7 @@ paths: application/json: schema: type: array - items: *251 + items: *250 examples: default: value: @@ -107554,15 +110212,15 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '200': description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -107598,9 +110256,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '204': description: Response @@ -107630,9 +110288,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-version-for-the-authenticated-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 responses: '204': description: Response @@ -107669,9 +110327,9 @@ paths: application/json: schema: type: array - items: *656 + items: *655 examples: - default: *668 + default: *667 headers: Link: *65 '304': *35 @@ -107784,7 +110442,7 @@ paths: type: array items: *77 examples: - default: &675 + default: &674 summary: Default response value: - id: 1296269 @@ -108102,9 +110760,9 @@ paths: description: Response content: application/json: - schema: *328 + schema: *327 examples: - default: *330 + default: *329 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -108148,9 +110806,9 @@ paths: application/json: schema: type: array - items: *519 + items: *518 examples: - default: *669 + default: *668 headers: Link: *65 '304': *35 @@ -108173,7 +110831,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#accept-a-repository-invitation parameters: - - *226 + - *225 responses: '204': description: Response @@ -108202,7 +110860,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/collaborators/invitations#decline-a-repository-invitation parameters: - - *226 + - *225 responses: '204': description: Response @@ -108235,7 +110893,7 @@ paths: application/json: schema: type: array - items: &670 + items: &669 title: Social account description: Social media account type: object @@ -108252,7 +110910,7 @@ paths: - provider - url examples: - default: &671 + default: &670 value: - provider: twitter url: https://twitter.com/github @@ -108315,9 +110973,9 @@ paths: application/json: schema: type: array - items: *670 + items: *669 examples: - default: *671 + default: *670 '422': *15 '304': *35 '404': *6 @@ -108405,7 +111063,7 @@ paths: application/json: schema: type: array - items: &672 + items: &671 title: SSH Signing Key description: A public SSH key used to sign Git commits type: object @@ -108425,7 +111083,7 @@ paths: - title - created_at examples: - default: &703 + default: &702 value: - id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -108490,9 +111148,9 @@ paths: description: Response content: application/json: - schema: *672 + schema: *671 examples: - default: &673 + default: &672 value: id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -108522,7 +111180,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/ssh-signing-keys#get-an-ssh-signing-key-for-the-authenticated-user parameters: - - &674 + - &673 name: ssh_signing_key_id description: The unique identifier of the SSH signing key. in: path @@ -108534,9 +111192,9 @@ paths: description: Response content: application/json: - schema: *672 + schema: *671 examples: - default: *673 + default: *672 '404': *6 '304': *35 '403': *27 @@ -108559,7 +111217,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/ssh-signing-keys#delete-an-ssh-signing-key-for-the-authenticated-user parameters: - - *674 + - *673 responses: '204': description: Response @@ -108588,7 +111246,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-the-authenticated-user parameters: - - &704 + - &703 name: sort description: The property to sort the results by. `created` means when the repository was starred. `updated` means when the repository was last pushed @@ -108613,11 +111271,11 @@ paths: type: array items: *77 examples: - default-response: *675 + default-response: *674 application/vnd.github.v3.star+json: schema: type: array - items: &705 + items: &704 title: Starred Repository description: Starred Repository type: object @@ -108773,8 +111431,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response if this repository is starred by you @@ -108802,8 +111460,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#star-a-repository-for-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -108827,8 +111485,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/activity/starring#unstar-a-repository-for-the-authenticated-user parameters: + - *324 - *325 - - *326 responses: '204': description: Response @@ -108861,9 +111519,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 '304': *35 @@ -108900,7 +111558,7 @@ paths: application/json: schema: type: array - items: *321 + items: *320 examples: default: value: @@ -108986,10 +111644,10 @@ paths: application/json: schema: oneOf: - - *651 - *650 + - *649 examples: - default-response: &679 + default-response: &678 summary: Default response value: login: octocat @@ -109024,7 +111682,7 @@ paths: following: 0 created_at: '2008-01-14T04:33:35Z' updated_at: '2008-01-14T04:33:35Z' - response-with-git-hub-plan-information: &680 + response-with-git-hub-plan-information: &679 summary: Response with GitHub plan information value: login: octocat @@ -109081,14 +111739,14 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/drafts#create-draft-item-for-user-owned-project parameters: - - &677 + - &676 name: user_id description: The unique identifier of the user. in: path required: true schema: type: string - - *265 + - *264 requestBody: required: true description: Details of the draft item to create in the project. @@ -109122,9 +111780,9 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: - draft_issue: *271 + draft_issue: *270 '304': *35 '403': *27 '401': *23 @@ -109147,7 +111805,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/users/users#list-users parameters: - - *676 + - *675 - *17 responses: '200': @@ -109182,8 +111840,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/views#create-a-view-for-a-user-owned-project parameters: - - *677 - - *265 + - *676 + - *264 requestBody: required: true content: @@ -109257,17 +111915,17 @@ paths: description: Response for creating a view in a user-owned project. content: application/json: - schema: *678 + schema: *677 examples: table_view: summary: Response for creating a table view - value: *275 + value: *274 board_view: summary: Response for creating a board view with filter - value: *275 + value: *274 roadmap_view: summary: Response for creating a roadmap view - value: *275 + value: *274 '304': *35 '403': *27 '401': *23 @@ -109309,11 +111967,11 @@ paths: application/json: schema: oneOf: - - *651 - *650 + - *649 examples: - default-response: *679 - response-with-git-hub-plan-information: *680 + default-response: *678 + response-with-git-hub-plan-information: *679 '404': *6 x-github: githubCloudOnly: false @@ -109363,8 +112021,8 @@ paths: required: - subject_digests examples: - default: *681 - withPredicateType: *682 + default: *680 + withPredicateType: *681 responses: '200': description: Response @@ -109418,7 +112076,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: *683 + default: *682 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -109638,12 +112296,12 @@ paths: initiator: type: string examples: - default: *386 + default: *385 '201': description: Response content: application/json: - schema: *162 + schema: *161 examples: default: value: @@ -109691,9 +112349,9 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *666 + default: *665 '403': *27 '401': *23 x-github: @@ -110077,9 +112735,9 @@ paths: application/json: schema: type: array - items: *657 + items: *656 examples: - default: *684 + default: *683 headers: Link: *65 x-github: @@ -110183,7 +112841,7 @@ paths: application/json: schema: *20 examples: - default: *516 + default: *515 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -110308,7 +112966,7 @@ paths: - docker - nuget - container - - *665 + - *664 - *69 - *19 - *17 @@ -110319,12 +112977,12 @@ paths: application/json: schema: type: array - items: *247 + items: *246 examples: - default: *666 + default: *665 '403': *27 '401': *23 - '400': *667 + '400': *666 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -110344,17 +113002,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '200': description: Response content: application/json: - schema: *247 + schema: *246 examples: - default: *685 + default: *684 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -110375,8 +113033,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '204': @@ -110409,8 +113067,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-a-package-for-a-user parameters: + - *248 - *249 - - *250 - *69 - name: token description: package token @@ -110443,8 +113101,8 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#list-package-versions-for-a-package-owned-by-a-user parameters: + - *248 - *249 - - *250 - *69 responses: '200': @@ -110453,7 +113111,7 @@ paths: application/json: schema: type: array - items: *251 + items: *250 examples: default: value: @@ -110511,16 +113169,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#get-a-package-version-for-a-user parameters: + - *248 - *249 - - *250 - - *252 + - *251 - *69 responses: '200': description: Response content: application/json: - schema: *251 + schema: *250 examples: default: value: @@ -110555,10 +113213,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#delete-package-version-for-a-user parameters: + - *248 - *249 - - *250 - *69 - - *252 + - *251 responses: '204': description: Response @@ -110590,10 +113248,10 @@ paths: description: API method documentation url: https://docs.github.com/rest/packages/packages#restore-package-version-for-a-user parameters: + - *248 - *249 - - *250 - *69 - - *252 + - *251 responses: '204': description: Response @@ -110634,9 +113292,9 @@ paths: application/json: schema: type: array - items: *263 + items: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -110658,16 +113316,16 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/projects#get-project-for-user parameters: - - *265 + - *264 - *69 responses: '200': description: Response content: application/json: - schema: *263 + schema: *262 examples: - default: *264 + default: *263 headers: Link: *65 '304': *35 @@ -110689,7 +113347,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#list-project-fields-for-user parameters: - - *265 + - *264 - *69 - *17 - *45 @@ -110701,9 +113359,9 @@ paths: application/json: schema: type: array - items: *268 + items: *267 examples: - default: *686 + default: *685 headers: Link: *65 '304': *35 @@ -110725,7 +113383,7 @@ paths: url: https://docs.github.com/rest/projects/fields#add-field-to-user-owned-project parameters: - *69 - - *265 + - *264 requestBody: required: true content: @@ -110763,7 +113421,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: *687 + items: *686 required: - name - data_type @@ -110779,7 +113437,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: *688 + iteration_configuration: *687 required: - name - data_type @@ -110801,20 +113459,20 @@ paths: value: name: Due date data_type: date - single_select_field: *689 - iteration_field: *690 + single_select_field: *688 + iteration_field: *689 responses: '201': description: Response content: application/json: - schema: *268 + schema: *267 examples: - text_field: *691 - number_field: *692 - date_field: *693 - single_select_field: *694 - iteration_field: *695 + text_field: *690 + number_field: *691 + date_field: *692 + single_select_field: *693 + iteration_field: *694 '304': *35 '403': *27 '401': *23 @@ -110835,17 +113493,17 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/fields#get-project-field-for-user parameters: - - *265 - - *696 + - *264 + - *695 - *69 responses: '200': description: Response content: application/json: - schema: *268 + schema: *267 examples: - default: *697 + default: *696 headers: Link: *65 '304': *35 @@ -110868,7 +113526,7 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-a-user-owned-project parameters: - - *265 + - *264 - *69 - *45 - *46 @@ -110901,9 +113559,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -110925,7 +113583,7 @@ paths: url: https://docs.github.com/rest/projects/items#add-item-to-user-owned-project parameters: - *69 - - *265 + - *264 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -110995,22 +113653,22 @@ paths: description: Response content: application/json: - schema: *270 + schema: *269 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *271 + value: *270 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *271 + value: *270 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *271 + value: *270 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *271 + value: *270 '304': *35 '403': *27 '401': *23 @@ -111030,9 +113688,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#get-an-item-for-a-user-owned-project parameters: - - *265 + - *264 - *69 - - *274 + - *273 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the title field will be returned. @@ -111052,9 +113710,9 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -111075,9 +113733,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#update-project-item-for-user parameters: - - *265 + - *264 - *69 - - *274 + - *273 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -111150,13 +113808,13 @@ paths: description: Response content: application/json: - schema: *272 + schema: *271 examples: - text_field: *273 - number_field: *273 - date_field: *273 - single_select_field: *273 - iteration_field: *273 + text_field: *272 + number_field: *272 + date_field: *272 + single_select_field: *272 + iteration_field: *272 '401': *23 '403': *27 '404': *6 @@ -111176,9 +113834,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#delete-project-item-for-user parameters: - - *265 + - *264 - *69 - - *274 + - *273 responses: '204': description: Response @@ -111200,9 +113858,9 @@ paths: description: API method documentation url: https://docs.github.com/rest/projects/items#list-items-for-a-user-project-view parameters: - - *265 + - *264 - *69 - - *698 + - *697 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the @@ -111228,9 +113886,9 @@ paths: application/json: schema: type: array - items: *272 + items: *271 examples: - default: *273 + default: *272 headers: Link: *65 '304': *35 @@ -111449,9 +114107,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -111477,7 +114135,7 @@ paths: - *115 - *117 - *116 - - *699 + - *698 - *118 responses: '200': @@ -111608,7 +114266,7 @@ paths: parameters: - *69 - *115 - - *700 + - *699 - *116 responses: '200': @@ -111707,9 +114365,9 @@ paths: - *115 - *117 - *116 - - *701 + - *700 - *118 - - *702 + - *701 responses: '200': description: Response when getting a billing usage summary @@ -111843,9 +114501,9 @@ paths: application/json: schema: type: array - items: *670 + items: *669 examples: - default: *671 + default: *670 headers: Link: *65 x-github: @@ -111875,9 +114533,9 @@ paths: application/json: schema: type: array - items: *672 + items: *671 examples: - default: *703 + default: *702 headers: Link: *65 x-github: @@ -111902,7 +114560,7 @@ paths: url: https://docs.github.com/rest/activity/starring#list-repositories-starred-by-a-user parameters: - *69 - - *704 + - *703 - *59 - *17 - *19 @@ -111914,11 +114572,11 @@ paths: schema: anyOf: - type: array - items: *705 + items: *704 - type: array items: *77 examples: - default-response: *675 + default-response: *674 headers: Link: *65 x-github: @@ -111947,9 +114605,9 @@ paths: application/json: schema: type: array - items: *153 + items: *152 examples: - default: *253 + default: *252 headers: Link: *65 x-github: @@ -112078,7 +114736,7 @@ webhooks: type: string enum: - disabled - enterprise: &706 + enterprise: &705 title: Enterprise description: |- An enterprise on GitHub. Webhook payloads contain the `enterprise` property when the webhook is configured @@ -112147,7 +114805,7 @@ webhooks: - created_at - updated_at - avatar_url - installation: &707 + installation: &706 title: Simple Installation description: |- The GitHub App installation. Webhook payloads contain the `installation` property when the event is configured @@ -112168,7 +114826,7 @@ webhooks: required: - id - node_id - organization: &708 + organization: &707 title: Organization Simple description: |- A GitHub organization. Webhook payloads contain the `organization` property when the webhook is configured for an @@ -112241,7 +114899,7 @@ webhooks: - public_members_url - avatar_url - description - repository: &709 + repository: &708 title: Repository description: |- The repository on GitHub where the event occurred. Webhook payloads contain the `repository` property @@ -113181,10 +115839,10 @@ webhooks: type: string enum: - enabled - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -113260,11 +115918,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: &710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: &709 title: branch protection rule description: The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) @@ -113487,11 +116145,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: *710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: *709 sender: *4 required: - action @@ -113679,11 +116337,11 @@ webhooks: - everyone required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - rule: *710 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + rule: *709 sender: *4 required: - action @@ -113767,7 +116425,7 @@ webhooks: type: string enum: - completed - check_run: &712 + check_run: &711 title: CheckRun description: A check performed on the code of a given code change type: object @@ -113833,7 +116491,7 @@ webhooks: pull_requests: type: array items: *84 - repository: *153 + repository: *152 status: type: string enum: @@ -113877,7 +116535,7 @@ webhooks: - examples: - neutral - deployment: *711 + deployment: *710 details_url: type: string examples: @@ -113975,10 +116633,10 @@ webhooks: - output - app - pull_requests - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -114369,11 +117027,11 @@ webhooks: type: string enum: - created - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -114767,11 +117425,11 @@ webhooks: type: string enum: - requested_action - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 requested_action: description: The action requested by the user. type: object @@ -115174,11 +117832,11 @@ webhooks: type: string enum: - rerequested - check_run: *712 - installation: *707 - enterprise: *706 - organization: *708 - repository: *709 + check_run: *711 + installation: *706 + enterprise: *705 + organization: *707 + repository: *708 sender: *4 required: - check_run @@ -116163,10 +118821,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -116870,10 +119528,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -117571,10 +120229,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -117743,7 +120401,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -117895,20 +120553,20 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: &713 + commit_oid: &712 description: The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - enterprise: *706 - installation: *707 - organization: *708 - ref: &714 + enterprise: *705 + installation: *706 + organization: *707 + ref: &713 description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -118075,7 +120733,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -118316,12 +120974,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -118419,7 +121077,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -118604,12 +121262,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -118778,7 +121436,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -118955,12 +121613,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -119061,7 +121719,7 @@ webhooks: type: - object - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -119250,9 +121908,9 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 ref: description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event @@ -119260,7 +121918,7 @@ webhooks: type: - string - 'null' - repository: *709 + repository: *708 sender: *4 required: - action @@ -119359,7 +122017,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -119506,12 +122164,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *713 - enterprise: *706 - installation: *707 - organization: *708 - ref: *714 - repository: *709 + commit_oid: *712 + enterprise: *705 + installation: *706 + organization: *707 + ref: *713 + repository: *708 sender: *4 required: - action @@ -119680,7 +122338,7 @@ webhooks: required: - login - id - dismissed_comment: *417 + dismissed_comment: *416 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -119832,10 +122490,10 @@ webhooks: - dismissed_reason - rule - tool - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -120095,10 +122753,10 @@ webhooks: - updated_at - author_association - body - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -120179,18 +122837,18 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 master_branch: description: The name of the repository's default branch (usually `main`). type: string - organization: *708 - pusher_type: &715 + organization: *707 + pusher_type: &714 description: The pusher type for the event. Can be either `user` or a deploy key. type: string - ref: &716 + ref: &715 description: The [`git ref`](https://docs.github.com/rest/git/refs#get-a-reference) resource. type: string @@ -120200,7 +122858,7 @@ webhooks: enum: - tag - branch - repository: *709 + repository: *708 sender: *4 required: - ref @@ -120282,10 +122940,10 @@ webhooks: type: string enum: - created - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -120370,9 +123028,9 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -120449,10 +123107,10 @@ webhooks: type: string enum: - promote_to_enterprise - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -120529,10 +123187,10 @@ webhooks: type: string enum: - updated - definition: *276 - enterprise: *706 - installation: *707 - organization: *708 + definition: *275 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -120609,19 +123267,19 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - repository: *709 - organization: *708 + enterprise: *705 + installation: *706 + repository: *708 + organization: *707 sender: *4 new_property_values: type: array description: The new custom property values for the repository. - items: *280 + items: *279 old_property_values: type: array description: The old custom property values for the repository. - items: *280 + items: *279 required: - action - repository @@ -120697,18 +123355,18 @@ webhooks: title: delete event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - pusher_type: *715 - ref: *716 + enterprise: *705 + installation: *706 + organization: *707 + pusher_type: *714 + ref: *715 ref_type: description: The type of Git ref object deleted in the repository. type: string enum: - tag - branch - repository: *709 + repository: *708 sender: *4 required: - ref @@ -120788,11 +123446,11 @@ webhooks: type: string enum: - assignees_changed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120872,11 +123530,11 @@ webhooks: type: string enum: - auto_dismissed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -120957,11 +123615,11 @@ webhooks: type: string enum: - auto_reopened - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -121042,11 +123700,11 @@ webhooks: type: string enum: - created - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -121125,11 +123783,11 @@ webhooks: type: string enum: - dismissed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -121208,11 +123866,11 @@ webhooks: type: string enum: - fixed - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -121292,11 +123950,11 @@ webhooks: type: string enum: - reintroduced - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -121375,11 +124033,11 @@ webhooks: type: string enum: - reopened - alert: *475 - installation: *707 - organization: *708 - enterprise: *706 - repository: *709 + alert: *474 + installation: *706 + organization: *707 + enterprise: *705 + repository: *708 sender: *4 required: - action @@ -121456,9 +124114,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - key: &717 + enterprise: *705 + installation: *706 + key: &716 description: The [`deploy key`](https://docs.github.com/rest/deploy-keys/deploy-keys#get-a-deploy-key) resource. type: object @@ -121496,8 +124154,8 @@ webhooks: - verified - created_at - read_only - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -121574,11 +124232,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - key: *717 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + key: *716 + organization: *707 + repository: *708 sender: *4 required: - action @@ -122145,12 +124803,12 @@ webhooks: - updated_at - statuses_url - repository_url - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: &721 + workflow: &720 title: Workflow type: - object @@ -122901,13 +125559,13 @@ webhooks: deployment: anyOf: - type: 'null' - - *481 + - *480 pull_requests: type: array - items: *565 - repository: *709 - organization: *708 - installation: *707 + items: *564 + repository: *708 + organization: *707 + installation: *706 sender: *4 responses: '200': @@ -122978,7 +125636,7 @@ webhooks: type: string enum: - approved - approver: &718 + approver: &717 type: object properties: avatar_url: @@ -123021,11 +125679,11 @@ webhooks: type: string comment: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - reviewers: &719 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + reviewers: &718 type: array items: type: object @@ -123106,7 +125764,7 @@ webhooks: sender: *4 since: type: string - workflow_job_run: &720 + workflow_job_run: &719 type: object properties: conclusion: @@ -123852,18 +126510,18 @@ webhooks: type: string enum: - rejected - approver: *718 + approver: *717 comment: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - reviewers: *719 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + reviewers: *718 sender: *4 since: type: string - workflow_job_run: *720 + workflow_job_run: *719 workflow_job_runs: type: array items: @@ -124580,13 +127238,13 @@ webhooks: type: string enum: - requested - enterprise: *706 + enterprise: *705 environment: type: string - installation: *707 - organization: *708 - repository: *709 - requestor: &726 + installation: *706 + organization: *707 + repository: *708 + requestor: &725 title: User type: - object @@ -126519,12 +129177,12 @@ webhooks: - updated_at - deployment_url - repository_url - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Deployment Workflow Run type: @@ -127215,7 +129873,7 @@ webhooks: type: string enum: - answered - answer: &724 + answer: &723 type: object properties: author_association: @@ -127375,11 +130033,11 @@ webhooks: - created_at - updated_at - body - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127506,11 +130164,11 @@ webhooks: - from required: - category - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127593,11 +130251,11 @@ webhooks: type: string enum: - closed - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127679,7 +130337,7 @@ webhooks: type: string enum: - created - comment: &723 + comment: &722 type: object properties: author_association: @@ -127839,11 +130497,11 @@ webhooks: - updated_at - body - reactions - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -127926,12 +130584,12 @@ webhooks: type: string enum: - deleted - comment: *723 - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + comment: *722 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128026,12 +130684,12 @@ webhooks: - from required: - body - comment: *723 - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + comment: *722 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128115,11 +130773,11 @@ webhooks: type: string enum: - created - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128201,11 +130859,11 @@ webhooks: type: string enum: - deleted - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128305,11 +130963,11 @@ webhooks: type: string required: - from - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128391,10 +131049,10 @@ webhooks: type: string enum: - labeled - discussion: *722 - enterprise: *706 - installation: *707 - label: &725 + discussion: *721 + enterprise: *705 + installation: *706 + label: &724 title: Label type: object properties: @@ -128427,8 +131085,8 @@ webhooks: - color - default - description - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128511,11 +131169,11 @@ webhooks: type: string enum: - locked - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128597,11 +131255,11 @@ webhooks: type: string enum: - pinned - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128683,11 +131341,11 @@ webhooks: type: string enum: - reopened - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128772,16 +131430,16 @@ webhooks: changes: type: object properties: - new_discussion: *722 - new_repository: *709 + new_discussion: *721 + new_repository: *708 required: - new_discussion - new_repository - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128864,10 +131522,10 @@ webhooks: type: string enum: - unanswered - discussion: *722 - old_answer: *724 - organization: *708 - repository: *709 + discussion: *721 + old_answer: *723 + organization: *707 + repository: *708 sender: *4 required: - action @@ -128949,12 +131607,12 @@ webhooks: type: string enum: - unlabeled - discussion: *722 - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -129037,11 +131695,11 @@ webhooks: type: string enum: - unlocked - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -129123,11 +131781,11 @@ webhooks: type: string enum: - unpinned - discussion: *722 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + discussion: *721 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -129200,7 +131858,7 @@ webhooks: description: A user forks a repository. type: object properties: - enterprise: *706 + enterprise: *705 forkee: description: The created [`repository`](https://docs.github.com/rest/repos/repos#get-a-repository) resource. @@ -129878,9 +132536,9 @@ webhooks: type: integer watchers_count: type: integer - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - forkee @@ -130026,9 +132684,9 @@ webhooks: title: gollum event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pages: description: The pages that were updated. type: array @@ -130066,7 +132724,7 @@ webhooks: - action - sha - html_url - repository: *709 + repository: *708 sender: *4 required: - pages @@ -130142,10 +132800,10 @@ webhooks: type: string enum: - created - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: &727 + organization: *707 + repositories: &726 description: An array of repository objects that the installation can access. type: array @@ -130171,8 +132829,8 @@ webhooks: - name - full_name - private - repository: *709 - requester: *726 + repository: *708 + requester: *725 sender: *4 required: - action @@ -130247,11 +132905,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -130328,11 +132986,11 @@ webhooks: type: string enum: - new_permissions_accepted - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -130409,10 +133067,10 @@ webhooks: type: string enum: - added - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories_added: &728 + organization: *707 + repositories_added: &727 description: An array of repository objects, which were added to the installation. type: array @@ -130458,15 +133116,15 @@ webhooks: private: description: Whether the repository is private or public. type: boolean - repository: *709 - repository_selection: &729 + repository: *708 + repository_selection: &728 description: Describe whether all repositories have been selected or there's a selection involved type: string enum: - all - selected - requester: *726 + requester: *725 sender: *4 required: - action @@ -130545,10 +133203,10 @@ webhooks: type: string enum: - removed - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories_added: *728 + organization: *707 + repositories_added: *727 repositories_removed: description: An array of repository objects, which were removed from the installation. @@ -130575,9 +133233,9 @@ webhooks: - name - full_name - private - repository: *709 - repository_selection: *729 - requester: *726 + repository: *708 + repository_selection: *728 + requester: *725 sender: *4 required: - action @@ -130656,11 +133314,11 @@ webhooks: type: string enum: - suspend - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -130842,10 +133500,10 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 target_type: type: string @@ -130924,11 +133582,11 @@ webhooks: type: string enum: - unsuspend - enterprise: *706 + enterprise: *705 installation: *20 - organization: *708 - repositories: *727 - repository: *709 + organization: *707 + repositories: *726 + repository: *708 requester: type: - 'null' @@ -131094,7 +133752,7 @@ webhooks: pin: anyOf: - type: 'null' - - *544 + - *543 user: title: User type: @@ -131180,8 +133838,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -131993,8 +134651,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -132011,7 +134669,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -132355,8 +135013,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -132436,7 +135094,7 @@ webhooks: type: string enum: - deleted - comment: &730 + comment: &729 title: issue comment description: The [comment](https://docs.github.com/rest/issues/comments#get-an-issue-comment) itself. @@ -132593,7 +135251,7 @@ webhooks: pin: anyOf: - type: 'null' - - *544 + - *543 required: - url - html_url @@ -132607,8 +135265,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -133416,8 +136074,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -133434,7 +136092,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -133780,8 +136438,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -133861,7 +136519,7 @@ webhooks: type: string enum: - edited - changes: &754 + changes: &753 description: The changes to the comment. type: object properties: @@ -133873,9 +136531,9 @@ webhooks: type: string required: - from - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -134686,8 +137344,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -134704,7 +137362,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -135048,8 +137706,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -135130,9 +137788,9 @@ webhooks: type: string enum: - pinned - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -135945,8 +138603,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -135963,7 +138621,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -136309,8 +138967,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -136390,9 +139048,9 @@ webhooks: type: string enum: - unpinned - comment: *730 - enterprise: *706 - installation: *707 + comment: *729 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) the comment belongs to. @@ -137205,8 +139863,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 state: description: State of the issue; either 'open' or 'closed' type: string @@ -137223,7 +139881,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -137569,8 +140227,8 @@ webhooks: - state - locked - assignee - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137659,9 +140317,9 @@ webhooks: type: number blocking_issue: *81 blocking_issue_repo: *77 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137750,9 +140408,9 @@ webhooks: type: number blocking_issue: *81 blocking_issue_repo: *77 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137840,9 +140498,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -137931,9 +140589,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -138013,10 +140671,10 @@ webhooks: type: string enum: - assigned - assignee: *726 - enterprise: *706 - installation: *707 - issue: &733 + assignee: *725 + enterprise: *705 + installation: *706 + issue: &732 title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -138827,11 +141485,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -138848,7 +141506,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -138951,8 +141609,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -139032,8 +141690,8 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -139849,11 +142507,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -139870,7 +142528,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -140116,8 +142774,8 @@ webhooks: required: - state - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -140196,8 +142854,8 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -141004,11 +143662,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -141025,7 +143683,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -141127,8 +143785,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -141207,8 +143865,8 @@ webhooks: type: string enum: - demilestoned - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -142038,11 +144696,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -142059,7 +144717,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -142140,7 +144798,7 @@ webhooks: format: uri user_view_type: type: string - milestone: &731 + milestone: &730 title: Milestone description: A collection of related issues and pull requests. type: object @@ -142283,8 +144941,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -142383,8 +145041,8 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -143195,11 +145853,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -143213,7 +145871,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -143319,9 +145977,9 @@ webhooks: - active_lock_reason - body - reactions - label: *725 - organization: *708 - repository: *709 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -143401,8 +146059,8 @@ webhooks: type: string enum: - labeled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -144212,11 +146870,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -144230,7 +146888,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -144336,9 +146994,9 @@ webhooks: - active_lock_reason - body - reactions - label: *725 - organization: *708 - repository: *709 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -144418,8 +147076,8 @@ webhooks: type: string enum: - locked - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -145254,11 +147912,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -145272,7 +147930,7 @@ webhooks: timeline_url: type: string format: uri - type: *230 + type: *229 title: description: Title of the issue type: string @@ -145355,8 +148013,8 @@ webhooks: format: uri user_view_type: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -145435,8 +148093,8 @@ webhooks: type: string enum: - milestoned - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -146265,11 +148923,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -146286,7 +148944,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -146366,9 +149024,9 @@ webhooks: format: uri user_view_type: type: string - milestone: *731 - organization: *708 - repository: *709 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -147255,11 +149913,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -147359,7 +150017,7 @@ webhooks: required: - login - id - type: *230 + type: *229 required: - id - number @@ -147851,8 +150509,8 @@ webhooks: required: - old_issue - old_repository - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -148659,11 +151317,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -148680,7 +151338,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -148786,8 +151444,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -148867,9 +151525,9 @@ webhooks: type: string enum: - pinned - enterprise: *706 - installation: *707 - issue: &732 + enterprise: *705 + installation: *706 + issue: &731 title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) itself. @@ -149674,11 +152332,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -149695,7 +152353,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -149797,8 +152455,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -149877,8 +152535,8 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -150711,11 +153369,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -150812,9 +153470,9 @@ webhooks: format: uri user_view_type: type: string - type: *230 - organization: *708 - repository: *709 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -151702,11 +154360,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -151723,7 +154381,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -152316,11 +154974,11 @@ webhooks: required: - new_issue - new_repository - enterprise: *706 - installation: *707 - issue: *732 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *731 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152400,12 +155058,12 @@ webhooks: type: string enum: - typed - enterprise: *706 - installation: *707 - issue: *733 - type: *230 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152486,7 +155144,7 @@ webhooks: type: string enum: - unassigned - assignee: &757 + assignee: &756 title: User type: - object @@ -152558,11 +155216,11 @@ webhooks: required: - login - id - enterprise: *706 - installation: *707 - issue: *733 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152641,12 +155299,12 @@ webhooks: type: string enum: - unlabeled - enterprise: *706 - installation: *707 - issue: *733 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -152726,8 +155384,8 @@ webhooks: type: string enum: - unlocked - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 issue: title: Issue description: The [issue](https://docs.github.com/rest/issues/issues#get-an-issue) @@ -153560,11 +156218,11 @@ webhooks: anyOf: - type: 'null' - *82 - sub_issues_summary: *643 - issue_dependencies_summary: *644 + sub_issues_summary: *642 + issue_dependencies_summary: *643 issue_field_values: type: array - items: *529 + items: *528 state: description: State of the issue; either 'open' or 'closed' type: string @@ -153581,7 +156239,7 @@ webhooks: title: description: Title of the issue type: string - type: *230 + type: *229 updated_at: type: string format: date-time @@ -153661,8 +156319,8 @@ webhooks: format: uri user_view_type: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153742,11 +156400,11 @@ webhooks: type: string enum: - unpinned - enterprise: *706 - installation: *707 - issue: *732 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *731 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153825,12 +156483,12 @@ webhooks: type: string enum: - untyped - enterprise: *706 - installation: *707 - issue: *733 - type: *230 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + issue: *732 + type: *229 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153910,11 +156568,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -153992,11 +156650,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154106,11 +156764,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - label: *725 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + label: *724 + organization: *707 + repository: *708 sender: *4 required: - action @@ -154192,9 +156850,9 @@ webhooks: - cancelled effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: &734 + enterprise: *705 + installation: *706 + marketplace_purchase: &733 title: Marketplace Purchase type: object required: @@ -154282,8 +156940,8 @@ webhooks: type: integer unit_count: type: integer - organization: *708 - previous_marketplace_purchase: &735 + organization: *707 + previous_marketplace_purchase: &734 title: Marketplace Purchase type: object properties: @@ -154367,7 +157025,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -154447,10 +157105,10 @@ webhooks: - changed effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -154538,7 +157196,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -154620,10 +157278,10 @@ webhooks: - pending_change effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -154709,7 +157367,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *709 + repository: *708 sender: *4 required: - action @@ -154790,8 +157448,8 @@ webhooks: - pending_change_cancelled effective_date: type: string - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 marketplace_purchase: title: Marketplace Purchase type: object @@ -154877,9 +157535,9 @@ webhooks: type: integer unit_count: type: integer - organization: *708 - previous_marketplace_purchase: *735 - repository: *709 + organization: *707 + previous_marketplace_purchase: *734 + repository: *708 sender: *4 required: - action @@ -154959,12 +157617,12 @@ webhooks: - purchased effective_date: type: string - enterprise: *706 - installation: *707 - marketplace_purchase: *734 - organization: *708 - previous_marketplace_purchase: *735 - repository: *709 + enterprise: *705 + installation: *706 + marketplace_purchase: *733 + organization: *707 + previous_marketplace_purchase: *734 + repository: *708 sender: *4 required: - action @@ -155066,11 +157724,11 @@ webhooks: type: string required: - to - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155172,11 +157830,11 @@ webhooks: type: - string - 'null' - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155255,11 +157913,11 @@ webhooks: type: string enum: - removed - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155337,11 +157995,11 @@ webhooks: type: string enum: - added - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 scope: description: The scope of the membership. Currently, can only be `team`. @@ -155419,7 +158077,7 @@ webhooks: required: - login - id - team: &736 + team: &735 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -155649,11 +158307,11 @@ webhooks: type: string enum: - removed - enterprise: *706 - installation: *707 - member: *726 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + member: *725 + organization: *707 + repository: *708 scope: description: The scope of the membership. Currently, can only be `team`. @@ -155732,7 +158390,7 @@ webhooks: required: - login - id - team: *736 + team: *735 required: - action - scope @@ -155814,8 +158472,8 @@ webhooks: type: string enum: - checks_requested - installation: *707 - merge_group: &737 + installation: *706 + merge_group: &736 type: object title: Merge Group description: A group of pull requests that the merge queue has grouped @@ -155834,15 +158492,15 @@ webhooks: description: The full ref of the branch the merge group will be merged into. type: string - head_commit: *406 + head_commit: *405 required: - head_sha - head_ref - base_sha - base_ref - head_commit - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -155928,10 +158586,10 @@ webhooks: - merged - invalidated - dequeued - installation: *707 - merge_group: *737 - organization: *708 - repository: *709 + installation: *706 + merge_group: *736 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156004,7 +158662,7 @@ webhooks: type: string enum: - deleted - enterprise: *706 + enterprise: *705 hook: description: 'The deleted webhook. This will contain different keys based on the type of webhook it is: repository, organization, @@ -156113,12 +158771,12 @@ webhooks: hook_id: description: The id of the modified webhook. type: integer - installation: *707 - organization: *708 + installation: *706 + organization: *707 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -156198,11 +158856,11 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156281,9 +158939,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - milestone: &738 + enterprise: *705 + installation: *706 + milestone: &737 title: Milestone description: A collection of related issues and pull requests. type: object @@ -156425,8 +159083,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156505,11 +159163,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156619,11 +159277,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - milestone: *731 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *730 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156703,11 +159361,11 @@ webhooks: type: string enum: - opened - enterprise: *706 - installation: *707 - milestone: *738 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + milestone: *737 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156786,11 +159444,11 @@ webhooks: type: string enum: - blocked - blocked_user: *726 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + blocked_user: *725 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156869,11 +159527,11 @@ webhooks: type: string enum: - unblocked - blocked_user: *726 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + blocked_user: *725 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -156952,9 +159610,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - membership: &739 + enterprise: *705 + installation: *706 + membership: &738 title: Membership description: The membership between the user and the organization. Not present when the action is `member_invited`. @@ -157064,8 +159722,8 @@ webhooks: - role - organization_url - user - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 required: - action @@ -157143,11 +159801,11 @@ webhooks: type: string enum: - member_added - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -157226,8 +159884,8 @@ webhooks: type: string enum: - member_invited - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 invitation: description: The invitation for the user or email if the action is `member_invited`. @@ -157349,10 +160007,10 @@ webhooks: - inviter - team_count - invitation_teams_url - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 - user: *726 + user: *725 required: - action - invitation @@ -157430,11 +160088,11 @@ webhooks: type: string enum: - member_removed - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -157521,11 +160179,11 @@ webhooks: properties: from: type: string - enterprise: *706 - installation: *707 - membership: *739 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + membership: *738 + organization: *707 + repository: *708 sender: *4 required: - action @@ -157602,9 +160260,9 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 package: description: Information about the package. type: object @@ -158127,7 +160785,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: &740 + items: &739 title: Ruby Gems metadata type: object properties: @@ -158224,7 +160882,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -158300,9 +160958,9 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 package: description: Information about the package. type: object @@ -158664,7 +161322,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *740 + items: *739 source_url: type: string format: uri @@ -158735,7 +161393,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -158915,12 +161573,12 @@ webhooks: - duration - created_at - updated_at - enterprise: *706 + enterprise: *705 id: type: integer - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - id @@ -158997,7 +161655,7 @@ webhooks: type: string enum: - approved - personal_access_token_request: &741 + personal_access_token_request: &740 title: Personal Access Token Request description: Details of a Personal Access Token Request. type: object @@ -159147,10 +161805,10 @@ webhooks: - token_expired - token_expires_at - token_last_used_at - enterprise: *706 - organization: *708 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -159227,11 +161885,11 @@ webhooks: type: string enum: - cancelled - personal_access_token_request: *741 - enterprise: *706 - organization: *708 + personal_access_token_request: *740 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -159307,11 +161965,11 @@ webhooks: type: string enum: - created - personal_access_token_request: *741 - enterprise: *706 - organization: *708 + personal_access_token_request: *740 + enterprise: *705 + organization: *707 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -159386,11 +162044,11 @@ webhooks: type: string enum: - denied - personal_access_token_request: *741 - organization: *708 - enterprise: *706 + personal_access_token_request: *740 + organization: *707 + enterprise: *705 sender: *4 - installation: *707 + installation: *706 required: - action - personal_access_token_request @@ -159495,7 +162153,7 @@ webhooks: id: description: Unique identifier of the webhook. type: integer - last_response: *742 + last_response: *741 name: description: The type of webhook. The only valid value is 'web'. type: string @@ -159527,8 +162185,8 @@ webhooks: hook_id: description: The ID of the webhook that triggered the ping. type: integer - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 zen: description: Random string of GitHub zen. @@ -159773,10 +162431,10 @@ webhooks: - from required: - note - enterprise: *706 - installation: *707 - organization: *708 - project_card: &743 + enterprise: *705 + installation: *706 + organization: *707 + project_card: &742 title: Project Card type: object properties: @@ -159899,7 +162557,7 @@ webhooks: - creator - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -159980,11 +162638,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project_card: *743 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_card: *742 + repository: *708 sender: *4 required: - action @@ -160064,9 +162722,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 project_card: title: Project Card type: object @@ -160196,7 +162854,7 @@ webhooks: repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -160290,11 +162948,11 @@ webhooks: - from required: - note - enterprise: *706 - installation: *707 - organization: *708 - project_card: *743 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_card: *742 + repository: *708 sender: *4 required: - action @@ -160388,9 +163046,9 @@ webhooks: - from required: - column_id - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 project_card: allOf: - title: Project Card @@ -160587,7 +163245,7 @@ webhooks: type: string required: - after_id - repository: *709 + repository: *708 sender: *4 required: - action @@ -160667,10 +163325,10 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - organization: *708 - project: &745 + enterprise: *705 + installation: *706 + organization: *707 + project: &744 title: Project type: object properties: @@ -160797,7 +163455,7 @@ webhooks: - creator - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -160877,10 +163535,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project_column: &744 + enterprise: *705 + installation: *706 + organization: *707 + project_column: &743 title: Project Column type: object properties: @@ -160920,7 +163578,7 @@ webhooks: - name - created_at - updated_at - repository: *709 + repository: *708 sender: *4 required: - action @@ -160999,14 +163657,14 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -161095,11 +163753,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 + repository: *708 sender: *4 required: - action @@ -161179,11 +163837,11 @@ webhooks: type: string enum: - moved - enterprise: *706 - installation: *707 - organization: *708 - project_column: *744 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project_column: *743 + repository: *708 sender: *4 required: - action @@ -161263,11 +163921,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -161347,14 +164005,14 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - project: *745 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 repository: anyOf: - type: 'null' - - *709 + - *708 sender: *4 required: - action @@ -161455,11 +164113,11 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -161538,11 +164196,11 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 - organization: *708 - project: *745 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + project: *744 + repository: *708 sender: *4 required: - action @@ -161623,9 +164281,9 @@ webhooks: type: string enum: - closed - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161706,9 +164364,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161789,9 +164447,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161912,9 +164570,9 @@ webhooks: type: string to: type: string - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -161997,7 +164655,7 @@ webhooks: type: string enum: - archived - changes: &749 + changes: &748 type: object properties: archived_at: @@ -162013,9 +164671,9 @@ webhooks: - string - 'null' format: date-time - installation: *707 - organization: *708 - projects_v2_item: &746 + installation: *706 + organization: *707 + projects_v2_item: &745 title: Projects v2 Item description: An item belonging to a project type: object @@ -162033,7 +164691,7 @@ webhooks: type: string description: The node ID of the content represented by this item. - content_type: *269 + content_type: *268 creator: *4 created_at: type: string @@ -162155,9 +164813,9 @@ webhooks: - 'null' to: type: string - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -162239,9 +164897,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -162322,9 +164980,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -162429,7 +165087,7 @@ webhooks: oneOf: - type: string - type: integer - - &747 + - &746 title: Projects v2 Single Select Option description: An option for a single select field type: object @@ -162453,7 +165111,7 @@ webhooks: required: - id - name - - &748 + - &747 title: Projects v2 Iteration Setting description: An iteration setting for an iteration field type: object @@ -162493,8 +165151,8 @@ webhooks: oneOf: - type: string - type: integer + - *746 - *747 - - *748 type: - 'null' - string @@ -162517,9 +165175,9 @@ webhooks: - 'null' required: - body - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -162616,9 +165274,9 @@ webhooks: type: - string - 'null' - installation: *707 - organization: *708 - projects_v2_item: *746 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -162701,10 +165359,10 @@ webhooks: type: string enum: - restored - changes: *749 - installation: *707 - organization: *708 - projects_v2_item: *746 + changes: *748 + installation: *706 + organization: *707 + projects_v2_item: *745 sender: *4 required: - action @@ -162786,9 +165444,9 @@ webhooks: type: string enum: - reopened - installation: *707 - organization: *708 - projects_v2: *263 + installation: *706 + organization: *707 + projects_v2: *262 sender: *4 required: - action @@ -162869,9 +165527,9 @@ webhooks: type: string enum: - created - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -162952,9 +165610,9 @@ webhooks: type: string enum: - deleted - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -163100,9 +165758,9 @@ webhooks: - string - 'null' format: date - installation: *707 - organization: *708 - projects_v2_status_update: *750 + installation: *706 + organization: *707 + projects_v2_status_update: *749 sender: *4 required: - action @@ -163173,10 +165831,10 @@ webhooks: title: public event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - repository @@ -163253,13 +165911,13 @@ webhooks: type: string enum: - assigned - assignee: *726 - enterprise: *706 - installation: *707 - number: &751 + assignee: *725 + enterprise: *705 + installation: *706 + number: &750 description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -165630,7 +168288,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -165727,11 +168385,11 @@ webhooks: type: string enum: - auto_merge_disabled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -168095,7 +170753,7 @@ webhooks: - draft reason: type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -168192,11 +170850,11 @@ webhooks: type: string enum: - auto_merge_enabled - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -170560,7 +173218,7 @@ webhooks: - draft reason: type: string - repository: *709 + repository: *708 sender: *4 required: - action @@ -170657,13 +173315,13 @@ webhooks: type: string enum: - closed - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: &752 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: &751 allOf: - - *565 + - *564 - type: object properties: allow_auto_merge: @@ -170725,7 +173383,7 @@ webhooks: Please use `squash_merge_commit_title` instead.** type: boolean default: false - repository: *709 + repository: *708 sender: *4 required: - action @@ -170806,12 +173464,12 @@ webhooks: type: string enum: - converted_to_draft - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -170891,11 +173549,11 @@ webhooks: type: string enum: - demilestoned - enterprise: *706 - milestone: *266 - number: *751 - organization: *708 - pull_request: &753 + enterprise: *705 + milestone: *265 + number: *750 + organization: *707 + pull_request: &752 title: Pull Request type: object properties: @@ -173286,7 +175944,7 @@ webhooks: - active_lock_reason - draft version: '2026-03-10' - repository: *709 + repository: *708 sender: *4 required: - action @@ -173365,11 +176023,11 @@ webhooks: type: string enum: - dequeued - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -175737,7 +178395,7 @@ webhooks: - BRANCH_PROTECTIONS - GIT_TREE_INVALID - INVALID_MERGE_COMMIT - repository: *709 + repository: *708 sender: *4 required: - action @@ -175869,12 +178527,12 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -175954,11 +178612,11 @@ webhooks: type: string enum: - enqueued - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -178311,7 +180969,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -178399,11 +181057,11 @@ webhooks: type: string enum: - labeled - enterprise: *706 - installation: *707 - label: *725 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + label: *724 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -180773,7 +183431,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -180869,10 +183527,10 @@ webhooks: type: string enum: - locked - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -183240,7 +185898,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -183335,12 +185993,12 @@ webhooks: type: string enum: - milestoned - enterprise: *706 - milestone: *266 - number: *751 - organization: *708 - pull_request: *753 - repository: *709 + enterprise: *705 + milestone: *265 + number: *750 + organization: *707 + pull_request: *752 + repository: *708 sender: *4 required: - action @@ -183419,12 +186077,12 @@ webhooks: type: string enum: - opened - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -183505,12 +186163,12 @@ webhooks: type: string enum: - ready_for_review - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -183590,12 +186248,12 @@ webhooks: type: string enum: - reopened - enterprise: *706 - installation: *707 - number: *751 - organization: *708 - pull_request: *752 - repository: *709 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 + pull_request: *751 + repository: *708 sender: *4 required: - action @@ -183970,9 +186628,9 @@ webhooks: - start_side - side - reactions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -186224,7 +188882,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -186319,7 +188977,7 @@ webhooks: type: string enum: - deleted - comment: &755 + comment: &754 title: Pull Request Review Comment description: The [comment](https://docs.github.com/rest/pulls/comments#get-a-review-comment-for-a-pull-request) itself. @@ -186612,9 +189270,9 @@ webhooks: - start_side - side - reactions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -188854,7 +191512,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -188949,11 +191607,11 @@ webhooks: type: string enum: - edited - changes: *754 - comment: *755 - enterprise: *706 - installation: *707 - organization: *708 + changes: *753 + comment: *754 + enterprise: *705 + installation: *706 + organization: *707 pull_request: type: object properties: @@ -191196,7 +193854,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *709 + repository: *708 sender: *4 required: - action @@ -191292,9 +193950,9 @@ webhooks: type: string enum: - dismissed - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -193549,7 +196207,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 review: description: The review that was affected. type: object @@ -193815,9 +196473,9 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -195931,8 +198589,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 - review: &756 + repository: *708 + review: &755 description: The review that was affected. type: object properties: @@ -196178,12 +198836,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -198552,7 +201210,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_reviewer: title: User type: @@ -198638,12 +201296,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -201019,7 +203677,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_team: title: Team description: Groups of organization members that gives permissions @@ -201237,12 +203895,12 @@ webhooks: type: string enum: - review_requested - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -203613,7 +206271,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_reviewer: title: User type: @@ -203700,12 +206358,12 @@ webhooks: type: string enum: - review_requested - enterprise: *706 - installation: *707 + enterprise: *705 + installation: *706 number: description: The pull request number. type: integer - organization: *708 + organization: *707 pull_request: title: Pull Request type: object @@ -206067,7 +208725,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 requested_team: title: Team description: Groups of organization members that gives permissions @@ -206274,9 +208932,9 @@ webhooks: type: string enum: - submitted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -208534,8 +211192,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 - review: *756 + repository: *708 + review: *755 sender: *4 required: - action @@ -208630,9 +211288,9 @@ webhooks: type: string enum: - resolved - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -210785,7 +213443,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 sender: *4 thread: type: object @@ -211190,9 +213848,9 @@ webhooks: type: string enum: - unresolved - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 pull_request: title: Simple Pull Request type: object @@ -213328,7 +215986,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *709 + repository: *708 sender: *4 thread: type: object @@ -213735,10 +216393,10 @@ webhooks: type: string before: type: string - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -216095,7 +218753,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -216192,11 +218850,11 @@ webhooks: type: string enum: - unassigned - assignee: *757 - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + assignee: *756 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -218568,7 +221226,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -218662,11 +221320,11 @@ webhooks: type: string enum: - unlabeled - enterprise: *706 - installation: *707 - label: *725 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + label: *724 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -221027,7 +223685,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -221123,10 +223781,10 @@ webhooks: type: string enum: - unlocked - enterprise: *706 - installation: *707 - number: *751 - organization: *708 + enterprise: *705 + installation: *706 + number: *750 + organization: *707 pull_request: title: Pull Request type: object @@ -223477,7 +226135,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *709 + repository: *708 sender: *4 required: - action @@ -223695,7 +226353,7 @@ webhooks: deleted: description: Whether this push deleted the `ref`. type: boolean - enterprise: *706 + enterprise: *705 forced: description: Whether this push was a force push of the `ref`. type: boolean @@ -223790,8 +226448,8 @@ webhooks: - url - author - committer - installation: *707 - organization: *708 + installation: *706 + organization: *707 pusher: title: Committer description: Metaproperties for Git author/committer information. @@ -224390,9 +227048,9 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 registry_package: type: object properties: @@ -224869,7 +227527,7 @@ webhooks: type: string rubygems_metadata: type: array - items: *740 + items: *739 summary: type: string tag_name: @@ -224925,7 +227583,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -225003,9 +227661,9 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 registry_package: type: object properties: @@ -225317,7 +227975,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *740 + items: *739 summary: type: string tag_name: @@ -225367,7 +228025,7 @@ webhooks: - owner - package_version - registry - repository: *709 + repository: *708 sender: *4 required: - action @@ -225444,10 +228102,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - release: &758 + enterprise: *705 + installation: *706 + organization: *707 + release: &757 title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) object. @@ -225778,7 +228436,7 @@ webhooks: - updated_at - zipball_url - body - repository: *709 + repository: *708 sender: *4 required: - action @@ -225855,11 +228513,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -225976,11 +228634,11 @@ webhooks: type: boolean required: - to - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -226058,9 +228716,9 @@ webhooks: type: string enum: - prereleased - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 release: title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) @@ -226396,7 +229054,7 @@ webhooks: - string - 'null' format: uri - repository: *709 + repository: *708 sender: *4 required: - action @@ -226472,10 +229130,10 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - release: &759 + enterprise: *705 + installation: *706 + organization: *707 + release: &758 title: Release description: The [release](https://docs.github.com/rest/releases/releases/#get-a-release) object. @@ -226808,7 +229466,7 @@ webhooks: - string - 'null' format: uri - repository: *709 + repository: *708 sender: *4 required: - action @@ -226884,11 +229542,11 @@ webhooks: type: string enum: - released - enterprise: *706 - installation: *707 - organization: *708 - release: *758 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *757 + repository: *708 sender: *4 required: - action @@ -226964,11 +229622,11 @@ webhooks: type: string enum: - unpublished - enterprise: *706 - installation: *707 - organization: *708 - release: *759 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + release: *758 + repository: *708 sender: *4 required: - action @@ -227044,11 +229702,11 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_advisory: *629 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_advisory: *628 sender: *4 required: - action @@ -227124,11 +229782,11 @@ webhooks: type: string enum: - reported - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_advisory: *629 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_advisory: *628 sender: *4 required: - action @@ -227204,10 +229862,10 @@ webhooks: type: string enum: - archived - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227284,10 +229942,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227365,10 +230023,10 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227453,10 +230111,10 @@ webhooks: additionalProperties: true description: The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body. - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227571,10 +230229,10 @@ webhooks: - 'null' items: type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227646,10 +230304,10 @@ webhooks: title: repository_import event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 status: type: string @@ -227730,10 +230388,10 @@ webhooks: type: string enum: - privatized - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227810,10 +230468,10 @@ webhooks: type: string enum: - publicized - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227907,10 +230565,10 @@ webhooks: - name required: - repository - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -227990,11 +230648,11 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 sender: *4 required: - action @@ -228072,11 +230730,11 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 sender: *4 required: - action @@ -228154,11 +230812,11 @@ webhooks: type: string enum: - edited - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - repository_ruleset: *308 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + repository_ruleset: *307 changes: type: object properties: @@ -228177,16 +230835,16 @@ webhooks: properties: added: type: array - items: *282 + items: *281 deleted: type: array - items: *282 + items: *281 updated: type: array items: type: object properties: - condition: *282 + condition: *281 changes: type: object properties: @@ -228219,16 +230877,16 @@ webhooks: properties: added: type: array - items: *585 + items: *584 deleted: type: array - items: *585 + items: *584 updated: type: array items: type: object properties: - rule: *585 + rule: *584 changes: type: object properties: @@ -228465,10 +231123,10 @@ webhooks: - from required: - owner - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228546,10 +231204,10 @@ webhooks: type: string enum: - unarchived - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228627,7 +231285,7 @@ webhooks: type: string enum: - create - alert: &760 + alert: &759 title: Repository Vulnerability Alert Alert description: The security alert of the vulnerable dependency. type: object @@ -228752,10 +231410,10 @@ webhooks: enum: - auto_dismissed - open - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -228965,10 +231623,10 @@ webhooks: type: string enum: - dismissed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229046,11 +231704,11 @@ webhooks: type: string enum: - reopen - alert: *760 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *759 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229252,10 +231910,10 @@ webhooks: enum: - fixed - open - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229333,17 +231991,17 @@ webhooks: type: string enum: - assigned - alert: &761 + alert: &760 type: object properties: - number: *171 - created_at: *172 + number: *170 + created_at: *171 updated_at: anyOf: - type: 'null' - - *173 - url: *174 - html_url: *175 + - *172 + url: *173 + html_url: *174 locations_url: type: string format: uri @@ -229448,10 +232106,10 @@ webhooks: - type: 'null' - *4 assignee: *4 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229529,11 +232187,11 @@ webhooks: type: string enum: - created - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229614,11 +232272,11 @@ webhooks: type: string enum: - created - alert: *761 - installation: *707 - location: *762 - organization: *708 - repository: *709 + alert: *760 + installation: *706 + location: *761 + organization: *707 + repository: *708 sender: *4 required: - location @@ -229856,11 +232514,11 @@ webhooks: type: string enum: - publicly_leaked - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -229938,11 +232596,11 @@ webhooks: type: string enum: - reopened - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230020,11 +232678,11 @@ webhooks: type: string enum: - resolved - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230102,12 +232760,12 @@ webhooks: type: string enum: - unassigned - alert: *761 + alert: *760 assignee: *4 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230185,11 +232843,11 @@ webhooks: type: string enum: - validated - alert: *761 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + alert: *760 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -230319,10 +232977,10 @@ webhooks: - organization - enterprise - - repository: *709 - enterprise: *706 - installation: *707 - organization: *708 + repository: *708 + enterprise: *705 + installation: *706 + organization: *707 sender: *4 required: - action @@ -230400,11 +233058,11 @@ webhooks: type: string enum: - published - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - security_advisory: &763 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + security_advisory: &762 description: The details of the security advisory, including summary, description, and severity. type: object @@ -230608,11 +233266,11 @@ webhooks: type: string enum: - updated - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 - security_advisory: *763 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 + security_advisory: *762 sender: *4 required: - action @@ -230685,10 +233343,10 @@ webhooks: type: string enum: - withdrawn - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 security_advisory: description: The details of the security advisory, including summary, description, and severity. @@ -230882,11 +233540,11 @@ webhooks: from: type: object properties: - security_and_analysis: *281 - enterprise: *706 - installation: *707 - organization: *708 - repository: *328 + security_and_analysis: *280 + enterprise: *705 + installation: *706 + organization: *707 + repository: *327 sender: *4 required: - changes @@ -230964,12 +233622,12 @@ webhooks: type: string enum: - cancelled - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: &764 + sponsorship: &763 type: object properties: created_at: @@ -231274,12 +233932,12 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - sponsorship @@ -231367,12 +234025,12 @@ webhooks: type: string required: - from - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -231449,17 +234107,17 @@ webhooks: type: string enum: - pending_cancellation - effective_date: &765 + effective_date: &764 description: The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. type: string - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - sponsorship @@ -231533,7 +234191,7 @@ webhooks: type: string enum: - pending_tier_change - changes: &766 + changes: &765 type: object properties: tier: @@ -231577,13 +234235,13 @@ webhooks: - from required: - tier - effective_date: *765 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + effective_date: *764 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -231660,13 +234318,13 @@ webhooks: type: string enum: - tier_changed - changes: *766 - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + changes: *765 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - sponsorship: *764 + sponsorship: *763 required: - action - changes @@ -231740,10 +234398,10 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -231827,10 +234485,10 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -232264,15 +234922,15 @@ webhooks: type: - string - 'null' - enterprise: *706 + enterprise: *705 id: description: The unique identifier of the status. type: integer - installation: *707 + installation: *706 name: type: string - organization: *708 - repository: *709 + organization: *707 + repository: *708 sender: *4 sha: description: The Commit SHA. @@ -232388,9 +235046,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -232480,9 +235138,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -232572,9 +235230,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -232664,9 +235322,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *81 - installation: *707 - organization: *708 - repository: *709 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -232743,12 +235401,12 @@ webhooks: title: team_add event type: object properties: - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - team: &767 + team: &766 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -232978,9 +235636,9 @@ webhooks: type: string enum: - added_to_repository - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -233450,7 +236108,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -233526,9 +236184,9 @@ webhooks: type: string enum: - created - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -233998,7 +236656,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -234075,9 +236733,9 @@ webhooks: type: string enum: - deleted - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -234547,7 +237205,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -234691,9 +237349,9 @@ webhooks: - from required: - permissions - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -235163,7 +237821,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - changes @@ -235241,9 +237899,9 @@ webhooks: type: string enum: - removed_from_repository - enterprise: *706 - installation: *707 - organization: *708 + enterprise: *705 + installation: *706 + organization: *707 repository: title: Repository description: A git repository @@ -235713,7 +238371,7 @@ webhooks: - topics - visibility sender: *4 - team: *767 + team: *766 required: - action - team @@ -235789,10 +238447,10 @@ webhooks: type: string enum: - started - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 required: - action @@ -235865,17 +238523,17 @@ webhooks: title: workflow_dispatch event type: object properties: - enterprise: *706 + enterprise: *705 inputs: type: - object - 'null' additionalProperties: true - installation: *707 - organization: *708 + installation: *706 + organization: *707 ref: type: string - repository: *709 + repository: *708 sender: *4 workflow: type: string @@ -235957,10 +238615,10 @@ webhooks: type: string enum: - completed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: allOf: @@ -236216,7 +238874,7 @@ webhooks: type: string required: - conclusion - deployment: *481 + deployment: *480 required: - action - repository @@ -236295,10 +238953,10 @@ webhooks: type: string enum: - in_progress - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: allOf: @@ -236580,7 +239238,7 @@ webhooks: required: - status - steps - deployment: *481 + deployment: *480 required: - action - repository @@ -236659,10 +239317,10 @@ webhooks: type: string enum: - queued - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: type: object @@ -236808,7 +239466,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *481 + deployment: *480 required: - action - repository @@ -236887,10 +239545,10 @@ webhooks: type: string enum: - waiting - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 workflow_job: type: object @@ -237037,7 +239695,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *481 + deployment: *480 required: - action - repository @@ -237117,12 +239775,12 @@ webhooks: type: string enum: - completed - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object @@ -238141,12 +240799,12 @@ webhooks: type: string enum: - in_progress - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object @@ -239150,12 +241808,12 @@ webhooks: type: string enum: - requested - enterprise: *706 - installation: *707 - organization: *708 - repository: *709 + enterprise: *705 + installation: *706 + organization: *707 + repository: *708 sender: *4 - workflow: *721 + workflow: *720 workflow_run: title: Workflow Run type: object diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json index 30846985d7..3bffc0b13e 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json +++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.json @@ -211,6 +211,10 @@ { "name": "projects", "description": "Endpoints to manage Projects using the REST API." + }, + { + "name": "agent-tasks", + "description": "Endpoints to manage and interact with agent tasks." } ], "servers": [ @@ -1368,12 +1372,10 @@ "name": "Uncontrolled Resource Consumption" } ], - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "credits": [ { "user": { @@ -2234,6 +2236,3298 @@ } } }, + "/agents/repos/{owner}/{repo}/tasks": { + "get": { + "summary": "List tasks for repository", + "description": "Returns a list of tasks for a specific repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks-for-repo", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#list-tasks-for-repository" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + }, + { + "name": "creator_id", + "in": "query", + "schema": { + "type": "integer" + }, + "description": "Filter tasks by creator user ID" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"prev\" (when current page > 1),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + }, + "post": { + "summary": "Create a task", + "description": "Creates a new task for a repository", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/create-task", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#create-a-task" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "event_content" + ], + "properties": { + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID (optional, defaults to coding agent)" + }, + "problem_statement": { + "type": "string", + "description": "Additional prompting for the agent" + }, + "event_content": { + "type": "string", + "description": "User's written prompt" + }, + "model": { + "type": "string", + "description": "Model identifier" + }, + "custom_agent": { + "type": "string", + "description": "Custom agent identifier" + }, + "create_pull_request": { + "type": "boolean", + "description": "Whether to create a PR" + }, + "base_ref": { + "type": "string", + "description": "Base ref for new branch/PR" + }, + "event_type": { + "type": "string", + "description": "Type of event" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + } + } + }, + "examples": { + "default": { + "value": { + "event_content": "Fix the login button on the homepage", + "create_pull_request": true, + "base_ref": "main" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Task created successfully", + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "queued", + "session_count": 1, + "artifacts": [], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T00:00:00Z" + } + } + } + } + } + }, + "400": { + "description": "Problems parsing JSON", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/repos/{owner}/{repo}/tasks/{task_id}": { + "get": { + "summary": "Get a task by repo", + "description": "Returns a task by ID scoped to an owner/repo path", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-repo-and-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#get-a-task-by-repo" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "owner", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The account owner of the repository. The name is not case sensitive." + }, + { + "name": "repo", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The name of the repository. The name is not case sensitive." + }, + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks": { + "get": { + "summary": "List tasks", + "description": "Returns a list of tasks for the authenticated user", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/list-tasks", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#list-tasks" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "per_page", + "in": "query", + "schema": { + "type": "integer", + "default": 30, + "minimum": 1, + "maximum": 100 + }, + "description": "The number of results per page (max 100)." + }, + { + "name": "page", + "in": "query", + "schema": { + "type": "integer", + "default": 1, + "minimum": 1 + }, + "description": "The page number of the results to fetch." + }, + { + "name": "sort", + "in": "query", + "schema": { + "type": "string", + "default": "updated_at", + "enum": [ + "updated_at", + "created_at" + ] + }, + "description": "The field to sort results by. Can be `updated_at` or `created_at`." + }, + { + "name": "direction", + "in": "query", + "schema": { + "type": "string", + "default": "desc", + "enum": [ + "asc", + "desc" + ] + }, + "description": "The direction to sort results. Can be `asc` or `desc`." + }, + { + "name": "state", + "in": "query", + "schema": { + "type": "string" + }, + "description": "Comma-separated list of task states to filter by. Can be any combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, `waiting_for_user`, `timed_out`, `cancelled`." + }, + { + "name": "is_archived", + "in": "query", + "schema": { + "type": "boolean" + }, + "description": "Filter by archived status. When `true`, returns only archived tasks. When `false`, returns only non-archived tasks." + }, + { + "name": "since", + "in": "query", + "schema": { + "type": "string", + "format": "date-time" + }, + "description": "Only show tasks updated at or after this time (ISO 8601 timestamp)" + } + ], + "responses": { + "200": { + "description": "Tasks retrieved successfully", + "headers": { + "Link": { + "description": "Pagination links. Contains rel=\"first\" (always),\nrel=\"next\" (when more pages exist), and rel=\"last\" (when on the final page).\n", + "schema": { + "type": "string" + }, + "example": "; rel=\"next\", ; rel=\"first\"" + } + }, + "content": { + "application/json": { + "schema": { + "type": "object", + "required": [ + "tasks" + ], + "properties": { + "tasks": { + "type": "array", + "items": { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + "description": "List of tasks" + }, + "total_active_count": { + "type": "integer", + "format": "int32", + "description": "Total count of active (non-archived) tasks" + }, + "total_archived_count": { + "type": "integer", + "format": "int32", + "description": "Total count of archived tasks" + } + } + }, + "examples": { + "default": { + "value": { + "tasks": [ + { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Bad request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, + "/agents/tasks/{task_id}": { + "get": { + "summary": "Get a task by ID", + "description": "Returns a task by ID with its associated sessions", + "tags": [ + "agent-tasks" + ], + "operationId": "agent-tasks/get-task-by-id", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#get-a-task-by-id" + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "agent-tasks", + "subcategory": "agent-tasks" + }, + "parameters": [ + { + "name": "task_id", + "in": "path", + "required": true, + "schema": { + "type": "string" + }, + "description": "The unique identifier of the task." + } + ], + "responses": { + "200": { + "description": "Task retrieved successfully", + "content": { + "application/json": { + "schema": { + "allOf": [ + { + "type": "object", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Unique task identifier" + }, + "url": { + "type": "string", + "description": "API URL for this task" + }, + "html_url": { + "type": "string", + "description": "Web URL for this task" + }, + "name": { + "type": "string", + "description": "Human-readable name derived from the task prompt" + }, + "creator": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + } + ], + "description": "The entity who created this task" + }, + "creator_type": { + "type": "string", + "description": "Type of the task creator", + "enum": [ + "user", + "organization" + ] + }, + "user_collaborators": { + "type": "array", + "items": { + "type": "object", + "description": "A GitHub user", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "description": "User objects of collaborators on this task", + "deprecated": true + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this task belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "state": { + "type": "string", + "description": "Current state of the task, derived from its most recent session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "session_count": { + "type": "integer", + "format": "int32", + "description": "Number of sessions in this task" + }, + "artifacts": { + "type": "array", + "items": { + "type": "object", + "description": "A resource generated by the task", + "required": [ + "provider", + "type", + "data" + ], + "properties": { + "provider": { + "type": "string", + "enum": [ + "github" + ], + "description": "Provider namespace" + }, + "type": { + "type": "string", + "enum": [ + "github_resource", + "branch" + ], + "description": "Discriminator for data shape" + }, + "data": { + "oneOf": [ + { + "type": "object", + "description": "A GitHub resource (pull request, issue, etc.)", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "GitHub resource ID" + }, + "type": { + "type": "string", + "description": "Resource type (e.g., pull_request, issue)" + }, + "global_id": { + "type": "string", + "description": "GraphQL global ID" + } + } + }, + { + "type": "object", + "description": "A Git branch reference", + "properties": { + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + } + } + } + ], + "description": "Resource data (shape depends on type)" + } + } + }, + "description": "Resources created by this task (PRs, branches, etc.)" + }, + "archived_at": { + "type": [ + "string", + "null" + ], + "format": "date-time", + "description": "Timestamp when the task was archived, null if not archived" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp of the most recent update" + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Timestamp when the task was created" + } + } + }, + { + "type": "object", + "properties": { + "sessions": { + "type": "array", + "items": { + "type": "object", + "description": "Full session details within a task", + "required": [ + "id", + "state", + "created_at" + ], + "properties": { + "id": { + "type": "string", + "description": "Session ID" + }, + "name": { + "type": "string", + "description": "Session name" + }, + "user": { + "description": "The user who created this session", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "owner": { + "description": "The owner of the repository", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the user" + } + } + }, + "repository": { + "description": "The repository this session belongs to", + "type": "object", + "properties": { + "id": { + "type": "integer", + "format": "int64", + "description": "The unique identifier of the repository" + } + } + }, + "agent_id": { + "type": "integer", + "format": "int64", + "description": "Agent ID" + }, + "agent_task_id": { + "type": "string", + "description": "Agent internal task ID" + }, + "task_id": { + "type": "string", + "description": "Task ID this session belongs to" + }, + "state": { + "type": "string", + "description": "Current state of a session", + "enum": [ + "queued", + "in_progress", + "completed", + "failed", + "idle", + "waiting_for_user", + "timed_out", + "cancelled" + ] + }, + "created_at": { + "type": "string", + "format": "date-time", + "description": "Creation timestamp" + }, + "updated_at": { + "type": "string", + "format": "date-time", + "description": "Last update timestamp" + }, + "completed_at": { + "type": "string", + "format": "date-time", + "description": "Completion timestamp" + }, + "event_type": { + "type": "string", + "description": "Type of event that triggered this session" + }, + "event_url": { + "type": "string", + "description": "URL of the triggering event" + }, + "event_content": { + "type": "string", + "description": "Content of the triggering event" + }, + "event_identifiers": { + "type": "array", + "items": { + "type": "string" + }, + "description": "Identifiers for tracking" + }, + "resource_type": { + "type": "string", + "description": "Type of resource associated with this session" + }, + "resource_id": { + "type": "integer", + "format": "int64", + "description": "Resource ID" + }, + "resource_number": { + "type": "integer", + "format": "int32", + "description": "Resource number (e.g., PR number)" + }, + "resource_global_id": { + "type": "string", + "description": "GraphQL global ID of the resource" + }, + "resource_state": { + "type": "string", + "description": "State of the associated resource" + }, + "head_ref": { + "type": "string", + "description": "Head branch name" + }, + "base_ref": { + "type": "string", + "description": "Base branch name" + }, + "workflow_run_id": { + "type": "integer", + "format": "int64", + "description": "GitHub Actions workflow run ID" + }, + "model": { + "type": "string", + "description": "Model used for this session" + }, + "premium_requests": { + "type": "number", + "format": "double", + "description": "Premium request count" + }, + "error": { + "type": "object", + "description": "Error details for a failed session", + "properties": { + "message": { + "type": "string", + "description": "Error message" + } + } + } + } + }, + "description": "Sessions associated with this task" + } + } + } + ] + }, + "examples": { + "default": { + "value": { + "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "url": "https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "html_url": "https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "creator": { + "id": 1 + }, + "creator_type": "user", + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "state": "completed", + "session_count": 1, + "artifacts": [ + { + "provider": "github", + "type": "github_resource", + "data": { + "id": 42, + "type": "pull_request" + } + } + ], + "archived_at": null, + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "sessions": [ + { + "id": "s1a2b3c4-d5e6-7890-abcd-ef1234567890", + "name": "Fix the login button on the homepage", + "user": { + "id": 1 + }, + "owner": { + "id": 1 + }, + "repository": { + "id": 1296269 + }, + "task_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", + "state": "completed", + "created_at": "2025-01-01T00:00:00Z", + "updated_at": "2025-01-01T01:00:00Z", + "completed_at": "2025-01-01T01:00:00Z", + "event_content": "Fix the login button on the homepage", + "head_ref": "copilot/fix-1", + "base_ref": "main" + } + ] + } + } + } + } + } + }, + "400": { + "description": "Problems parsing request", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "401": { + "description": "Authentication required", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "403": { + "description": "Insufficient permissions", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + }, + "422": { + "description": "Validation Failed", + "content": { + "application/json": { + "schema": { + "type": "object", + "description": "Structured error response following GitHub REST API conventions.\nFor 422 Unprocessable Entity the errors array contains validation\ndetails; for other error status codes only message and\ndocumentation_url are returned.", + "required": [ + "message", + "documentation_url" + ], + "properties": { + "message": { + "type": "string", + "description": "Summary message (e.g. \"Validation Failed\", \"Not Found\")" + }, + "errors": { + "type": "array", + "items": { + "type": "object", + "description": "A single validation error", + "required": [ + "code" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "missing", + "missing_field", + "invalid", + "already_exists", + "unprocessable", + "custom" + ], + "description": "Machine-readable error code" + }, + "message": { + "type": "string", + "description": "Human-readable message (populated when code is \"custom\")" + } + } + }, + "description": "List of validation errors (present only for 422 responses)" + }, + "documentation_url": { + "type": "string", + "description": "URL to relevant API documentation" + } + } + } + } + } + } + } + } + }, "/app": { "get": { "summary": "Get the authenticated app", @@ -49737,6 +53031,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -51261,12 +54556,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -56074,340 +59367,366 @@ }, "network_settings_ids": { "type": "array", - "minItems": 1, + "minItems": 1, + "maxItems": 1, + "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." + } + }, + "required": [ + "name", + "network_settings_ids" + ] + }, + "examples": { + "default": { + "value": { + "name": "my-network-configuration", + "network_settings_ids": [ + "23456789ABDCEF1" + ], + "compute_service": "actions" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "enterprise-admin", + "subcategory": "network-configurations" + } + } + }, + "/enterprises/{enterprise}/network-configurations/{network_configuration_id}": { + "get": { + "summary": "Get a hosted compute network configuration for an enterprise", + "description": "Gets a hosted compute network configuration configured in an enterprise.", + "tags": [ + "enterprise-admin", + "hosted-compute" + ], + "operationId": "hosted-compute/get-network-configuration-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-configuration-for-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "responses": { + "200": { + "description": "Response", + "content": { + "application/json": { + "schema": { + "title": "Hosted compute network configuration", + "description": "A hosted compute network configuration.", + "type": "object", + "properties": { + "id": { + "description": "The unique identifier of the network configuration.", + "type": "string", + "examples": [ + "123ABC456DEF789" + ] + }, + "name": { + "description": "The name of the network configuration.", + "type": "string", + "examples": [ + "my-network-configuration" + ] + }, + "compute_service": { + "description": "The hosted compute service the network configuration supports.", + "type": "string", + "enum": [ + "none", + "actions", + "codespaces" + ] + }, + "network_settings_ids": { + "description": "The unique identifier of each network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_settings_ids": { + "description": "The unique identifier of each failover network settings in the configuration.", + "type": "array", + "items": { + "type": "string" + }, + "examples": [ + "123ABC456DEF789" + ] + }, + "failover_network_enabled": { + "description": "Indicates whether the failover network resource is enabled.", + "type": "boolean", + "examples": [ + true + ] + }, + "created_on": { + "description": "The time at which the network configuration was created, in ISO 8601 format.", + "type": [ + "string", + "null" + ], + "format": "date-time", + "examples": [ + "2024-04-26T11:31:07Z" + ] + } + }, + "required": [ + "id", + "name", + "created_on" + ] + }, + "examples": { + "default": { + "value": { + "id": "123456789ABCDEF", + "name": "My network configuration", + "compute_service": "actions", + "network_settings_ids": [ + "23456789ABDCEF1", + "3456789ABDCEF12" + ], + "created_on": "2022-10-09T23:39:01Z" + } + } + } + } + }, + "headers": { + "Link": { + "example": "; rel=\"next\", ; rel=\"last\"", + "schema": { + "type": "string" + } + } + } + } + }, + "x-github": { + "githubCloudOnly": true, + "enabledForGitHubApps": false, + "category": "enterprise-admin", + "subcategory": "network-configurations" + } + }, + "patch": { + "summary": "Update a hosted compute network configuration for an enterprise", + "description": "Updates a hosted compute network configuration for an enterprise.", + "tags": [ + "enterprise-admin", + "hosted-compute" + ], + "operationId": "hosted-compute/update-network-configuration-for-enterprise", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#update-a-hosted-compute-network-configuration-for-an-enterprise" + }, + "parameters": [ + { + "name": "enterprise", + "description": "The slug version of the enterprise name.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "network_configuration_id", + "description": "Unique identifier of the hosted compute network configuration.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "name": { + "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, `.`, `-`, and `_`.", + "type": "string" + }, + "compute_service": { + "description": "The hosted compute service to use for the network configuration.", + "type": "string", + "enum": [ + "none", + "actions" + ] + }, + "network_settings_ids": { + "type": "array", + "minItems": 0, "maxItems": 1, "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } - } - }, - "required": [ - "name", - "network_settings_ids" - ] - }, - "examples": { - "default": { - "value": { - "name": "my-network-configuration", - "network_settings_ids": [ - "23456789ABDCEF1" - ], - "compute_service": "actions" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "enterprise-admin", - "subcategory": "network-configurations" - } - } - }, - "/enterprises/{enterprise}/network-configurations/{network_configuration_id}": { - "get": { - "summary": "Get a hosted compute network configuration for an enterprise", - "description": "Gets a hosted compute network configuration configured in an enterprise.", - "tags": [ - "enterprise-admin", - "hosted-compute" - ], - "operationId": "hosted-compute/get-network-configuration-for-enterprise", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-configuration-for-an-enterprise" - }, - "parameters": [ - { - "name": "enterprise", - "description": "The slug version of the enterprise name.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "responses": { - "200": { - "description": "Response", - "content": { - "application/json": { - "schema": { - "title": "Hosted compute network configuration", - "description": "A hosted compute network configuration.", - "type": "object", - "properties": { - "id": { - "description": "The unique identifier of the network configuration.", - "type": "string", - "examples": [ - "123ABC456DEF789" - ] - }, - "name": { - "description": "The name of the network configuration.", - "type": "string", - "examples": [ - "my-network-configuration" - ] - }, - "compute_service": { - "description": "The hosted compute service the network configuration supports.", - "type": "string", - "enum": [ - "none", - "actions", - "codespaces" - ] - }, - "network_settings_ids": { - "description": "The unique identifier of each network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_settings_ids": { - "description": "The unique identifier of each failover network settings in the configuration.", - "type": "array", - "items": { - "type": "string" - }, - "examples": [ - "123ABC456DEF789" - ] - }, - "failover_network_enabled": { - "description": "Indicates whether the failover network resource is enabled.", - "type": "boolean", - "examples": [ - true - ] - }, - "created_on": { - "description": "The time at which the network configuration was created, in ISO 8601 format.", - "type": [ - "string", - "null" - ], - "format": "date-time", - "examples": [ - "2024-04-26T11:31:07Z" - ] - } - }, - "required": [ - "id", - "name", - "created_on" - ] - }, - "examples": { - "default": { - "value": { - "id": "123456789ABCDEF", - "name": "My network configuration", - "compute_service": "actions", - "network_settings_ids": [ - "23456789ABDCEF1", - "3456789ABDCEF12" - ], - "created_on": "2022-10-09T23:39:01Z" - } - } - } - } - }, - "headers": { - "Link": { - "example": "; rel=\"next\", ; rel=\"last\"", - "schema": { - "type": "string" - } - } - } - } - }, - "x-github": { - "githubCloudOnly": true, - "enabledForGitHubApps": false, - "category": "enterprise-admin", - "subcategory": "network-configurations" - } - }, - "patch": { - "summary": "Update a hosted compute network configuration for an enterprise", - "description": "Updates a hosted compute network configuration for an enterprise.", - "tags": [ - "enterprise-admin", - "hosted-compute" - ], - "operationId": "hosted-compute/update-network-configuration-for-enterprise", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#update-a-hosted-compute-network-configuration-for-an-enterprise" - }, - "parameters": [ - { - "name": "enterprise", - "description": "The slug version of the enterprise name.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "network_configuration_id", - "description": "Unique identifier of the hosted compute network configuration.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "name": { - "description": "Name of the network configuration. Must be between 1 and 100 characters and may only contain upper and lowercase letters a-z, numbers 0-9, `.`, `-`, and `_`.", - "type": "string" - }, - "compute_service": { - "description": "The hosted compute service to use for the network configuration.", - "type": "string", - "enum": [ - "none", - "actions" - ] - }, - "network_settings_ids": { + "failover_network_settings_ids": { "type": "array", "minItems": 0, "maxItems": 1, - "description": "A list of identifiers of the network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", "items": { "type": "string" } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -69788,6 +73107,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -69881,6 +73208,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -69898,6 +73233,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -69915,6 +73258,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -69983,6 +73334,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -70000,6 +73359,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -70017,6 +73384,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -70034,6 +73409,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -70051,6 +73434,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -140464,10 +143855,7 @@ "type": "string" } } - }, - "required": [ - "include_claim_keys" - ] + } }, "examples": { "default": { @@ -156365,6 +159753,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created or updated record in the response body.\n" } }, "required": [ @@ -156468,8 +159861,347 @@ } } } + }, + "required": [ + "total_count" + ] + }, + "examples": { + "default": { + "value": { + "total_count": 1, + "deployment_records": [ + { + "id": 123, + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "logical_environment": "prod", + "physical_environment": "pacific-east", + "cluster": "moda-1", + "deployment_name": "prod-deployment", + "tags": { + "data": "sensitive" + }, + "created": "2011-01-26T19:14:43Z", + "updated_at": "2011-01-26T19:14:43Z", + "attestation_id": 456 + } + ] + } + } + } + } + } + }, + "403": { + "description": "Forbidden", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + }, + "404": { + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "title": "Basic Error", + "description": "Basic Error", + "type": "object", + "properties": { + "message": { + "type": "string" + }, + "documentation_url": { + "type": "string" + }, + "url": { + "type": "string" + }, + "status": { + "type": "string" + } + } + } + } + } + } + }, + "x-github": { + "githubCloudOnly": false, + "enabledForGitHubApps": true, + "category": "orgs", + "subcategory": "artifact-metadata" + } + } + }, + "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { + "post": { + "summary": "Set cluster deployment records", + "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", + "tags": [ + "orgs" + ], + "operationId": "orgs/set-cluster-deployment-records", + "externalDocs": { + "description": "API method documentation", + "url": "https://docs.github.com/enterprise-cloud@latest//rest/orgs/artifact-metadata#set-cluster-deployment-records" + }, + "parameters": [ + { + "name": "org", + "description": "The organization name. The name is not case sensitive.", + "in": "path", + "required": true, + "schema": { + "type": "string" + } + }, + { + "name": "cluster", + "in": "path", + "description": "The cluster name.", + "required": true, + "schema": { + "type": "string", + "minLength": 1, + "maxLength": 128, + "pattern": "^[a-zA-Z0-9._-]+$" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "logical_environment": { + "type": "string", + "description": "The stage of the deployment.", + "minLength": 1, + "maxLength": 128 + }, + "physical_environment": { + "type": "string", + "description": "The physical region of the deployment.", + "maxLength": 128 + }, + "deployments": { + "type": "array", + "description": "The list of deployments to record.", + "maxItems": 1000, + "items": { + "type": "object", + "properties": { + "name": { + "type": "string", + "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", + "minLength": 1, + "maxLength": 256 + }, + "digest": { + "type": "string", + "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", + "minLength": 71, + "maxLength": 71, + "pattern": "^sha256:[a-f0-9]{64}$" + }, + "version": { + "type": "string", + "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", + "maxLength": 100, + "x-multi-segment": true, + "examples": [ + "1.2.3" + ] + }, + "status": { + "type": "string", + "description": "The deployment status of the artifact.", + "default": "deployed", + "enum": [ + "deployed", + "decommissioned" + ] + }, + "deployment_name": { + "type": "string", + "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", + "minLength": 1, + "maxLength": 256 + }, + "github_repository": { + "type": "string", + "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", + "maxLength": 100, + "pattern": "^[A-Za-z0-9.\\-_]+$", + "examples": [ + "my-github-repo" + ] + }, + "tags": { + "type": "object", + "description": "Key-value pairs to tag the deployment record.", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + } + }, + "required": [ + "name", + "deployment_name", + "digest" + ] + } + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the set records in the response body\n" } }, + "required": [ + "logical_environment", + "deployments" + ] + }, + "examples": { + "default": { + "value": { + "logical_environment": "prod", + "physical_environment": "pacific-east", + "deployments": [ + { + "name": "awesome-image", + "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", + "version": "2.1.0", + "status": "deployed", + "deployment_name": "deployment-pod", + "tags": { + "runtime-risk": "sensitive-data" + } + } + ] + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Deployment records created or updated successfully.\n", + "content": { + "application/json": { + "schema": { + "type": "object", + "properties": { + "total_count": { + "description": "The number of deployment records created", + "type": "integer" + }, + "deployment_records": { + "type": "array", + "items": { + "title": "Artifact Deployment Record", + "description": "Artifact Metadata Deployment Record", + "type": "object", + "properties": { + "id": { + "type": "integer" + }, + "digest": { + "type": "string" + }, + "logical_environment": { + "type": "string" + }, + "physical_environment": { + "type": "string" + }, + "cluster": { + "type": "string" + }, + "deployment_name": { + "type": "string" + }, + "tags": { + "type": "object", + "additionalProperties": { + "type": "string" + } + }, + "runtime_risks": { + "type": "array", + "description": "A list of runtime risks associated with the deployment.", + "maxItems": 4, + "uniqueItems": true, + "items": { + "type": "string", + "enum": [ + "critical-resource", + "internet-exposed", + "lateral-movement", + "sensitive-data" + ] + } + }, + "created_at": { + "type": "string" + }, + "updated_at": { + "type": "string" + }, + "attestation_id": { + "type": [ + "integer", + "null" + ], + "description": "The ID of the provenance attestation associated with the deployment record." + } + } + } + } + }, + "required": [ + "total_count" + ] + }, "examples": { "default": { "value": { @@ -156518,332 +160250,17 @@ "type": "string" } } - } - } - } - }, - "404": { - "description": "Resource not found", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" - } - } - } - } - } - } - }, - "x-github": { - "githubCloudOnly": false, - "enabledForGitHubApps": true, - "category": "orgs", - "subcategory": "artifact-metadata" - } - } - }, - "/orgs/{org}/artifacts/metadata/deployment-record/cluster/{cluster}": { - "post": { - "summary": "Set cluster deployment records", - "description": "Set deployment records for a given cluster.\nIf proposed records in the 'deployments' field have identical 'cluster', 'logical_environment',\n'physical_environment', and 'deployment_name' values as existing records, the existing records will be updated.\nIf no existing records match, new records will be created.", - "tags": [ - "orgs" - ], - "operationId": "orgs/set-cluster-deployment-records", - "externalDocs": { - "description": "API method documentation", - "url": "https://docs.github.com/enterprise-cloud@latest//rest/orgs/artifact-metadata#set-cluster-deployment-records" - }, - "parameters": [ - { - "name": "org", - "description": "The organization name. The name is not case sensitive.", - "in": "path", - "required": true, - "schema": { - "type": "string" - } - }, - { - "name": "cluster", - "in": "path", - "description": "The cluster name.", - "required": true, - "schema": { - "type": "string", - "minLength": 1, - "maxLength": 128, - "pattern": "^[a-zA-Z0-9._-]+$" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "logical_environment": { - "type": "string", - "description": "The stage of the deployment.", - "minLength": 1, - "maxLength": 128 - }, - "physical_environment": { - "type": "string", - "description": "The physical region of the deployment.", - "maxLength": 128 - }, - "deployments": { - "type": "array", - "description": "The list of deployments to record.", - "maxItems": 1000, - "items": { - "type": "object", - "properties": { - "name": { - "type": "string", - "description": "The name of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name parameter must also be identical across all entries.\n", - "minLength": 1, - "maxLength": 256 - }, - "digest": { - "type": "string", - "description": "The hex encoded digest of the artifact. Note that if multiple deployments have identical 'digest' parameter values,\nthe name and version parameters must also be identical across all entries.\n", - "minLength": 71, - "maxLength": 71, - "pattern": "^sha256:[a-f0-9]{64}$" - }, - "version": { - "type": "string", - "description": "The artifact version. Note that if multiple deployments have identical 'digest' parameter values,\nthe version parameter must also be identical across all entries.\n", - "maxLength": 100, - "x-multi-segment": true, - "examples": [ - "1.2.3" - ] - }, - "status": { - "type": "string", - "description": "The deployment status of the artifact.", - "default": "deployed", - "enum": [ - "deployed", - "decommissioned" - ] - }, - "deployment_name": { - "type": "string", - "description": "The unique identifier for the deployment represented by the new record. To accommodate differing\ncontainers and namespaces within a record set, the following format is recommended:\n{namespaceName}-{deploymentName}-{containerName}.\nThe deployment_name must be unique across all entries in the deployments array.\n", - "minLength": 1, - "maxLength": 256 - }, - "github_repository": { - "type": "string", - "description": "The name of the GitHub repository associated with the artifact. This should be used\nwhen there are no provenance attestations available for the artifact. The repository\nmust belong to the organization specified in the path parameter.\n\nIf a provenance attestation is available for the artifact, the API will use\nthe repository information from the attestation instead of this parameter.", - "maxLength": 100, - "pattern": "^[A-Za-z0-9.\\-_]+$", - "examples": [ - "my-github-repo" - ] - }, - "tags": { - "type": "object", - "description": "Key-value pairs to tag the deployment record.", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - } - }, - "required": [ - "name", - "deployment_name", - "digest" - ] - } - } - }, - "required": [ - "logical_environment", - "deployments" - ] - }, - "examples": { - "default": { - "value": { - "logical_environment": "prod", - "physical_environment": "pacific-east", - "deployments": [ - { - "name": "awesome-image", - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "version": "2.1.0", - "status": "deployed", - "deployment_name": "deployment-pod", - "tags": { - "runtime-risk": "sensitive-data" - } - } - ] - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Deployment records created or updated successfully.\n", - "content": { - "application/json": { - "schema": { - "type": "object", - "properties": { - "total_count": { - "description": "The number of deployment records created", - "type": "integer" - }, - "deployment_records": { - "type": "array", - "items": { - "title": "Artifact Deployment Record", - "description": "Artifact Metadata Deployment Record", - "type": "object", - "properties": { - "id": { - "type": "integer" - }, - "digest": { - "type": "string" - }, - "logical_environment": { - "type": "string" - }, - "physical_environment": { - "type": "string" - }, - "cluster": { - "type": "string" - }, - "deployment_name": { - "type": "string" - }, - "tags": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "runtime_risks": { - "type": "array", - "description": "A list of runtime risks associated with the deployment.", - "maxItems": 4, - "uniqueItems": true, - "items": { - "type": "string", - "enum": [ - "critical-resource", - "internet-exposed", - "lateral-movement", - "sensitive-data" - ] - } - }, - "created_at": { - "type": "string" - }, - "updated_at": { - "type": "string" - }, - "attestation_id": { - "type": [ - "integer", - "null" - ], - "description": "The ID of the provenance attestation associated with the deployment record." - } - } - } - } - } }, "examples": { - "default": { + "insufficient_repo_permissions": { "value": { - "total_count": 1, - "deployment_records": [ - { - "id": 123, - "digest": "sha256:1bb1e949e55dcefc6353e7b36c8897d2a107d8e8dca49d4e3c0ea8493fc0bc72", - "logical_environment": "prod", - "physical_environment": "pacific-east", - "cluster": "moda-1", - "deployment_name": "prod-deployment", - "tags": { - "data": "sensitive" - }, - "created": "2011-01-26T19:14:43Z", - "updated_at": "2011-01-26T19:14:43Z", - "attestation_id": 456 - } - ] - } - } - } - } - } - }, - "403": { - "description": "Forbidden", - "content": { - "application/json": { - "schema": { - "title": "Basic Error", - "description": "Basic Error", - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "documentation_url": { - "type": "string" - }, - "url": { - "type": "string" - }, - "status": { - "type": "string" + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } } } } @@ -157000,6 +160417,11 @@ "examples": [ "my-github-repo" ] + }, + "return_records": { + "type": "boolean", + "default": true, + "description": "If true, the endpoint will return the created record in the response body.\n" } }, "required": [ @@ -157079,7 +160501,10 @@ } } } - } + }, + "required": [ + "total_count" + ] }, "examples": { "default": { @@ -184625,6 +188050,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -186149,12 +189575,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -232331,7 +235755,7 @@ "/orgs/{org}/organization-fine-grained-permissions": { "get": { "summary": "List organization fine-grained permissions for an organization", - "description": "Lists the fine-grained permissions that can be used in custom organization roles for an organization. For more information, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nTo list the fine-grained permissions that can be used in custom repository roles for an organization, see \"[List repository fine-grained permissions for an organization](https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-repository-fine-grained-permissions-for-an-organization).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the fine-grained permissions that can be used in custom organization roles for an organization. For more information, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nTo list the fine-grained permissions that can be used in custom repository roles for an organization, see \"[List repository fine-grained permissions for an organization](https://docs.github.com/enterprise-cloud@latest//rest/orgs/organization-roles#list-repository-fine-grained-permissions-for-an-organization).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -232506,7 +235930,7 @@ "/orgs/{org}/organization-roles": { "get": { "summary": "Get all organization roles for an organization", - "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Lists the organization roles available in this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -232981,7 +236405,7 @@ }, "post": { "summary": "Create a custom organization role", - "description": "Creates a custom organization role that can be assigned to users and teams, granting them specific\npermissions over the organization and optionally across all repositories in the organization. For\nmore information on custom organization roles, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nTo include repository permissions in an organization role, you must also include the `base_role`\nfield, which is one of `read`, `write`, `triage`, `maintain`, or `admin` (or `none` if no base role is set). This base role provides a set of\nfine-grained permissions as well as implicit permissions - those that aren't exposed as fine-grained permissions\nand can only be granted through the base role (like \"reading a repo\"). If you include repository permissions, those\npermissions apply across all of the repositories in the organization. You do not have to include organization permissions\nin order to add repository permissions.\n\nSee \"[List repository permissions](https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#list-repository-fine-grained-permissions-for-an-organization)\" for valid repository permissions.\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `write_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Creates a custom organization role that can be assigned to users and teams, granting them specific\npermissions over the organization and optionally across all repositories in the organization. For\nmore information on custom organization roles, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nTo include repository permissions in an organization role, you must also include the `base_role`\nfield, which is one of `read`, `write`, `triage`, `maintain`, or `admin` (or `none` if no base role is set). This base role provides a set of\nfine-grained permissions as well as implicit permissions - those that aren't exposed as fine-grained permissions\nand can only be granted through the base role (like \"reading a repo\"). If you include repository permissions, those\npermissions apply across all of the repositories in the organization. You do not have to include organization permissions\nin order to add repository permissions.\n\nSee \"[List repository permissions](https://docs.github.com/enterprise-cloud@latest//rest/orgs/custom-roles#list-repository-fine-grained-permissions-for-an-organization)\" for valid repository permissions.\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **Manage custom organization roles** (`write_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -233800,7 +237224,7 @@ "/orgs/{org}/organization-roles/{role_id}": { "get": { "summary": "Get an organization role", - "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Gets an organization role that is available to this organization. For more information on organization roles, see \"[Using organization roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/using-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -234230,7 +237654,7 @@ }, "patch": { "summary": "Update a custom organization role", - "description": "Updates an existing custom organization role. Permission changes will apply to all assignees. For more information on custom organization roles, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nIf the update would add repository permissions, the `base_role` must also be set to a value besides `none`, either\npreviously or as part of the update.\nIf the update sets the `base_role` field to `none`, you must also remove all of the repository\npermissions as well, otherwise the update will fail.\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `write_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Updates an existing custom organization role. Permission changes will apply to all assignees. For more information on custom organization roles, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nIf the update would add repository permissions, the `base_role` must also be set to a value besides `none`, either\npreviously or as part of the update.\nIf the update sets the `base_role` field to `none`, you must also remove all of the repository\npermissions as well, otherwise the update will fail.\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **Manage custom organization roles** (`write_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -234732,7 +238156,7 @@ }, "delete": { "summary": "Delete a custom organization role.", - "description": "Deletes a custom organization role. For more information on custom organization roles, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- A user, or a user on a team, with the fine-grained permissions of `write_organization_custom_org_role` in the organization.\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", + "description": "Deletes a custom organization role. For more information on custom organization roles, see \"[Managing people's access to your organization with roles](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/about-custom-organization-roles).\"\n\nTo use this endpoint, the authenticated user must be one of:\n\n- An administrator for the organization.\n- An organization member (or a member of a team) assigned a custom organization role that includes the **Manage custom organization roles** (`write_organization_custom_org_role`) permission. For more information, see \"[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access).\"\n\nOAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint.", "tags": [ "orgs" ], @@ -295863,6 +299287,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -295956,6 +299388,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -295973,6 +299413,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -295990,6 +299438,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -296058,6 +299514,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -296075,6 +299539,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -296092,6 +299564,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -296109,6 +299589,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -296126,6 +299614,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -301995,6 +305491,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } }, "required": [ @@ -302321,6 +305830,19 @@ "items": { "type": "string" } + }, + "failover_network_settings_ids": { + "type": "array", + "minItems": 0, + "maxItems": 1, + "description": "A list of identifiers of the failover network settings resources to use for the network configuration. Exactly one resource identifier must be specified in the list.", + "items": { + "type": "string" + } + }, + "failover_network_enabled": { + "type": "boolean", + "description": "Indicates whether the failover network resource is enabled." } } }, @@ -439697,6 +443219,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -440669,12 +444192,10 @@ "score": 8.7 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-200", @@ -441186,6 +444707,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -442167,12 +445689,10 @@ "score": 8.5 } }, - "epss": [ - { - "percentage": 0.00045, - "percentile": "0.16001e0" - } - ], + "epss": { + "percentage": 0.00045, + "percentile": "0.16001e0" + }, "cwes": [ { "cwe_id": "CWE-532", @@ -442504,6 +446024,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -686648,6 +690169,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -686741,6 +690270,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -686758,6 +690295,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -686775,6 +690320,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -686843,6 +690396,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -686860,6 +690421,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -686877,6 +690446,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -686894,6 +690471,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -686911,6 +690496,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -688059,6 +691652,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -688152,6 +691753,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -688169,6 +691778,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -688186,6 +691803,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -688254,6 +691879,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -688271,6 +691904,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -688288,6 +691929,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -688305,6 +691954,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -688322,6 +691979,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -689453,6 +693118,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -689546,6 +693219,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -689563,6 +693244,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -689580,6 +693269,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -689648,6 +693345,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -689665,6 +693370,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -689682,6 +693395,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -689699,6 +693420,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -689716,6 +693445,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -690161,6 +693898,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -690254,6 +693999,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -690271,6 +694024,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -690288,6 +694049,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -690356,6 +694125,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -690373,6 +694150,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -690390,6 +694175,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -690407,6 +694200,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -690424,6 +694225,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ @@ -939597,7 +943406,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -939783,6 +943593,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -939899,6 +943736,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -941999,7 +945856,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -942185,6 +946043,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -942301,6 +946186,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -944401,7 +948306,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -944587,6 +948493,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -944703,6 +948636,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -946803,7 +950756,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -946989,6 +950943,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -947105,6 +951086,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -949246,7 +953247,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -949432,6 +953434,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -949548,6 +953577,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1006592,6 +1010641,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1009576,6 +1013626,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1012560,6 +1016611,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1015544,6 +1019596,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1018528,6 +1022581,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1021512,6 +1025566,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1024496,6 +1028551,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1027480,6 +1031536,7 @@ "unknown", "direct", "transitive", + "inconclusive", null ] } @@ -1108507,7 +1112564,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1108693,6 +1112751,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1108809,6 +1112894,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1110909,7 +1115014,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1111095,6 +1115201,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1111211,6 +1115344,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1113352,7 +1117505,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1113538,6 +1117692,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1113654,6 +1117835,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1115754,7 +1119955,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1115940,6 +1120142,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1116056,6 +1120285,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1118156,7 +1122405,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1118342,6 +1122592,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1118458,6 +1122735,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1120599,7 +1124896,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1120785,6 +1125083,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1120901,6 +1125226,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1123001,7 +1127346,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1123187,6 +1127533,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1123303,6 +1127676,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1125403,7 +1129796,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1125589,6 +1129983,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1125705,6 +1130126,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1127805,7 +1132246,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1127991,6 +1132433,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1128107,6 +1132576,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1130248,7 +1134737,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1130434,6 +1134924,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1130550,6 +1135067,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1132691,7 +1137228,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1132877,6 +1137415,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1132993,6 +1137558,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1135093,7 +1139678,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1135279,6 +1139865,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1135395,6 +1140008,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1137495,7 +1142128,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1137681,6 +1142315,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1137797,6 +1142458,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1139897,7 +1144578,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1140083,6 +1144765,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1140199,6 +1144908,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1142340,7 +1147069,8 @@ "secret_scanning", "secret_scanning_closure", "code_scanning_alert_dismissal", - "dependabot_alert_dismissal" + "dependabot_alert_dismissal", + "license_compliance_alert_dismissal" ] }, "exemption_request_data": { @@ -1142526,6 +1147256,33 @@ } } } + }, + { + "title": "License compliance alert closure request data", + "description": "License compliance alerts that have closure requests.", + "type": "object", + "properties": { + "type": { + "type": "string", + "description": "The type of request", + "enum": [ + "license_compliance_alert_dismissal" + ] + }, + "data": { + "type": "array", + "description": "The data related to the License compliance alerts that have closure requests.", + "items": { + "type": "object", + "properties": { + "alert_number": { + "type": "string", + "description": "The number of the alert to be closed" + } + } + } + } + } } ] }, @@ -1142642,6 +1147399,26 @@ ] } } + }, + { + "title": "License compliance alert closure request metadata", + "description": "Metadata for a License compliance alert closure request.", + "type": "object", + "properties": { + "alert_title": { + "type": "string", + "description": "The title of the License compliance alert" + }, + "reason": { + "type": "string", + "description": "The reason for the closure request", + "enum": [ + "amendment", + "private package", + "inaccurate license" + ] + } + } } ] }, @@ -1694533,6 +1699310,14 @@ "commit_url": { "type": "string", "description": "The API URL to get the associated commit resource" + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL to get the associated commit resource.", + "examples": [ + "https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1" + ] } }, "required": [ @@ -1694626,6 +1699411,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1694643,6 +1699436,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/1347" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1" + ] } }, "required": [ @@ -1694660,6 +1699461,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the issue comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451" + ] } }, "required": [ @@ -1694728,6 +1699537,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1694745,6 +1699562,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846" + ] } }, "required": [ @@ -1694762,6 +1699587,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451" + ] } }, "required": [ @@ -1694779,6 +1699612,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80" + ] } }, "required": [ @@ -1694796,6 +1699637,14 @@ "examples": [ "https://api.github.com/repos/octocat/Hello-World/pulls/comments/12" ] + }, + "html_url": { + "type": "string", + "format": "uri", + "description": "The GitHub URL for the pull request review comment where the secret was detected.", + "examples": [ + "https://github.com/octocat/Hello-World/pull/2846#discussion_r12" + ] } }, "required": [ diff --git a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml index 72e71de8b8..9e3e0190f8 100644 --- a/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml +++ b/descriptions-next/ghec/dereferenced/ghec.2022-11-28.deref.yaml @@ -111,6 +111,8 @@ tags: description: Revoke compromised or leaked GitHub credentials. - name: projects description: Endpoints to manage Projects using the REST API. +- name: agent-tasks + description: Endpoints to manage and interact with agent tasks. servers: - url: https://api.github.com externalDocs: @@ -913,7 +915,7 @@ paths: - subscriptions_url - type - url - type: &438 + type: &437 type: string description: The type of credit the user is receiving. enum: @@ -1002,7 +1004,7 @@ paths: - cwe_id: CWE-400 name: Uncontrolled Resource Consumption epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 credits: - user: @@ -1079,7 +1081,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/global-advisories#get-a-global-security-advisory parameters: - - &742 + - &741 name: ghsa_id description: The GHSA (GitHub Security Advisory) identifier of the advisory. in: path @@ -1169,6 +1171,2521 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories + "/agents/repos/{owner}/{repo}/tasks": + get: + summary: List tasks for repository + description: Returns a list of tasks for a specific repository + tags: + - agent-tasks + operationId: agent-tasks/list-tasks-for-repo + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#list-tasks-for-repository + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + - name: creator_id + in: query + schema: + type: integer + description: Filter tasks by creator user ID + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="prev" (when current page > 1), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; + rel="next", ; + rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + post: + summary: Create a task + description: Creates a new task for a repository + tags: + - agent-tasks + operationId: agent-tasks/create-task + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#create-a-task + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + requestBody: + required: true + content: + application/json: + schema: + type: object + required: + - event_content + properties: + agent_id: + type: integer + format: int64 + description: Agent ID (optional, defaults to coding agent) + problem_statement: + type: string + description: Additional prompting for the agent + event_content: + type: string + description: User's written prompt + model: + type: string + description: Model identifier + custom_agent: + type: string + description: Custom agent identifier + create_pull_request: + type: boolean + description: Whether to create a PR + base_ref: + type: string + description: Base ref for new branch/PR + event_type: + type: string + description: Type of event + event_url: + type: string + description: URL of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + examples: + default: + value: + event_content: Fix the login button on the homepage + create_pull_request: true + base_ref: main + responses: + '201': + description: Task created successfully + content: + application/json: + schema: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: queued + session_count: 1 + artifacts: [] + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T00:00:00Z' + '400': + description: Problems parsing JSON + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/repos/{owner}/{repo}/tasks/{task_id}": + get: + summary: Get a task by repo + description: Returns a task by ID scoped to an owner/repo path + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-repo-and-id + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#get-a-task-by-repo + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: owner + in: path + required: true + schema: + type: string + description: The account owner of the repository. The name is not case sensitive. + - name: repo + in: path + required: true + schema: + type: string + description: The name of the repository. The name is not case sensitive. + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks": + get: + summary: List tasks + description: Returns a list of tasks for the authenticated user + tags: + - agent-tasks + operationId: agent-tasks/list-tasks + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#list-tasks + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: per_page + in: query + schema: + type: integer + default: 30 + minimum: 1 + maximum: 100 + description: The number of results per page (max 100). + - name: page + in: query + schema: + type: integer + default: 1 + minimum: 1 + description: The page number of the results to fetch. + - name: sort + in: query + schema: + type: string + default: updated_at + enum: + - updated_at + - created_at + description: The field to sort results by. Can be `updated_at` or `created_at`. + - name: direction + in: query + schema: + type: string + default: desc + enum: + - asc + - desc + description: The direction to sort results. Can be `asc` or `desc`. + - name: state + in: query + schema: + type: string + description: 'Comma-separated list of task states to filter by. Can be any + combination of: `queued`, `in_progress`, `completed`, `failed`, `idle`, + `waiting_for_user`, `timed_out`, `cancelled`.' + - name: is_archived + in: query + schema: + type: boolean + description: Filter by archived status. When `true`, returns only archived + tasks. When `false`, returns only non-archived tasks. + - name: since + in: query + schema: + type: string + format: date-time + description: Only show tasks updated at or after this time (ISO 8601 timestamp) + responses: + '200': + description: Tasks retrieved successfully + headers: + Link: + description: | + Pagination links. Contains rel="first" (always), + rel="next" (when more pages exist), and rel="last" (when on the final page). + schema: + type: string + example: ; rel="next", + ; rel="first" + content: + application/json: + schema: + type: object + required: + - tasks + properties: + tasks: + type: array + items: + type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its + most recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null + if not archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + description: List of tasks + total_active_count: + type: integer + format: int32 + description: Total count of active (non-archived) tasks + total_archived_count: + type: integer + format: int32 + description: Total count of archived tasks + examples: + default: + value: + tasks: + - id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + '400': + description: Bad request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + "/agents/tasks/{task_id}": + get: + summary: Get a task by ID + description: Returns a task by ID with its associated sessions + tags: + - agent-tasks + operationId: agent-tasks/get-task-by-id + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/agent-tasks/agent-tasks#get-a-task-by-id + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: agent-tasks + subcategory: agent-tasks + parameters: + - name: task_id + in: path + required: true + schema: + type: string + description: The unique identifier of the task. + responses: + '200': + description: Task retrieved successfully + content: + application/json: + schema: + allOf: + - type: object + required: + - id + - state + - created_at + properties: + id: + type: string + description: Unique task identifier + url: + type: string + description: API URL for this task + html_url: + type: string + description: Web URL for this task + name: + type: string + description: Human-readable name derived from the task prompt + creator: + oneOf: + - type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: The entity who created this task + creator_type: + type: string + description: Type of the task creator + enum: + - user + - organization + user_collaborators: + type: array + items: + type: object + description: A GitHub user + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + description: User objects of collaborators on this task + deprecated: true + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this task belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + state: + type: string + description: Current state of the task, derived from its most + recent session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + session_count: + type: integer + format: int32 + description: Number of sessions in this task + artifacts: + type: array + items: + type: object + description: A resource generated by the task + required: + - provider + - type + - data + properties: + provider: + type: string + enum: + - github + description: Provider namespace + type: + type: string + enum: + - github_resource + - branch + description: Discriminator for data shape + data: + oneOf: + - type: object + description: A GitHub resource (pull request, issue, + etc.) + properties: + id: + type: integer + format: int64 + description: GitHub resource ID + type: + type: string + description: Resource type (e.g., pull_request, + issue) + global_id: + type: string + description: GraphQL global ID + - type: object + description: A Git branch reference + properties: + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + description: Resource data (shape depends on type) + description: Resources created by this task (PRs, branches, + etc.) + archived_at: + type: + - string + - 'null' + format: date-time + description: Timestamp when the task was archived, null if not + archived + updated_at: + type: string + format: date-time + description: Timestamp of the most recent update + created_at: + type: string + format: date-time + description: Timestamp when the task was created + - type: object + properties: + sessions: + type: array + items: + type: object + description: Full session details within a task + required: + - id + - state + - created_at + properties: + id: + type: string + description: Session ID + name: + type: string + description: Session name + user: + description: The user who created this session + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + owner: + description: The owner of the repository + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the user + repository: + description: The repository this session belongs to + type: object + properties: + id: + type: integer + format: int64 + description: The unique identifier of the repository + agent_id: + type: integer + format: int64 + description: Agent ID + agent_task_id: + type: string + description: Agent internal task ID + task_id: + type: string + description: Task ID this session belongs to + state: + type: string + description: Current state of a session + enum: + - queued + - in_progress + - completed + - failed + - idle + - waiting_for_user + - timed_out + - cancelled + created_at: + type: string + format: date-time + description: Creation timestamp + updated_at: + type: string + format: date-time + description: Last update timestamp + completed_at: + type: string + format: date-time + description: Completion timestamp + event_type: + type: string + description: Type of event that triggered this session + event_url: + type: string + description: URL of the triggering event + event_content: + type: string + description: Content of the triggering event + event_identifiers: + type: array + items: + type: string + description: Identifiers for tracking + resource_type: + type: string + description: Type of resource associated with this session + resource_id: + type: integer + format: int64 + description: Resource ID + resource_number: + type: integer + format: int32 + description: Resource number (e.g., PR number) + resource_global_id: + type: string + description: GraphQL global ID of the resource + resource_state: + type: string + description: State of the associated resource + head_ref: + type: string + description: Head branch name + base_ref: + type: string + description: Base branch name + workflow_run_id: + type: integer + format: int64 + description: GitHub Actions workflow run ID + model: + type: string + description: Model used for this session + premium_requests: + type: number + format: double + description: Premium request count + error: + type: object + description: Error details for a failed session + properties: + message: + type: string + description: Error message + description: Sessions associated with this task + examples: + default: + value: + id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + url: https://api.github.com/agents/repos/octocat/hello-world/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + html_url: https://github.com/octocat/hello-world/copilot/tasks/a1b2c3d4-e5f6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + creator: + id: 1 + creator_type: user + owner: + id: 1 + repository: + id: 1296269 + state: completed + session_count: 1 + artifacts: + - provider: github + type: github_resource + data: + id: 42 + type: pull_request + archived_at: + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + sessions: + - id: s1a2b3c4-d5e6-7890-abcd-ef1234567890 + name: Fix the login button on the homepage + user: + id: 1 + owner: + id: 1 + repository: + id: 1296269 + task_id: a1b2c3d4-e5f6-7890-abcd-ef1234567890 + state: completed + created_at: '2025-01-01T00:00:00Z' + updated_at: '2025-01-01T01:00:00Z' + completed_at: '2025-01-01T01:00:00Z' + event_content: Fix the login button on the homepage + head_ref: copilot/fix-1 + base_ref: main + '400': + description: Problems parsing request + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '401': + description: Authentication required + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '403': + description: Insufficient permissions + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '404': + description: Resource not found + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation + '422': + description: Validation Failed + content: + application/json: + schema: + type: object + description: |- + Structured error response following GitHub REST API conventions. + For 422 Unprocessable Entity the errors array contains validation + details; for other error status codes only message and + documentation_url are returned. + required: + - message + - documentation_url + properties: + message: + type: string + description: Summary message (e.g. "Validation Failed", "Not Found") + errors: + type: array + items: + type: object + description: A single validation error + required: + - code + properties: + code: + type: string + enum: + - missing + - missing_field + - invalid + - already_exists + - unprocessable + - custom + description: Machine-readable error code + message: + type: string + description: Human-readable message (populated when code + is "custom") + description: List of validation errors (present only for 422 responses) + documentation_url: + type: string + description: URL to relevant API documentation "/app": get: summary: Get the authenticated app @@ -1664,7 +4181,7 @@ paths: schema: type: integer default: 30 - - &345 + - &344 name: cursor description: 'Used for pagination: the starting delivery from which the page of deliveries is fetched. Refer to the `link` header for the next and previous @@ -1673,7 +4190,7 @@ paths: required: false schema: type: string - - &346 + - &345 name: status description: Returns webhook deliveries filtered by delivery outcome classification based on `status_code` range. A `status` of `success` returns deliveries @@ -1693,7 +4210,7 @@ paths: application/json: schema: type: array - items: &347 + items: &346 title: Simple webhook delivery description: Delivery made by a webhook, without request and response information. @@ -1789,7 +4306,7 @@ paths: - installation_id - repository_id examples: - default: &348 + default: &347 value: - id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -1821,7 +4338,7 @@ paths: application/json: schema: *3 application/scim+json: - schema: &752 + schema: &751 title: Scim Error description: Scim Error type: object @@ -1924,7 +4441,7 @@ paths: description: Response content: application/json: - schema: &349 + schema: &348 title: Webhook delivery description: Delivery made by a webhook. type: object @@ -2059,7 +4576,7 @@ paths: - request - response examples: - default: &350 + default: &349 value: id: 12345678 guid: 0b989ba4-242f-11e5-81e1-c7b6966d2516 @@ -9349,7 +11866,7 @@ paths: - all - local_only - selected - selected_actions_url: &266 + selected_actions_url: &265 type: string description: The API URL to use to get or set the actions and reusable workflows that are allowed to run, when `allowed_actions` @@ -9429,7 +11946,7 @@ paths: description: Successfully retrieved the artifact and log retention settings content: application/json: - schema: &268 + schema: &267 type: object properties: days: @@ -9447,7 +11964,7 @@ paths: value: days: 90 maximum_allowed_days: 365 - '401': &753 + '401': &752 description: Authorization failure '404': *6 x-github: @@ -9475,7 +11992,7 @@ paths: required: true content: application/json: - schema: &269 + schema: &268 type: object properties: days: @@ -9524,7 +12041,7 @@ paths: required: - approval_policy examples: - default: &270 + default: &269 value: approval_policy: first_time_contributors '404': *6 @@ -9582,7 +12099,7 @@ paths: description: Response content: application/json: - schema: &271 + schema: &270 type: object required: - run_workflows_from_fork_pull_requests @@ -9636,7 +12153,7 @@ paths: required: true content: application/json: - schema: &272 + schema: &271 type: object required: - run_workflows_from_fork_pull_requests @@ -10072,7 +12589,7 @@ paths: description: Success response content: application/json: - schema: &275 + schema: &274 type: object properties: default_workflow_permissions: &67 @@ -10120,7 +12637,7 @@ paths: required: true content: application/json: - schema: &276 + schema: &275 type: object properties: default_workflow_permissions: *67 @@ -10965,7 +13482,7 @@ paths: application/json: schema: type: array - items: &280 + items: &279 title: Runner Application description: Runner Application type: object @@ -10990,7 +13507,7 @@ paths: - download_url - filename examples: - default: &281 + default: &280 value: - os: osx architecture: x64 @@ -11074,7 +13591,7 @@ paths: - no-gpu work_folder: _work responses: - '201': &282 + '201': &281 description: Response content: application/json: @@ -11193,7 +13710,7 @@ paths: - token - expires_at examples: - default: &283 + default: &282 value: token: LLBF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-22T12:13:35.123-08:00' @@ -11233,7 +13750,7 @@ paths: application/json: schema: *79 examples: - default: &284 + default: &283 value: token: AABF3JGZDX3P5PMEXLND6TS6FCWO6 expires_at: '2020-01-29T12:13:35.123-08:00' @@ -11265,7 +13782,7 @@ paths: application/json: schema: *76 examples: - default: &285 + default: &284 value: id: 23 name: MBP @@ -11481,7 +13998,7 @@ paths: - *39 - *75 responses: - '200': &286 + '200': &285 description: Response content: application/json: @@ -11537,7 +14054,7 @@ paths: parameters: - *39 - *75 - - &287 + - &286 name: name description: The name of a self-hosted runner's custom label. in: path @@ -11634,7 +14151,7 @@ paths: required: true content: application/json: - schema: &294 + schema: &293 title: Enterprise Announcement description: Enterprise global announcement type: object @@ -12285,7 +14802,7 @@ paths: required: false schema: type: string - - &297 + - &296 name: include description: |- The event types to include: @@ -12303,7 +14820,7 @@ paths: - web - git - all - - &298 + - &297 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. @@ -12311,7 +14828,7 @@ paths: required: false schema: type: string - - &299 + - &298 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. @@ -12319,7 +14836,7 @@ paths: required: false schema: type: string - - &300 + - &299 name: order description: |- The order of audit log events. To list newest events first, specify `desc`. To list oldest events first, specify `asc`. @@ -12341,7 +14858,7 @@ paths: application/json: schema: type: array - items: &301 + items: &300 type: object properties: "@timestamp": @@ -12463,7 +14980,7 @@ paths: description: The repository visibility, for example `public` or `private`. examples: - default: &302 + default: &301 value: - "@timestamp": 1606929874512 action: team.add_member @@ -13131,7 +15648,7 @@ paths: application/json: schema: type: array - items: &303 + items: &302 title: Push rule bypass request description: A bypass request made by a user asking to be exempted from a push rule in this repository. @@ -13303,7 +15820,7 @@ paths: examples: - https://github.com/octo-org/smile/exemptions/1 examples: - default: &304 + default: &303 value: - id: 21 number: 42 @@ -13408,7 +15925,7 @@ paths: application/json: schema: type: array - items: &306 + items: &305 title: Secret scanning bypass request description: A bypass request made by a user asking to be exempted from push protection in this repository. @@ -13539,7 +16056,7 @@ paths: examples: - https://github.com/octo-org/smile/exemptions/1 examples: - default: &307 + default: &306 value: - id: 21 number: 42 @@ -13624,7 +16141,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-enterprise parameters: - *39 - - &312 + - &311 name: tool_name description: The name of a code scanning tool. Only results by this tool will be listed. You can specify the tool by using either `tool_name` or `tool_guid`, @@ -13634,7 +16151,7 @@ paths: schema: &111 type: string description: The name of the tool used to generate the code scanning analysis. - - &313 + - &312 name: tool_guid description: The GUID of a code scanning tool. Only results by this tool will be listed. Note that some code scanning tools may not include a GUID in @@ -13658,7 +16175,7 @@ paths: be returned. in: query required: false - schema: &314 + schema: &313 type: string description: State of a code scanning alert. enum: @@ -13691,7 +16208,7 @@ paths: application/json: schema: type: array - items: &315 + items: &314 type: object properties: number: &126 @@ -13720,7 +16237,7 @@ paths: description: The GitHub URL of the alert resource. format: uri readOnly: true - instances_url: &527 + instances_url: &526 type: string description: The REST API URL for fetching the list of instances for an alert. @@ -13756,7 +16273,7 @@ paths: format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissed_reason: &528 + dismissed_reason: &527 type: - string - 'null' @@ -13767,14 +16284,14 @@ paths: - won't fix - used in tests - - dismissed_comment: &529 + dismissed_comment: &528 type: - string - 'null' description: The dismissal comment associated with the dismissal of the alert. maxLength: 280 - rule: &530 + rule: &529 type: object properties: id: @@ -13835,7 +16352,7 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: &531 + tool: &530 type: object properties: name: *111 @@ -13846,26 +16363,26 @@ paths: description: The version of the tool used to generate the code scanning analysis. guid: *112 - most_recent_instance: &532 + most_recent_instance: &531 type: object properties: - ref: &525 + ref: &524 type: string description: |- The Git reference, formatted as `refs/pull//merge`, `refs/pull//head`, `refs/heads/` or simply ``. - analysis_key: &542 + analysis_key: &541 type: string description: Identifies the configuration under which the analysis was executed. For example, in GitHub Actions this includes the workflow filename and job name. - environment: &543 + environment: &542 type: string description: Identifies the variable values associated with the environment in which the analysis that generated this alert instance was performed, such as the language that was analyzed. - category: &544 + category: &543 type: string description: Identifies the configuration under which the analysis was executed. Used to distinguish between multiple @@ -13885,7 +16402,7 @@ paths: with placeholder links for related locations replaced by links to the relevant code. Only populated when related locations are available for the alert instance. - location: &545 + location: &544 type: object description: Describe a region within a file for the alert. properties: @@ -13906,7 +16423,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: &546 + items: &545 type: - string - 'null' @@ -14262,7 +16779,7 @@ paths: - most_recent_instance - repository examples: - default: &316 + default: &315 value: - number: 4 created_at: '2020-02-13T12:29:18Z' @@ -15150,7 +17667,7 @@ paths: description: Response content: application/json: - schema: &318 + schema: &317 type: array description: A list of default code security configurations items: @@ -15166,7 +17683,7 @@ paths: default configuration: *114 examples: - default: &319 + default: &318 value: - default_for_new_repos: public configuration: @@ -15629,7 +18146,7 @@ paths: default: value: default_for_new_repos: all - configuration: &317 + configuration: &316 value: id: 1325 target_type: organization @@ -15714,7 +18231,7 @@ paths: application/json: schema: type: array - items: &320 + items: &319 type: object description: Repositories associated with a code security configuration and attachment status @@ -15738,7 +18255,7 @@ paths: summary: Example of code security configuration repositories value: - status: attached - repository: &321 + repository: &320 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -16239,7 +18756,7 @@ paths: description: The team through which the assignee is granted access to GitHub Copilot, if applicable. oneOf: - - &308 + - &307 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -16316,7 +18833,7 @@ paths: parent: anyOf: - type: 'null' - - &385 + - &384 title: Team Simple description: Groups of organization members that gives permissions on specified repositories. @@ -17094,7 +19611,7 @@ paths: '401': *23 '403': *27 '404': *6 - '413': &324 + '413': &323 description: Payload Too Large content: application/json: @@ -18173,7 +20690,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-an-enterprise parameters: - *39 - - &329 + - &328 name: state in: query description: |- @@ -18182,7 +20699,7 @@ paths: Can be: `auto_dismissed`, `dismissed`, `fixed`, `open` schema: type: string - - &330 + - &329 name: severity in: query description: |- @@ -18191,7 +20708,7 @@ paths: Can be: `low`, `medium`, `high`, `critical` schema: type: string - - &331 + - &330 name: ecosystem in: query description: |- @@ -18200,14 +20717,14 @@ paths: Can be: `composer`, `go`, `maven`, `npm`, `nuget`, `pip`, `pub`, `rubygems`, `rust` schema: type: string - - &332 + - &331 name: package in: query description: A comma-separated list of package names. If specified, only alerts for these packages will be returned. schema: type: string - - &333 + - &332 name: epss_percentage in: query description: |- @@ -18219,7 +20736,7 @@ paths: Filters the list of alerts based on EPSS percentages. If specified, only alerts with the provided EPSS percentages will be returned. schema: type: string - - &583 + - &582 name: has in: query description: |- @@ -18233,7 +20750,7 @@ paths: type: string enum: - patch - - &334 + - &333 name: assignee in: query description: |- @@ -18242,7 +20759,7 @@ paths: Use `*` to list alerts with at least one assignee or `none` to list alerts with no assignees. schema: type: string - - &335 + - &334 name: scope in: query description: The scope of the vulnerable dependency. If specified, only alerts @@ -18252,7 +20769,7 @@ paths: enum: - development - runtime - - &336 + - &335 name: sort in: query description: |- @@ -18278,7 +20795,7 @@ paths: application/json: schema: type: array - items: &337 + items: &336 type: object description: A Dependabot alert. properties: @@ -18344,8 +20861,9 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: &584 + security_advisory: &583 type: object description: Details for the GitHub Security Advisory. readOnly: true @@ -18581,7 +21099,7 @@ paths: dismissal. maxLength: 280 fixed_at: *136 - auto_dismissed_at: &585 + auto_dismissed_at: &584 type: - string - 'null' @@ -18589,7 +21107,7 @@ paths: ISO 8601 format: `YYYY-MM-DDTHH:MM:SSZ`.' format: date-time readOnly: true - dismissal_request: &586 + dismissal_request: &585 title: Dependabot alert dismissal request description: Information about an active dismissal request for this Dependabot alert. @@ -18652,7 +21170,7 @@ paths: - repository additionalProperties: false examples: - default: &338 + default: &337 value: - number: 2 state: dismissed @@ -18701,7 +21219,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -19629,7 +22147,7 @@ paths: application/json: schema: *20 examples: - default: &362 + default: &361 value: id: 1 account: @@ -19890,7 +22408,7 @@ paths: - name - created_on examples: - default: &442 + default: &441 value: total_count: 2 network_configurations: @@ -19954,6 +22472,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -20060,6 +22591,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -20115,7 +22659,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/network-configurations#get-a-hosted-compute-network-settings-resource-for-an-enterprise parameters: - *39 - - &443 + - &442 name: network_settings_id description: Unique identifier of the hosted compute network settings. in: path @@ -20127,7 +22671,7 @@ paths: description: Response content: application/json: - schema: &444 + schema: &443 title: Hosted compute network settings resource description: A hosted compute network settings resource. type: object @@ -20166,7 +22710,7 @@ paths: - subnet_id - region examples: - default: &445 + default: &444 value: id: 220F78DACB92BBFBC5E6F22DE1CCF52309D network_configuration_id: 934E208B3EE0BD60CF5F752C426BFB53562 @@ -21019,7 +23563,7 @@ paths: required: true content: application/json: - schema: &416 + schema: &415 title: Custom Property Set Payload description: Custom property set payload type: object @@ -22221,7 +24765,7 @@ paths: conditions: anyOf: - *158 - - &420 + - &419 title: Organization ruleset conditions type: object description: |- @@ -22271,7 +24815,7 @@ paths: - object rules: type: array - items: &708 + items: &707 title: Repository Rule type: object description: A repository rule. @@ -22280,7 +24824,7 @@ paths: - *167 - *168 - *169 - - &706 + - &705 title: merge_queue description: Merges must be performed via a merge queue. type: object @@ -22608,7 +25152,7 @@ paths: type: string format: date-time examples: - default: &423 + default: &422 value: - version_id: 3 actor: @@ -22661,7 +25205,7 @@ paths: description: Response content: application/json: - schema: &424 + schema: &423 allOf: - *191 - type: object @@ -22716,7 +25260,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-enterprise parameters: - *39 - - &425 + - &424 name: state in: query description: Set to `open` or `resolved` to only list secret scanning alerts @@ -22727,7 +25271,7 @@ paths: enum: - open - resolved - - &426 + - &425 name: secret_type in: query description: A comma-separated list of secret types to return. All default @@ -22737,7 +25281,7 @@ paths: required: false schema: type: string - - &427 + - &426 name: resolution in: query description: A comma-separated list of resolutions. Only secret scanning alerts @@ -22746,7 +25290,7 @@ paths: required: false schema: type: string - - &428 + - &427 name: assignee in: query description: Filters alerts by assignee. Use `*` to get all assigned alerts, @@ -22765,7 +25309,7 @@ paths: all-unassigned: value: none summary: Filter for all unassigned alerts - - &429 + - &428 name: sort description: The property to sort the results by. `created` means when the alert was created. `updated` means when the alert was updated or resolved. @@ -22781,7 +25325,7 @@ paths: - *17 - *108 - *109 - - &430 + - &429 name: validity in: query description: A comma-separated list of validities that, when present, will @@ -22790,7 +25334,7 @@ paths: required: false schema: type: string - - &431 + - &430 name: is_publicly_leaked in: query description: A boolean value representing whether or not to filter alerts @@ -22799,7 +25343,7 @@ paths: schema: type: boolean default: false - - &432 + - &431 name: is_multi_repo in: query description: A boolean value representing whether or not to filter alerts @@ -22808,7 +25352,7 @@ paths: schema: type: boolean default: false - - &433 + - &432 name: hide_secret in: query description: A boolean value representing whether or not to hide literal secrets @@ -22824,7 +25368,7 @@ paths: application/json: schema: type: array - items: &434 + items: &433 type: object properties: number: *126 @@ -22840,14 +25384,14 @@ paths: format: uri description: The REST API URL of the code locations for this alert. - state: &720 + state: &719 description: Sets the state of the secret scanning alert. You must provide `resolution` when you set the state to `resolved`. type: string enum: - open - resolved - resolution: &721 + resolution: &720 type: - string - 'null' @@ -22954,14 +25498,14 @@ paths: first_location_detected: anyOf: - type: 'null' - - &722 + - &721 description: 'Details on the location where the token was initially detected. This can be a commit, wiki commit, issue, discussion, pull request. ' oneOf: - - &724 + - &723 description: Represents a 'commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository. @@ -23008,6 +25552,13 @@ paths: type: string description: The API URL to get the associated commit resource + html_url: + type: string + format: uri + description: The GitHub URL to get the associated commit + resource. + examples: + - https://github.com/octocat/Hello-World/blob/af5626b/example/secrets.txt#L1-L1 required: - path - start_line @@ -23018,7 +25569,7 @@ paths: - blob_url - commit_sha - commit_url - - &725 + - &724 description: Represents a 'wiki_commit' secret scanning location type. This location type shows that a secret was detected inside a commit to a repository wiki. @@ -23079,7 +25630,7 @@ paths: - page_url - commit_sha - commit_url - - &726 + - &725 description: Represents an 'issue_title' secret scanning location type. This location type shows that a secret was detected in the title of an issue. @@ -23092,9 +25643,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_title_url - - &727 + - &726 description: Represents an 'issue_body' secret scanning location type. This location type shows that a secret was detected in the body of an issue. @@ -23107,9 +25665,16 @@ paths: secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/1347 + html_url: + type: string + format: uri + description: The GitHub URL for the issue where the + secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1 required: - issue_body_url - - &728 + - &727 description: Represents an 'issue_comment' secret scanning location type. This location type shows that a secret was detected in a comment on an issue. @@ -23122,9 +25687,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the issue comment where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/issues/1#issuecomment-1081119451 required: - issue_comment_url - - &729 + - &728 description: Represents a 'discussion_title' secret scanning location type. This location type shows that a secret was detected in the title of a discussion. @@ -23139,7 +25711,7 @@ paths: - https://github.com/community/community/discussions/39082 required: - discussion_title_url - - &730 + - &729 description: Represents a 'discussion_body' secret scanning location type. This location type shows that a secret was detected in the body of a discussion. @@ -23154,7 +25726,7 @@ paths: - https://github.com/community/community/discussions/39082#discussion-4566270 required: - discussion_body_url - - &731 + - &730 description: Represents a 'discussion_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a discussion. @@ -23169,7 +25741,7 @@ paths: - https://github.com/community/community/discussions/39082#discussioncomment-4158232 required: - discussion_comment_url - - &732 + - &731 description: Represents a 'pull_request_title' secret scanning location type. This location type shows that a secret was detected in the title of a pull request. @@ -23182,9 +25754,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_title_url - - &733 + - &732 description: Represents a 'pull_request_body' secret scanning location type. This location type shows that a secret was detected in the body of a pull request. @@ -23197,9 +25776,16 @@ paths: the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request where + the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846 required: - pull_request_body_url - - &734 + - &733 description: Represents a 'pull_request_comment' secret scanning location type. This location type shows that a secret was detected in a comment on a pull request. @@ -23212,9 +25798,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/issues/comments/1081119451 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request comment + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#issuecomment-1081119451 required: - pull_request_comment_url - - &735 + - &734 description: Represents a 'pull_request_review' secret scanning location type. This location type shows that a secret was detected in a review on a pull request. @@ -23227,9 +25820,16 @@ paths: where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/2846/reviews/80 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#pullrequestreview-80 required: - pull_request_review_url - - &736 + - &735 description: Represents a 'pull_request_review_comment' secret scanning location type. This location type shows that a secret was detected in a review comment on a pull @@ -23243,6 +25843,13 @@ paths: comment where the secret was detected. examples: - https://api.github.com/repos/octocat/Hello-World/pulls/comments/12 + html_url: + type: string + format: uri + description: The GitHub URL for the pull request review + comment where the secret was detected. + examples: + - https://github.com/octocat/Hello-World/pull/2846#discussion_r12 required: - pull_request_review_comment_url has_more_locations: @@ -23254,7 +25861,7 @@ paths: - type: 'null' - *4 examples: - default: &435 + default: &434 value: - number: 2 created_at: '2020-11-06T18:48:51Z' @@ -23463,7 +26070,7 @@ paths: description: Response content: application/json: - schema: &436 + schema: &435 title: Secret scanning pattern configuration description: A collection of secret scanning patterns and their settings related to push protection. @@ -23550,7 +26157,7 @@ paths: description: Overrides for custom patterns defined by the organization. items: *193 examples: - default: &437 + default: &436 value: pattern_config_version: 0ujsswThIGTUYm2K8FjOOfXtY1K provider_pattern_overrides: @@ -23686,7 +26293,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/licensing#get-github-advanced-security-active-committers-for-an-enterprise parameters: - *39 - - &439 + - &438 name: advanced_security_product in: query description: | @@ -23706,7 +26313,7 @@ paths: description: Success content: application/json: - schema: &440 + schema: &439 type: object properties: total_advanced_security_committers: @@ -23769,7 +26376,7 @@ paths: required: - repositories examples: - default: &441 + default: &440 value: total_advanced_security_committers: 2 total_count: 2 @@ -26929,7 +29536,7 @@ paths: properties: action: type: string - discussion: &857 + discussion: &856 title: Discussion description: A Discussion in a repository. type: object @@ -27430,7 +30037,7 @@ paths: milestone: anyOf: - type: 'null' - - &406 + - &405 title: Milestone description: A collection of related issues and pull requests. @@ -27602,7 +30209,7 @@ paths: timeline_url: type: string format: uri - type: &372 + type: &371 title: Issue Type description: The type of issue. type: @@ -27713,7 +30320,7 @@ paths: - hooray - eyes - rocket - sub_issues_summary: &780 + sub_issues_summary: &779 title: Sub-issues Summary type: object properties: @@ -27797,7 +30404,7 @@ paths: pin: anyOf: - type: 'null' - - &665 + - &664 title: Pinned Issue Comment description: Context around who pinned an issue comment and when it was pinned. @@ -27824,7 +30431,7 @@ paths: - url - created_at - updated_at - issue_dependencies_summary: &781 + issue_dependencies_summary: &780 title: Issue Dependencies Summary type: object properties: @@ -27843,7 +30450,7 @@ paths: - total_blocking issue_field_values: type: array - items: &650 + items: &649 title: Issue Field Value description: A value assigned to an issue field type: object @@ -28624,7 +31231,7 @@ paths: type: string release: allOf: - - &699 + - &698 title: Release description: A release. type: object @@ -28706,7 +31313,7 @@ paths: author: *4 assets: type: array - items: &700 + items: &699 title: Release Asset description: Data related to a release. type: object @@ -29297,7 +31904,7 @@ paths: url: type: string format: uri - user: &787 + user: &786 title: Public User description: Public User type: object @@ -31194,7 +33801,7 @@ paths: - closed - all default: open - - &375 + - &374 name: labels description: 'A list of comma separated label names. Example: `bug,ui,@high`' in: query @@ -31245,7 +33852,7 @@ paths: type: array items: *219 examples: - default: &376 + default: &375 value: - id: 1 node_id: MDU6SXNzdWUx @@ -32657,14 +35264,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-public-events-for-a-network-of-repositories parameters: - - &454 + - &453 name: owner description: The account owner of the repository. The name is not case sensitive. in: path required: true schema: type: string - - &455 + - &454 name: repo description: The name of the repository without the `.git` extension. The name is not case sensitive. @@ -32726,7 +35333,7 @@ paths: '404': *6 '403': *27 '304': *35 - '301': &460 + '301': &459 description: Moved permanently content: application/json: @@ -32748,7 +35355,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#list-notifications-for-the-authenticated-user parameters: - - &673 + - &672 name: all description: If `true`, show notifications marked as read. in: query @@ -32756,7 +35363,7 @@ paths: schema: type: boolean default: false - - &674 + - &673 name: participating description: If `true`, only shows notifications in which the user is directly participating or mentioned. @@ -32766,7 +35373,7 @@ paths: type: boolean default: false - *224 - - &675 + - &674 name: before description: 'Only show notifications updated before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: @@ -32798,7 +35405,7 @@ paths: properties: id: type: string - repository: &279 + repository: &278 title: Minimal Repository description: Minimal Repository type: object @@ -33148,7 +35755,7 @@ paths: type: boolean examples: - false - security_and_analysis: &417 + security_and_analysis: &416 type: - object - 'null' @@ -33360,7 +35967,7 @@ paths: - url - subscription_url examples: - default: &676 + default: &675 value: - id: '1' repository: @@ -33965,7 +36572,7 @@ paths: - 3 custom_roles: type: array - items: &325 + items: &324 title: Organization Custom Repository Role description: Custom repository roles created by organization owners @@ -34014,7 +36621,7 @@ paths: - created_at - updated_at examples: - default: &326 + default: &325 value: id: 8030 name: Security Engineer @@ -34489,7 +37096,7 @@ paths: type: array items: *152 examples: - default: &682 + default: &681 value: - property_name: environment value: production @@ -34539,7 +37146,7 @@ paths: required: - properties examples: - default: &683 + default: &682 value: properties: - property_name: environment @@ -35430,7 +38037,7 @@ paths: type: integer repository_cache_usages: type: array - items: &467 + items: &466 title: Actions Cache Usage by repository description: GitHub Actions Cache Usage by repository. type: object @@ -36227,7 +38834,7 @@ paths: description: A JSON serialized template for OIDC subject claim customization content: application/json: - schema: &264 + schema: title: Actions OIDC Subject customization description: Actions OIDC Subject customization type: object @@ -36241,7 +38848,7 @@ paths: required: - include_claim_keys examples: - default: &265 + default: &264 value: include_claim_keys: - repo @@ -36268,15 +38875,25 @@ paths: required: true content: application/json: - schema: *264 + schema: + title: Actions OIDC Subject customization + description: Actions OIDC Subject customization + type: object + properties: + include_claim_keys: + description: Array of unique strings. Each claim key can only contain + alphanumeric characters and underscores. + type: array + items: + type: string examples: - default: *265 + default: *264 responses: '201': description: Empty response content: application/json: - schema: &290 + schema: &289 title: Empty Object description: An object without any properties. type: object @@ -36315,7 +38932,7 @@ paths: schema: type: object properties: - enabled_repositories: &267 + enabled_repositories: &266 type: string description: The policy that controls the repositories in the organization that are allowed to run GitHub Actions. @@ -36329,7 +38946,7 @@ paths: that are allowed to run GitHub Actions, when `enabled_repositories` is set to `selected`. allowed_actions: *60 - selected_actions_url: *266 + selected_actions_url: *265 sha_pinning_required: *61 required: - enabled_repositories @@ -36371,7 +38988,7 @@ paths: schema: type: object properties: - enabled_repositories: *267 + enabled_repositories: *266 allowed_actions: *60 sha_pinning_required: *61 required: @@ -36407,7 +39024,7 @@ paths: description: Response content: application/json: - schema: *268 + schema: *267 examples: response: summary: Example response @@ -36438,7 +39055,7 @@ paths: required: true content: application/json: - schema: *269 + schema: *268 examples: application/json: value: @@ -36476,7 +39093,7 @@ paths: application/json: schema: *62 examples: - default: *270 + default: *269 '404': *6 x-github: enabledForGitHubApps: true @@ -36533,7 +39150,7 @@ paths: description: Response content: application/json: - schema: *271 + schema: *270 examples: default: *63 '403': *27 @@ -36558,7 +39175,7 @@ paths: required: true content: application/json: - schema: *272 + schema: *271 examples: default: *63 responses: @@ -36610,7 +39227,7 @@ paths: type: array items: *78 examples: - default: &274 + default: &273 value: total_count: 1 repositories: @@ -36795,7 +39412,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#enable-a-selected-repository-for-github-actions-in-an-organization parameters: - *87 - - &273 + - &272 name: repository_id description: The unique identifier of the repository. in: path @@ -36824,7 +39441,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#disable-a-selected-repository-for-github-actions-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: Response @@ -37020,7 +39637,7 @@ paths: type: array items: *78 examples: - default: *274 + default: *273 '403': *27 '404': *6 x-github: @@ -37089,7 +39706,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#add-a-repository-to-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: No content @@ -37116,7 +39733,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#remove-a-repository-from-the-list-of-repositories-allowed-to-use-self-hosted-runners-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: No content @@ -37150,7 +39767,7 @@ paths: description: Response content: application/json: - schema: *275 + schema: *274 examples: default: *69 x-github: @@ -37184,7 +39801,7 @@ paths: required: false content: application/json: - schema: *276 + schema: *275 examples: default: *69 x-github: @@ -37231,7 +39848,7 @@ paths: type: number runner_groups: type: array - items: &277 + items: &276 type: object properties: id: @@ -37421,9 +40038,9 @@ paths: description: Response content: application/json: - schema: *277 + schema: *276 examples: - default: &278 + default: &277 value: id: 2 name: octo-runner-group @@ -37465,7 +40082,7 @@ paths: description: Response content: application/json: - schema: *277 + schema: *276 examples: default: value: @@ -37558,9 +40175,9 @@ paths: description: Response content: application/json: - schema: *277 + schema: *276 examples: - default: *278 + default: *277 x-github: enabledForGitHubApps: true githubCloudOnly: false @@ -37665,9 +40282,9 @@ paths: type: number repositories: type: array - items: *279 + items: *278 examples: - default: &323 + default: &322 value: total_count: 1 repositories: @@ -37966,7 +40583,7 @@ paths: parameters: - *87 - *72 - - *273 + - *272 responses: '204': description: Response @@ -37990,7 +40607,7 @@ paths: parameters: - *87 - *72 - - *273 + - *272 responses: '204': description: Response @@ -38208,9 +40825,9 @@ paths: application/json: schema: type: array - items: *280 + items: *279 examples: - default: *281 + default: *280 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -38275,7 +40892,7 @@ paths: - no-gpu work_folder: _work responses: - '201': *282 + '201': *281 '404': *6 '422': *7 '409': *119 @@ -38314,7 +40931,7 @@ paths: application/json: schema: *79 examples: - default: *283 + default: *282 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -38350,7 +40967,7 @@ paths: application/json: schema: *79 examples: - default: *284 + default: *283 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -38381,7 +40998,7 @@ paths: application/json: schema: *76 examples: - default: *285 + default: *284 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -38556,7 +41173,7 @@ paths: - *87 - *75 responses: - '200': *286 + '200': *285 '404': *6 x-github: githubCloudOnly: false @@ -38585,7 +41202,7 @@ paths: parameters: - *87 - *75 - - *287 + - *286 responses: '200': *81 '404': *6 @@ -38630,7 +41247,7 @@ paths: type: integer secrets: type: array - items: &288 + items: &287 title: Actions Secret for an Organization description: Secrets for GitHub Actions for an organization. type: object @@ -38711,7 +41328,7 @@ paths: description: Response content: application/json: - schema: &487 + schema: &486 title: ActionsPublicKey description: The public key used for setting Actions Secrets. type: object @@ -38746,7 +41363,7 @@ paths: - key_id - key examples: - default: &488 + default: &487 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -38772,7 +41389,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-organization-secret parameters: - *87 - - &289 + - &288 name: secret_name description: The name of the secret. in: path @@ -38784,7 +41401,7 @@ paths: description: Response content: application/json: - schema: *288 + schema: *287 examples: default: value: @@ -38815,7 +41432,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-an-organization-secret parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -38872,7 +41489,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -38899,7 +41516,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-an-organization-secret parameters: - *87 - - *289 + - *288 responses: '204': description: Response @@ -38926,7 +41543,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-selected-repositories-for-an-organization-secret parameters: - *87 - - *289 + - *288 - *19 - *17 responses: @@ -38944,9 +41561,9 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 examples: - default: &293 + default: &292 value: total_count: 1 repositories: @@ -39039,7 +41656,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#set-selected-repositories-for-an-organization-secret parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -39092,7 +41709,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#add-selected-repository-to-an-organization-secret parameters: - *87 - - *289 + - *288 - name: repository_id in: path required: true @@ -39126,7 +41743,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#remove-selected-repository-from-an-organization-secret parameters: - *87 - - *289 + - *288 - name: repository_id in: path required: true @@ -39159,7 +41776,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-organization-variables parameters: - *87 - - &472 + - &471 name: per_page description: The number of results per page (max 30). For more information, see "[Using pagination in the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/using-pagination-in-the-rest-api)." @@ -39183,7 +41800,7 @@ paths: type: integer variables: type: array - items: &291 + items: &290 title: Actions Variable for an Organization description: Organization variable for GitHub Actions. type: object @@ -39321,7 +41938,7 @@ paths: description: Response when creating a variable content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -39347,7 +41964,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-an-organization-variable parameters: - *87 - - &292 + - &291 name: name description: The name of the variable. in: path @@ -39359,7 +41976,7 @@ paths: description: Response content: application/json: - schema: *291 + schema: *290 examples: default: value: @@ -39390,7 +42007,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-an-organization-variable parameters: - *87 - - *292 + - *291 requestBody: required: true content: @@ -39453,7 +42070,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-an-organization-variable parameters: - *87 - - *292 + - *291 responses: '204': description: Response @@ -39480,7 +42097,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-selected-repositories-for-an-organization-variable parameters: - *87 - - *292 + - *291 - *19 - *17 responses: @@ -39498,9 +42115,9 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 examples: - default: *293 + default: *292 '409': description: Response when the visibility of the variable is not set to `selected` @@ -39527,7 +42144,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#set-selected-repositories-for-an-organization-variable parameters: - *87 - - *292 + - *291 requestBody: required: true content: @@ -39577,7 +42194,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#add-selected-repository-to-an-organization-variable parameters: - *87 - - *292 + - *291 - name: repository_id in: path required: true @@ -39612,7 +42229,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#remove-selected-repository-from-an-organization-variable parameters: - *87 - - *292 + - *291 - name: repository_id in: path required: true @@ -39670,7 +42287,7 @@ paths: required: true content: application/json: - schema: *294 + schema: *293 examples: default: *85 parameters: @@ -39819,6 +42436,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created or updated + record in the response body. + + ' required: - name - digest @@ -39850,7 +42474,7 @@ paths: type: integer deployment_records: type: array - items: &295 + items: &294 title: Artifact Deployment Record description: Artifact Metadata Deployment Record type: object @@ -39894,8 +42518,10 @@ paths: - 'null' description: The ID of the provenance attestation associated with the deployment record. + required: + - total_count examples: - default: &296 + default: &295 value: total_count: 1 deployment_records: @@ -40039,6 +42665,13 @@ paths: - name - deployment_name - digest + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the set records + in the response body + + ' required: - logical_environment - deployments @@ -40070,10 +42703,25 @@ paths: type: integer deployment_records: type: array - items: *295 + items: *294 + required: + - total_count examples: - default: *296 - '403': *27 + default: *295 + '403': + description: Forbidden + content: + application/json: + schema: *3 + examples: + insufficient_repo_permissions: + value: + message: + cause: artifact metadata write permission required on one or + more repositories + repositories: + - 123 + - 345 '404': *6 x-github: githubCloudOnly: false @@ -40175,6 +42823,13 @@ paths: pattern: "^[A-Za-z0-9.\\-_]+$" examples: - my-github-repo + return_records: + type: boolean + default: true + description: 'If true, the endpoint will return the created record + in the response body. + + ' required: - name - digest @@ -40228,6 +42883,8 @@ paths: type: string updated_at: type: string + required: + - total_count examples: default: value: @@ -40286,9 +42943,9 @@ paths: - 3 deployment_records: type: array - items: *295 + items: *294 examples: - default: *296 + default: *295 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -40418,12 +43075,12 @@ paths: required: - subject_digests examples: - default: &818 + default: &817 value: subject_digests: - sha256:abc123 - sha512:def456 - withPredicateType: &819 + withPredicateType: &818 value: subject_digests: - sha256:abc123 @@ -40482,7 +43139,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: &820 + default: &819 value: attestations_subject_digests: - sha256:abc: @@ -40833,7 +43490,7 @@ paths: initiator: type: string examples: - default: &501 + default: &500 value: attestations: - bundle: @@ -40959,10 +43616,10 @@ paths: required: false schema: type: string + - *296 - *297 - *298 - *299 - - *300 - *17 responses: '200': @@ -40971,9 +43628,9 @@ paths: application/json: schema: type: array - items: *301 + items: *300 examples: - default: *302 + default: *301 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -41096,7 +43753,7 @@ paths: subcategory: bypass-requests parameters: - *87 - - &305 + - &304 name: repository_name description: The name of the repository to filter on. in: query @@ -41115,9 +43772,9 @@ paths: application/json: schema: type: array - items: *303 + items: *302 examples: - default: *304 + default: *303 '404': *6 '500': *38 "/orgs/{org}/bypass-requests/secret-scanning": @@ -41141,7 +43798,7 @@ paths: subcategory: delegated-bypass parameters: - *87 - - *305 + - *304 - *103 - *104 - *105 @@ -41155,9 +43812,9 @@ paths: application/json: schema: type: array - items: *306 + items: *305 examples: - default: *307 + default: *306 '404': *6 '500': *38 "/orgs/{org}/campaigns": @@ -41184,7 +43841,7 @@ paths: description: If specified, only campaigns with this state will be returned. in: query required: false - schema: &309 + schema: &308 title: Campaign state description: Indicates whether a campaign is open or closed type: string @@ -41210,7 +43867,7 @@ paths: application/json: schema: type: array - items: &310 + items: &309 title: Campaign summary description: The campaign metadata and alert stats. type: object @@ -41241,7 +43898,7 @@ paths: team_managers: description: The campaign team managers type: array - items: *308 + items: *307 published_at: description: The date and time the campaign was published, in ISO 8601 format':' YYYY-MM-DDTHH:MM:SSZ. @@ -41260,7 +43917,7 @@ paths: - string - 'null' format: date-time - state: *309 + state: *308 contact_link: description: The contact link of the campaign. type: @@ -41483,9 +44140,9 @@ paths: description: Response content: application/json: - schema: *310 + schema: *309 examples: - default: &311 + default: &310 value: number: 3 created_at: '2024-02-14T12:29:18Z' @@ -41568,9 +44225,9 @@ paths: description: Response content: application/json: - schema: *310 + schema: *309 examples: - default: *311 + default: *310 '404': *6 '422': description: Unprocessable Entity @@ -41648,7 +44305,7 @@ paths: - string - 'null' format: uri - state: *309 + state: *308 examples: default: value: @@ -41658,9 +44315,9 @@ paths: description: Response content: application/json: - schema: *310 + schema: *309 examples: - default: *311 + default: *310 '400': description: Bad Request content: @@ -41727,8 +44384,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-an-organization parameters: - *87 + - *311 - *312 - - *313 - *108 - *109 - *19 @@ -41739,7 +44396,7 @@ paths: be returned. in: query required: false - schema: *314 + schema: *313 - name: sort description: The property by which to sort the results. in: query @@ -41755,7 +44412,7 @@ paths: be returned. in: query required: false - schema: &526 + schema: &525 type: string description: Severity of a code scanning alert. enum: @@ -41781,9 +44438,9 @@ paths: application/json: schema: type: array - items: *315 + items: *314 examples: - default: *316 + default: *315 headers: Link: *45 '404': *6 @@ -42157,7 +44814,7 @@ paths: application/json: schema: *114 examples: - default: *317 + default: *316 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -42185,9 +44842,9 @@ paths: description: Response content: application/json: - schema: *318 + schema: *317 examples: - default: *319 + default: *318 '304': *35 '403': *27 '404': *6 @@ -42274,7 +44931,7 @@ paths: application/json: schema: *114 examples: - default: *317 + default: *316 '304': *35 '403': *27 '404': *6 @@ -42712,7 +45369,7 @@ paths: default: value: default_for_new_repos: all - configuration: *317 + configuration: *316 '403': *27 '404': *6 x-github: @@ -42765,13 +45422,13 @@ paths: application/json: schema: type: array - items: *320 + items: *319 examples: default: summary: Example of code security configuration repositories value: - status: attached - repository: *321 + repository: *320 '403': *27 '404': *6 x-github: @@ -42811,7 +45468,7 @@ paths: type: integer codespaces: type: array - items: &377 + items: &376 type: object title: Codespace description: A codespace. @@ -42842,11 +45499,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *279 + repository: *278 machine: anyOf: - type: 'null' - - &558 + - &557 type: object title: Codespace machine description: A description of the machine powering a codespace. @@ -43133,7 +45790,7 @@ paths: - pulls_url - recent_folders examples: - default: &378 + default: &377 value: total_count: 3 codespaces: @@ -43757,7 +46414,7 @@ paths: type: integer secrets: type: array - items: &322 + items: &321 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -43798,7 +46455,7 @@ paths: - updated_at - visibility examples: - default: &559 + default: &558 value: total_count: 2 secrets: @@ -43836,7 +46493,7 @@ paths: description: Response content: application/json: - schema: &560 + schema: &559 title: CodespacesPublicKey description: The public key used for setting Codespaces secrets. type: object @@ -43871,7 +46528,7 @@ paths: - key_id - key examples: - default: &561 + default: &560 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -43895,15 +46552,15 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#get-an-organization-secret parameters: - *87 - - *289 + - *288 responses: '200': description: Response content: application/json: - schema: *322 + schema: *321 examples: - default: &563 + default: &562 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -43931,7 +46588,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#create-or-update-an-organization-secret parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -43986,7 +46643,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -44013,7 +46670,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#delete-an-organization-secret parameters: - *87 - - *289 + - *288 responses: '204': description: Response @@ -44039,7 +46696,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#list-selected-repositories-for-an-organization-secret parameters: - *87 - - *289 + - *288 - *19 - *17 responses: @@ -44057,9 +46714,9 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 examples: - default: *293 + default: *292 '404': *6 x-github: githubCloudOnly: false @@ -44082,7 +46739,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#set-selected-repositories-for-an-organization-secret parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -44133,7 +46790,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#add-selected-repository-to-an-organization-secret parameters: - *87 - - *289 + - *288 - name: repository_id in: path required: true @@ -44167,7 +46824,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/organization-secrets#remove-selected-repository-from-an-organization-secret parameters: - *87 - - *289 + - *288 - name: repository_id in: path required: true @@ -44856,12 +47513,12 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 required: - total_count - repositories examples: - default: *323 + default: *322 '500': *38 '401': *23 '403': *27 @@ -44947,7 +47604,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-coding-agent-management#enable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: No Content @@ -44981,7 +47638,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/copilot/copilot-coding-agent-management#disable-a-repository-for-copilot-coding-agent-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: No Content @@ -45129,7 +47786,7 @@ paths: '401': *23 '403': *27 '404': *6 - '413': *324 + '413': *323 '422': *7 x-github: githubCloudOnly: @@ -45578,7 +48235,7 @@ paths: - 3 custom_roles: type: array - items: *325 + items: *324 examples: default: value: @@ -45670,7 +48327,7 @@ paths: required: true content: application/json: - schema: &327 + schema: &326 type: object properties: name: @@ -45712,9 +48369,9 @@ paths: description: Response content: application/json: - schema: *325 + schema: *324 examples: - default: *326 + default: *325 '422': *15 '404': *6 x-github: @@ -45745,9 +48402,9 @@ paths: description: Response content: application/json: - schema: *325 + schema: *324 examples: - default: *326 + default: *325 '404': *6 x-github: githubCloudOnly: true @@ -45775,7 +48432,7 @@ paths: required: true content: application/json: - schema: &328 + schema: &327 type: object properties: name: @@ -45814,9 +48471,9 @@ paths: description: Response content: application/json: - schema: *325 + schema: *324 examples: - default: *326 + default: *325 '422': *15 '404': *6 x-github: @@ -45874,7 +48531,7 @@ paths: required: true content: application/json: - schema: *327 + schema: *326 examples: default: value: @@ -45888,9 +48545,9 @@ paths: description: Response content: application/json: - schema: *325 + schema: *324 examples: - default: *326 + default: *325 '422': *15 '404': *6 x-github: @@ -45927,9 +48584,9 @@ paths: description: Response content: application/json: - schema: *325 + schema: *324 examples: - default: *326 + default: *325 '404': *6 x-github: githubCloudOnly: true @@ -45963,7 +48620,7 @@ paths: required: true content: application/json: - schema: *328 + schema: *327 examples: default: value: @@ -45978,9 +48635,9 @@ paths: description: Response content: application/json: - schema: *325 + schema: *324 examples: - default: *326 + default: *325 '422': *15 '404': *6 x-github: @@ -46040,11 +48697,11 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-an-organization parameters: - *87 + - *328 - *329 - *330 - *331 - *332 - - *333 - name: artifact_registry_url in: query description: A comma-separated list of artifact registry URLs. If specified, @@ -46074,7 +48731,7 @@ paths: enum: - patch - deployment - - *334 + - *333 - name: runtime_risk in: query description: |- @@ -46083,8 +48740,8 @@ paths: Can be: `critical-resource`, `internet-exposed`, `sensitive-data`, `lateral-movement` schema: type: string + - *334 - *335 - - *336 - *110 - *108 - *109 @@ -46096,9 +48753,9 @@ paths: application/json: schema: type: array - items: *337 + items: *336 examples: - default: *338 + default: *337 '304': *35 '400': *14 '403': *27 @@ -46142,7 +48799,7 @@ paths: type: integer secrets: type: array - items: &339 + items: &338 title: Dependabot Secret for an Organization description: Secrets for GitHub Dependabot for an organization. type: object @@ -46221,7 +48878,7 @@ paths: description: Response content: application/json: - schema: &589 + schema: &588 title: DependabotPublicKey description: The public key used for setting Dependabot Secrets. type: object @@ -46240,7 +48897,7 @@ paths: - key_id - key examples: - default: &590 + default: &589 value: key_id: '012345678912345678' key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -46264,13 +48921,13 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-an-organization-secret parameters: - *87 - - *289 + - *288 responses: '200': description: Response content: application/json: - schema: *339 + schema: *338 examples: default: value: @@ -46299,7 +48956,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#create-or-update-an-organization-secret parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -46356,7 +49013,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -46381,7 +49038,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#delete-an-organization-secret parameters: - *87 - - *289 + - *288 responses: '204': description: Response @@ -46406,7 +49063,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-selected-repositories-for-an-organization-secret parameters: - *87 - - *289 + - *288 - *19 - *17 responses: @@ -46424,9 +49081,9 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 examples: - default: *293 + default: *292 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -46448,7 +49105,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#set-selected-repositories-for-an-organization-secret parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -46499,7 +49156,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#add-selected-repository-to-an-organization-secret parameters: - *87 - - *289 + - *288 - name: repository_id in: path required: true @@ -46531,7 +49188,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#remove-selected-repository-from-an-organization-secret parameters: - *87 - - *289 + - *288 - name: repository_id in: path required: true @@ -46568,7 +49225,7 @@ paths: subcategory: alert-dismissal-requests parameters: - *87 - - &598 + - &597 name: reviewer description: Filter alert dismissal requests by the handle of the GitHub user who reviewed the dismissal request. @@ -46576,7 +49233,7 @@ paths: required: false schema: type: string - - &599 + - &598 name: requester description: Filter alert dismissal requests by the handle of the GitHub user who requested the dismissal. @@ -46584,7 +49241,7 @@ paths: required: false schema: type: string - - &600 + - &599 name: time_period description: |- The time period to filter by. @@ -46600,7 +49257,7 @@ paths: - week - month default: month - - &601 + - &600 name: request_status description: Filter alert dismissal requests by status. When specified, only requests with this status will be returned. @@ -46615,7 +49272,7 @@ paths: - denied - all default: all - - *305 + - *304 - *17 - *19 responses: @@ -46625,7 +49282,7 @@ paths: application/json: schema: type: array - items: &602 + items: &601 title: Code scanning alert dismissal request description: Alert dismisal request made by a user asking to dismiss a code scanning alert. @@ -46735,7 +49392,7 @@ paths: - array - 'null' description: The responses to the dismissal request. - items: &340 + items: &339 title: Dismissal request response description: A response made by a requester to dismiss the request. @@ -46788,7 +49445,7 @@ paths: examples: - https://github.com/octo-org/smile/code-scanning/alerts/1 examples: - default: &603 + default: &602 value: - id: 21 number: 42 @@ -46876,11 +49533,11 @@ paths: subcategory: alert-dismissal-requests parameters: - *87 - - *305 + - *304 - *103 - *104 - *105 - - &341 + - &340 name: request_status description: The status of the dismissal request to filter on. When specified, only requests with this status will be returned. @@ -46906,7 +49563,7 @@ paths: application/json: schema: type: array - items: &604 + items: &603 title: Dependabot alert dismissal request description: Alert dismissal request made by a user asking to dismiss a Dependabot alert. @@ -47016,7 +49673,7 @@ paths: - array - 'null' description: The responses to the dismissal request. - items: *340 + items: *339 url: type: string format: uri @@ -47029,7 +49686,7 @@ paths: examples: - https://github.com/octo-org/smile/security/dependabot/1 examples: - default: &605 + default: &604 value: - id: 21 number: 42 @@ -47117,11 +49774,11 @@ paths: subcategory: alert-dismissal-requests parameters: - *87 - - *305 + - *304 - *103 - *104 - *105 - - *341 + - *340 - *17 - *19 responses: @@ -47131,7 +49788,7 @@ paths: application/json: schema: type: array - items: &606 + items: &605 title: Secret scanning alert dismissal request description: A dismissal request made by a user asking to close a secret scanning alert in this repository. @@ -47258,7 +49915,7 @@ paths: examples: - https://github.com/octo-org/smile/security/secret-scanning/17 examples: - default: &607 + default: &606 value: - id: 21 number: 42 @@ -47346,7 +50003,7 @@ paths: application/json: schema: type: array - items: &387 + items: &386 title: Package description: A software package type: object @@ -47399,7 +50056,7 @@ paths: repository: anyOf: - type: 'null' - - *279 + - *278 created_at: type: string format: date-time @@ -47417,7 +50074,7 @@ paths: - created_at - updated_at examples: - default: &388 + default: &387 value: - id: 197 name: hello_docker @@ -47604,7 +50261,7 @@ paths: description: Response content: application/json: - schema: &451 + schema: &450 title: ExternalGroup description: Information about an external group's usage and its members type: object @@ -47694,7 +50351,7 @@ paths: member_name: Octo Lisa member_email: octo_lisa@github.com examples: - default: &452 + default: &451 value: group_id: '123' group_name: Octocat admins @@ -47749,7 +50406,7 @@ paths: description: Response content: application/json: - schema: &448 + schema: &447 title: ExternalGroups description: A list of external groups available to be connected to a team @@ -47789,7 +50446,7 @@ paths: group_name: group-azuread-test2 updated_at: 2021-06-03 22:27:15:000 -700 examples: - default: &449 + default: &448 value: groups: - group_id: '123' @@ -47834,7 +50491,7 @@ paths: application/json: schema: type: array - items: &366 + items: &365 title: Organization Invitation description: Organization Invitation type: object @@ -47888,7 +50545,7 @@ paths: - invitation_teams_url - node_id examples: - default: &367 + default: &366 value: - id: 1 login: monalisa @@ -47955,7 +50612,7 @@ paths: application/json: schema: type: array - items: &418 + items: &417 title: Repository Fine-Grained Permission description: A fine-grained permission that protects repository resources. @@ -47969,7 +50626,7 @@ paths: - name - description examples: - default: &419 + default: &418 value: - name: add_assignee description: Assign or remove a user @@ -48010,7 +50667,7 @@ paths: application/json: schema: type: array - items: &342 + items: &341 title: Org Hook description: Org Hook type: object @@ -48193,9 +50850,9 @@ paths: description: Response content: application/json: - schema: *342 + schema: *341 examples: - default: &343 + default: &342 value: id: 1 url: https://api.github.com/orgs/octocat/hooks/1 @@ -48240,7 +50897,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-an-organization-webhook parameters: - *87 - - &344 + - &343 name: hook_id description: The unique identifier of the hook. You can find this value in the `X-GitHub-Hook-ID` header of a webhook delivery. @@ -48253,9 +50910,9 @@ paths: description: Response content: application/json: - schema: *342 + schema: *341 examples: - default: *343 + default: *342 '404': *6 x-github: githubCloudOnly: false @@ -48277,7 +50934,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#update-an-organization-webhook parameters: - *87 - - *344 + - *343 requestBody: required: false content: @@ -48323,7 +50980,7 @@ paths: description: Response content: application/json: - schema: *342 + schema: *341 examples: default: value: @@ -48363,7 +51020,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#delete-an-organization-webhook parameters: - *87 - - *344 + - *343 responses: '204': description: Response @@ -48389,7 +51046,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-a-webhook-configuration-for-an-organization parameters: - *87 - - *344 + - *343 responses: '200': description: Response @@ -48418,7 +51075,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#update-a-webhook-configuration-for-an-organization parameters: - *87 - - *344 + - *343 requestBody: required: false content: @@ -48467,10 +51124,10 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#list-deliveries-for-an-organization-webhook parameters: - *87 - - *344 + - *343 - *17 + - *344 - *345 - - *346 responses: '200': description: Response @@ -48478,9 +51135,9 @@ paths: application/json: schema: type: array - items: *347 + items: *346 examples: - default: *348 + default: *347 '400': *14 '422': *15 x-github: @@ -48504,16 +51161,16 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#get-a-webhook-delivery-for-an-organization-webhook parameters: - *87 - - *344 + - *343 - *16 responses: '200': description: Response content: application/json: - schema: *349 + schema: *348 examples: - default: *350 + default: *349 '400': *14 '422': *15 x-github: @@ -48537,7 +51194,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#redeliver-a-delivery-for-an-organization-webhook parameters: - *87 - - *344 + - *343 - *16 responses: '202': *37 @@ -48564,7 +51221,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/webhooks#ping-an-organization-webhook parameters: - *87 - - *344 + - *343 responses: '204': description: Response @@ -48587,7 +51244,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-route-stats-by-actor parameters: - *87 - - &355 + - &354 name: actor_type in: path description: The type of the actor @@ -48600,14 +51257,14 @@ paths: - fine_grained_pat - oauth_app - github_app_user_to_server - - &356 + - &355 name: actor_id in: path description: The ID of the actor required: true schema: type: integer - - &351 + - &350 name: min_timestamp description: 'The minimum timestamp to query for stats. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format: `YYYY-MM-DDTHH:MM:SSZ`.' @@ -48615,7 +51272,7 @@ paths: required: true schema: type: string - - &352 + - &351 name: max_timestamp description: 'The maximum timestamp to query for stats. Defaults to the time 30 days ago. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -48710,12 +51367,12 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-subject-stats parameters: - *87 + - *350 - *351 - - *352 - *19 - *17 - *110 - - &361 + - &360 name: sort description: The property to sort the results by. in: query @@ -48794,14 +51451,14 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats parameters: - *87 + - *350 - *351 - - *352 responses: '200': description: Response content: application/json: - schema: &353 + schema: &352 title: Summary Stats description: API Insights usage summary stats for an organization type: object @@ -48817,7 +51474,7 @@ paths: type: integer format: int64 examples: - default: &354 + default: &353 value: total_request_count: 34225 rate_limited_request_count: 23 @@ -48838,23 +51495,23 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats-by-user parameters: - *87 - - &357 + - &356 name: user_id in: path description: The ID of the user to query for stats required: true schema: type: string + - *350 - *351 - - *352 responses: '200': description: Response content: application/json: - schema: *353 + schema: *352 examples: - default: *354 + default: *353 x-github: enabledForGitHubApps: true category: orgs @@ -48873,18 +51530,18 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-summary-stats-by-actor parameters: - *87 + - *350 - *351 - - *352 + - *354 - *355 - - *356 responses: '200': description: Response content: application/json: - schema: *353 + schema: *352 examples: - default: *354 + default: *353 x-github: enabledForGitHubApps: true category: orgs @@ -48902,9 +51559,9 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats parameters: - *87 + - *350 - *351 - - *352 - - &358 + - &357 name: timestamp_increment description: The increment of time used to breakdown the query results (5m, 10m, 1h, etc.) @@ -48917,7 +51574,7 @@ paths: description: Response content: application/json: - schema: &359 + schema: &358 title: Time Stats description: API Insights usage time stats for an organization type: array @@ -48933,7 +51590,7 @@ paths: type: integer format: int64 examples: - default: &360 + default: &359 value: - timestamp: '2024-09-11T15:00:00Z' total_request_count: 34225 @@ -48970,18 +51627,18 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats-by-user parameters: - *87 - - *357 + - *356 + - *350 - *351 - - *352 - - *358 + - *357 responses: '200': description: Response content: application/json: - schema: *359 + schema: *358 examples: - default: *360 + default: *359 x-github: enabledForGitHubApps: true category: orgs @@ -48999,19 +51656,19 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-time-stats-by-actor parameters: - *87 + - *354 - *355 - - *356 + - *350 - *351 - - *352 - - *358 + - *357 responses: '200': description: Response content: application/json: - schema: *359 + schema: *358 examples: - default: *360 + default: *359 x-github: enabledForGitHubApps: true category: orgs @@ -49029,13 +51686,13 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/api-insights#get-user-stats parameters: - *87 - - *357 + - *356 + - *350 - *351 - - *352 - *19 - *17 - *110 - - *361 + - *360 - name: actor_name_substring in: query description: Providing a substring will filter results where the actor name @@ -49119,7 +51776,7 @@ paths: application/json: schema: *20 examples: - default: *362 + default: *361 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -49239,12 +51896,12 @@ paths: application/json: schema: anyOf: - - &364 + - &363 title: Interaction Limits description: Interaction limit settings. type: object properties: - limit: &363 + limit: &362 type: string description: The type of GitHub user that can comment, open issues, or create pull requests while the interaction limit @@ -49272,7 +51929,7 @@ paths: properties: {} additionalProperties: false examples: - default: &365 + default: &364 value: limit: collaborators_only origin: organization @@ -49301,13 +51958,13 @@ paths: required: true content: application/json: - schema: &638 + schema: &637 title: Interaction Restrictions description: Limit interactions to a specific type of user for a specified duration type: object properties: - limit: *363 + limit: *362 expiry: type: string description: 'The duration of the interaction restriction. Default: @@ -49332,9 +51989,9 @@ paths: description: Response content: application/json: - schema: *364 + schema: *363 examples: - default: *365 + default: *364 '422': *15 x-github: githubCloudOnly: false @@ -49412,9 +52069,9 @@ paths: application/json: schema: type: array - items: *366 + items: *365 examples: - default: *367 + default: *366 headers: Link: *45 '404': *6 @@ -49492,7 +52149,7 @@ paths: description: Response content: application/json: - schema: *366 + schema: *365 examples: default: value: @@ -49549,7 +52206,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#cancel-an-organization-invitation parameters: - *87 - - &368 + - &367 name: invitation_id description: The unique identifier of the invitation. in: path @@ -49583,7 +52240,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/members#list-organization-invitation-teams parameters: - *87 - - *368 + - *367 - *17 - *19 responses: @@ -49593,9 +52250,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: &386 + default: &385 value: - id: 1 node_id: MDQ6VGVhbTE= @@ -49638,7 +52295,7 @@ paths: application/json: schema: type: array - items: &369 + items: &368 title: Issue Field description: A custom attribute defined at the organization level for attaching structured data to issues. @@ -49881,9 +52538,9 @@ paths: description: Response content: application/json: - schema: *369 + schema: *368 examples: - default: &370 + default: &369 value: id: 512 node_id: IF_kwDNAd3NAZr @@ -49939,7 +52596,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-fields#update-issue-field-for-an-organization parameters: - *87 - - &371 + - &370 name: issue_field_id description: The unique identifier of the issue field. in: path @@ -50040,9 +52697,9 @@ paths: description: Response content: application/json: - schema: *369 + schema: *368 examples: - default: *370 + default: *369 '404': *6 '422': *7 x-github: @@ -50067,7 +52724,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-fields#delete-issue-field-for-an-organization parameters: - *87 - - *371 + - *370 responses: '204': *151 '404': *6 @@ -50097,7 +52754,7 @@ paths: application/json: schema: type: array - items: *372 + items: *371 examples: default: value: @@ -50185,9 +52842,9 @@ paths: description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: &373 + default: &372 value: id: 410 node_id: IT_kwDNAd3NAZo @@ -50220,7 +52877,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#update-issue-type-for-an-organization parameters: - *87 - - &374 + - &373 name: issue_type_id description: The unique identifier of the issue type. in: path @@ -50276,9 +52933,9 @@ paths: description: Response content: application/json: - schema: *372 + schema: *371 examples: - default: *373 + default: *372 '404': *6 '422': *7 x-github: @@ -50303,7 +52960,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/issue-types#delete-issue-type-for-an-organization parameters: - *87 - - *374 + - *373 responses: '204': description: Response @@ -50366,7 +53023,7 @@ paths: - closed - all default: open - - *375 + - *374 - name: type description: Can be the name of an issue type. in: query @@ -50397,7 +53054,7 @@ paths: type: array items: *219 examples: - default: *376 + default: *375 headers: Link: *45 '404': *6 @@ -50556,9 +53213,9 @@ paths: type: integer codespaces: type: array - items: *377 + items: *376 examples: - default: *378 + default: *377 '304': *35 '500': *38 '401': *23 @@ -50585,7 +53242,7 @@ paths: parameters: - *87 - *139 - - &379 + - &378 name: codespace_name in: path required: true @@ -50620,15 +53277,15 @@ paths: parameters: - *87 - *139 - - *379 + - *378 responses: '200': description: Response content: application/json: - schema: *377 + schema: *376 examples: - default: &557 + default: &556 value: id: 1 name: monalisa-octocat-hello-world-g4wpq6h95q @@ -50884,7 +53541,7 @@ paths: description: Response content: application/json: - schema: &380 + schema: &379 title: Org Membership description: Org Membership type: object @@ -50953,7 +53610,7 @@ paths: - organization - user examples: - response-if-user-has-an-active-admin-membership-with-organization: &381 + response-if-user-has-an-active-admin-membership-with-organization: &380 summary: Response if user has an active admin membership with organization value: url: https://api.github.com/orgs/octocat/memberships/defunkt @@ -51054,9 +53711,9 @@ paths: description: Response content: application/json: - schema: *380 + schema: *379 examples: - response-if-user-already-had-membership-with-organization: *381 + response-if-user-already-had-membership-with-organization: *380 '422': *15 '403': *27 x-github: @@ -51128,7 +53785,7 @@ paths: application/json: schema: type: array - items: &382 + items: &381 title: Migration description: A migration. type: object @@ -51466,7 +54123,7 @@ paths: description: Response content: application/json: - schema: *382 + schema: *381 examples: default: value: @@ -51645,7 +54302,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#get-an-organization-migration-status parameters: - *87 - - &383 + - &382 name: migration_id description: The unique identifier of the migration. in: path @@ -51673,7 +54330,7 @@ paths: * `failed`, which means the migration failed. content: application/json: - schema: *382 + schema: *381 examples: default: value: @@ -51843,7 +54500,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#download-an-organization-migration-archive parameters: - *87 - - *383 + - *382 responses: '302': description: Response @@ -51865,7 +54522,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#delete-an-organization-migration-archive parameters: - *87 - - *383 + - *382 responses: '204': description: Response @@ -51889,8 +54546,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#unlock-an-organization-repository parameters: - *87 - - *383 - - &801 + - *382 + - &800 name: repo_name description: repo_name parameter in: path @@ -51918,7 +54575,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/orgs#list-repositories-in-an-organization-migration parameters: - *87 - - *383 + - *382 - *17 - *19 responses: @@ -51928,9 +54585,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: &393 + default: &392 value: - id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -52061,7 +54718,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -52115,7 +54772,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -52141,7 +54798,7 @@ paths: roles: type: array description: The list of organization roles available to the organization. - items: &384 + items: &383 title: Organization Role description: Organization roles type: object @@ -52293,7 +54950,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `write_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **Manage custom organization roles** (`write_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -52350,7 +55007,7 @@ paths: description: Response content: application/json: - schema: *384 + schema: *383 examples: default: value: @@ -52563,7 +55220,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `read_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **View organization roles** (`read_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -52580,7 +55237,7 @@ paths: description: Response content: application/json: - schema: *384 + schema: *383 examples: default: value: @@ -52627,7 +55284,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `write_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **Manage custom organization roles** (`write_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -52677,7 +55334,7 @@ paths: description: Response content: application/json: - schema: *384 + schema: *383 examples: default: value: @@ -52720,7 +55377,7 @@ paths: To use this endpoint, the authenticated user must be one of: - An administrator for the organization. - - A user, or a user on a team, with the fine-grained permissions of `write_organization_custom_org_role` in the organization. + - An organization member (or a member of a team) assigned a custom organization role that includes the **Manage custom organization roles** (`write_organization_custom_org_role`) permission. For more information, see "[Permissions for organization access](https://docs.github.com/enterprise-cloud@latest//organizations/managing-peoples-access-to-your-organization-with-roles/permissions-of-custom-organization-roles#permissions-for-organization-access)." OAuth app tokens and personal access tokens (classic) need the `admin:org` scope to use this endpoint. tags: @@ -52836,7 +55493,7 @@ paths: parent: anyOf: - type: 'null' - - *385 + - *384 type: description: The ownership type of the team type: string @@ -52869,7 +55526,7 @@ paths: - type - parent examples: - default: *386 + default: *385 headers: Link: *45 '404': @@ -52928,7 +55585,7 @@ paths: inherited_from: description: Team the user has gotten the role through type: array - items: *385 + items: *384 name: type: - string @@ -53238,7 +55895,7 @@ paths: - nuget - container - *87 - - &802 + - &801 name: visibility description: |- The selected visibility of the packages. This parameter is optional and only filters an existing result set. @@ -53274,12 +55931,12 @@ paths: application/json: schema: type: array - items: *387 + items: *386 examples: - default: *388 + default: *387 '403': *27 '401': *23 - '400': &804 + '400': &803 description: The value of `per_page` multiplied by `page` cannot be greater than 10000. x-github: @@ -53301,7 +55958,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-an-organization parameters: - - &389 + - &388 name: package_type description: The type of supported package. Packages in GitHub's Gradle registry have the type `maven`. Docker images pushed to GitHub's Container registry @@ -53319,7 +55976,7 @@ paths: - docker - nuget - container - - &390 + - &389 name: package_name description: The name of the package. in: path @@ -53332,7 +55989,7 @@ paths: description: Response content: application/json: - schema: *387 + schema: *386 examples: default: value: @@ -53384,8 +56041,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-an-organization parameters: + - *388 - *389 - - *390 - *87 responses: '204': @@ -53418,8 +56075,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-an-organization parameters: + - *388 - *389 - - *390 - *87 - name: token description: package token @@ -53452,8 +56109,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-an-organization parameters: + - *388 - *389 - - *390 - *87 - *19 - *17 @@ -53474,7 +56131,7 @@ paths: application/json: schema: type: array - items: &391 + items: &390 title: Package Version description: A version of a software package type: object @@ -53609,10 +56266,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-an-organization parameters: + - *388 - *389 - - *390 - *87 - - &392 + - &391 name: package_version_id description: Unique identifier of the package version. in: path @@ -53624,7 +56281,7 @@ paths: description: Response content: application/json: - schema: *391 + schema: *390 examples: default: value: @@ -53660,10 +56317,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-package-version-for-an-organization parameters: + - *388 - *389 - - *390 - *87 - - *392 + - *391 responses: '204': description: Response @@ -53695,10 +56352,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-package-version-for-an-organization parameters: + - *388 - *389 - - *390 - *87 - - *392 + - *391 responses: '204': description: Response @@ -53728,7 +56385,7 @@ paths: - *87 - *17 - *19 - - &394 + - &393 name: sort description: The property by which to sort the results. in: query @@ -53739,7 +56396,7 @@ paths: - created_at default: created_at - *110 - - &395 + - &394 name: owner description: A list of owner usernames to use to filter the results. in: query @@ -53751,7 +56408,7 @@ paths: type: string examples: - owner[]=octocat1,owner[]=octocat2 - - &396 + - &395 name: repository description: The name of the repository to use to filter the results. in: query @@ -53760,7 +56417,7 @@ paths: type: string examples: - Hello-World - - &397 + - &396 name: permission description: The permission to use to filter the results. in: query @@ -53769,7 +56426,7 @@ paths: type: string examples: - issues_read - - &398 + - &397 name: last_used_before description: 'Only show fine-grained personal access tokens used before the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -53779,7 +56436,7 @@ paths: schema: type: string format: date-time - - &399 + - &398 name: last_used_after description: 'Only show fine-grained personal access tokens used after the given time. This is a timestamp in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) @@ -53789,7 +56446,7 @@ paths: schema: type: string format: date-time - - &400 + - &399 name: token_id description: The ID of the token in: query @@ -54106,9 +56763,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 x-github: @@ -54134,14 +56791,14 @@ paths: - *87 - *17 - *19 - - *394 + - *393 - *110 + - *394 - *395 - *396 - *397 - *398 - *399 - - *400 responses: '500': *38 '422': *15 @@ -54423,9 +57080,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 x-github: @@ -54467,7 +57124,7 @@ paths: type: integer configurations: type: array - items: &401 + items: &400 title: Organization private registry description: Private registry configuration for an organization type: object @@ -54901,7 +57558,7 @@ paths: - created_at - updated_at examples: - org-private-registry-with-selected-visibility: &402 + org-private-registry-with-selected-visibility: &401 value: name: MAVEN_REPOSITORY_SECRET registry_type: maven_repository @@ -54993,15 +57650,15 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#get-a-private-registry-for-an-organization parameters: - *87 - - *289 + - *288 responses: '200': description: The specified private registry configuration for the organization content: application/json: - schema: *401 + schema: *400 examples: - default: *402 + default: *401 '404': *6 x-github: githubCloudOnly: false @@ -55024,7 +57681,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#update-a-private-registry-for-an-organization parameters: - *87 - - *289 + - *288 requestBody: required: true content: @@ -55189,7 +57846,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/private-registries/organization-configurations#delete-a-private-registry-for-an-organization parameters: - *87 - - *289 + - *288 responses: '204': description: Response @@ -55229,7 +57886,7 @@ paths: application/json: schema: type: array - items: &403 + items: &402 title: Projects v2 Project description: A projects v2 project type: object @@ -55303,7 +57960,7 @@ paths: latest_status_update: anyOf: - type: 'null' - - &890 + - &889 title: Projects v2 Status Update description: An status update belonging to a project type: object @@ -55388,7 +58045,7 @@ paths: - deleted_at - deleted_by examples: - default: &404 + default: &403 value: id: 2 node_id: MDc6UHJvamVjdDEwMDI2MDM= @@ -55491,7 +58148,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#get-project-for-organization parameters: - - &405 + - &404 name: project_number description: The project's number. in: path @@ -55504,9 +58161,9 @@ paths: description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: *404 + default: *403 headers: Link: *45 '304': *35 @@ -55529,7 +58186,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/projects/drafts#create-draft-item-for-organization-owned-project parameters: - *87 - - *405 + - *404 requestBody: required: true description: Details of the draft item to create in the project. @@ -55563,7 +58220,7 @@ paths: description: Response content: application/json: - schema: &410 + schema: &409 title: Projects v2 Item description: An item belonging to a project type: object @@ -55577,7 +58234,7 @@ paths: content: oneOf: - *219 - - &572 + - &571 title: Pull Request Simple description: Pull Request Simple type: object @@ -55697,7 +58354,7 @@ paths: milestone: anyOf: - type: 'null' - - *406 + - *405 active_lock_reason: type: - string @@ -55746,7 +58403,7 @@ paths: items: *4 requested_teams: type: array - items: *308 + items: *307 head: type: object properties: @@ -55790,7 +58447,7 @@ paths: _links: type: object properties: - comments: &407 + comments: &406 title: Link description: Hypermedia Link type: object @@ -55799,13 +58456,13 @@ paths: type: string required: - href - commits: *407 - statuses: *407 - html: *407 - issue: *407 - review_comments: *407 - review_comment: *407 - self: *407 + commits: *406 + statuses: *406 + html: *406 + issue: *406 + review_comments: *406 + review_comment: *406 + self: *406 required: - comments - commits @@ -55816,7 +58473,7 @@ paths: - review_comment - self author_association: *216 - auto_merge: &685 + auto_merge: &684 title: Auto merge description: The status of auto merging a pull request. type: @@ -55918,7 +58575,7 @@ paths: - created_at - updated_at description: The content represented by the item. - content_type: &409 + content_type: &408 title: Projects v2 Item Content Type description: The type of content tracked in a project item type: string @@ -55962,7 +58619,7 @@ paths: - updated_at - archived_at examples: - draft_issue: &411 + draft_issue: &410 value: id: 17 node_id: PVTI_lADOANN5s84ACbL0zgBueEI @@ -56036,7 +58693,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/fields#list-project-fields-for-organization parameters: - - *405 + - *404 - *87 - *17 - *108 @@ -56048,7 +58705,7 @@ paths: application/json: schema: type: array - items: &408 + items: &407 title: Projects v2 Field description: A field inside a projects v2 project type: object @@ -56201,7 +58858,7 @@ paths: - updated_at - project_url examples: - default: &823 + default: &822 value: - id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -56331,7 +58988,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/fields#add-a-field-to-an-organization-owned-project parameters: - - *405 + - *404 - *87 requestBody: required: true @@ -56378,7 +59035,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: &824 + items: &823 type: object properties: name: @@ -56415,7 +59072,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: &825 + iteration_configuration: &824 type: object description: The configuration for iteration fields. properties: @@ -56465,7 +59122,7 @@ paths: value: name: Due date data_type: date - single_select_field: &826 + single_select_field: &825 summary: Create a single select field value: name: Priority @@ -56492,7 +59149,7 @@ paths: description: raw: High priority items html: High priority items - iteration_field: &827 + iteration_field: &826 summary: Create an iteration field value: name: Sprint @@ -56516,9 +59173,9 @@ paths: description: Response for adding a field to an organization-owned project. content: application/json: - schema: *408 + schema: *407 examples: - text_field: &828 + text_field: &827 value: id: 24680 node_id: PVTF_lADOABCD2468024680 @@ -56527,7 +59184,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-05-15T08:00:00Z' updated_at: '2022-05-15T08:00:00Z' - number_field: &829 + number_field: &828 value: id: 13579 node_id: PVTF_lADOABCD1357913579 @@ -56536,7 +59193,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-01T14:30:00Z' updated_at: '2022-06-01T14:30:00Z' - date_field: &830 + date_field: &829 value: id: 98765 node_id: PVTF_lADOABCD9876598765 @@ -56545,7 +59202,7 @@ paths: project_url: https://api.github.com/projects/67890 created_at: '2022-06-10T09:15:00Z' updated_at: '2022-06-10T09:15:00Z' - single_select_field: &831 + single_select_field: &830 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -56579,7 +59236,7 @@ paths: raw: High priority items created_at: '2022-04-28T12:00:00Z' updated_at: '2022-04-28T12:00:00Z' - iteration_field: &832 + iteration_field: &831 value: id: 11223 node_id: PVTF_lADOABCD1122311223 @@ -56624,8 +59281,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/fields#get-project-field-for-organization parameters: - - *405 - - &833 + - *404 + - &832 name: field_id description: The unique identifier of the field. in: path @@ -56638,9 +59295,9 @@ paths: description: Response content: application/json: - schema: *408 + schema: *407 examples: - default: &834 + default: &833 value: id: 12345 node_id: PVTF_lADOABCD1234567890 @@ -56696,7 +59353,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#list-items-for-an-organization-owned-project parameters: - - *405 + - *404 - *87 - name: q description: Search query to filter items, see [Filtering projects](https://docs.github.com/enterprise-cloud@latest//issues/planning-and-tracking-with-projects/customizing-views-in-your-project/filtering-projects) @@ -56729,7 +59386,7 @@ paths: application/json: schema: type: array - items: &412 + items: &411 title: Projects v2 Item description: An item belonging to a project type: object @@ -56746,7 +59403,7 @@ paths: description: The API URL of the project that contains this item. examples: - https://api.github.com/users/monalisa/2/projectsV2/3 - content_type: *409 + content_type: *408 content: type: - object @@ -56796,7 +59453,7 @@ paths: - updated_at - archived_at examples: - default: &413 + default: &412 value: id: 13 node_id: PVTI_lAAFAQ0 @@ -57494,7 +60151,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#add-item-to-organization-owned-project parameters: - *87 - - *405 + - *404 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -57564,22 +60221,22 @@ paths: description: Response content: application/json: - schema: *410 + schema: *409 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *411 + value: *410 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *411 + value: *410 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *411 + value: *410 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *411 + value: *410 '304': *35 '403': *27 '401': *23 @@ -57599,9 +60256,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#get-an-item-for-an-organization-owned-project parameters: - - *405 + - *404 - *87 - - &414 + - &413 name: item_id description: The unique identifier of the project item. in: path @@ -57627,9 +60284,9 @@ paths: description: Response content: application/json: - schema: *412 + schema: *411 examples: - default: *413 + default: *412 headers: Link: *45 '304': *35 @@ -57650,9 +60307,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#update-project-item-for-organization parameters: - - *405 + - *404 - *87 - - *414 + - *413 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -57725,13 +60382,13 @@ paths: description: Response content: application/json: - schema: *412 + schema: *411 examples: - text_field: *413 - number_field: *413 - date_field: *413 - single_select_field: *413 - iteration_field: *413 + text_field: *412 + number_field: *412 + date_field: *412 + single_select_field: *412 + iteration_field: *412 '401': *23 '403': *27 '404': *6 @@ -57751,9 +60408,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#delete-project-item-for-organization parameters: - - *405 + - *404 - *87 - - *414 + - *413 responses: '204': description: Response @@ -57777,7 +60434,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/projects/views#create-a-view-for-an-organization-owned-project parameters: - *87 - - *405 + - *404 requestBody: required: true content: @@ -57851,7 +60508,7 @@ paths: description: Response for creating a view in an organization-owned project. content: application/json: - schema: &815 + schema: &814 title: Projects v2 View description: A view inside a projects v2 project type: object @@ -57955,7 +60612,7 @@ paths: examples: table_view: summary: Response for creating a table view - value: &415 + value: &414 value: id: 1 number: 1 @@ -58001,10 +60658,10 @@ paths: - 456 board_view: summary: Response for creating a board view with filter - value: *415 + value: *414 roadmap_view: summary: Response for creating a roadmap view - value: *415 + value: *414 '304': *35 '403': *27 '401': *23 @@ -58032,9 +60689,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#list-items-for-an-organization-project-view parameters: - - *405 + - *404 - *87 - - &835 + - &834 name: view_number description: The number that identifies the project view. in: path @@ -58066,9 +60723,9 @@ paths: application/json: schema: type: array - items: *412 + items: *411 examples: - default: *413 + default: *412 headers: Link: *45 '304': *35 @@ -58232,7 +60889,7 @@ paths: required: true content: application/json: - schema: *416 + schema: *415 examples: default: value: @@ -58598,9 +61255,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 x-github: @@ -58804,7 +61461,7 @@ paths: description: Response content: application/json: - schema: &459 + schema: &458 title: Full Repository description: Full Repository type: object @@ -59282,7 +61939,7 @@ paths: description: Whether anonymous git access is allowed. default: true type: boolean - code_of_conduct: &577 + code_of_conduct: &576 title: Code Of Conduct Simple description: Code of Conduct Simple type: object @@ -59312,7 +61969,7 @@ paths: - key - name - html_url - security_and_analysis: *417 + security_and_analysis: *416 custom_properties: type: object description: The custom properties that were defined for the repository. @@ -59396,7 +62053,7 @@ paths: - network_count - subscribers_count examples: - default: &461 + default: &460 value: id: 1296269 node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 @@ -59922,9 +62579,9 @@ paths: application/json: schema: type: array - items: *418 + items: *417 examples: - default: *419 + default: *418 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -59949,7 +62606,7 @@ paths: - *87 - *17 - *19 - - &707 + - &706 name: targets description: | A comma-separated list of rule targets to filter by. @@ -60041,11 +62698,11 @@ paths: type: array description: The actors that can bypass the rules in this ruleset items: *165 - conditions: *420 + conditions: *419 rules: type: array description: An array of rules within the ruleset. - items: &422 + items: &421 title: Repository Rule type: object description: A repository rule. @@ -60110,7 +62767,7 @@ paths: application/json: schema: *187 examples: - default: &421 + default: &420 value: id: 21 name: super cool ruleset @@ -60166,7 +62823,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rule-suites#list-organization-rule-suites parameters: - *87 - - &709 + - &708 name: ref description: The name of the ref. Cannot contain wildcard characters. Optionally prefix with `refs/heads/` to limit to branches or `refs/tags/` to limit @@ -60176,16 +62833,16 @@ paths: schema: type: string x-multi-segment: true - - *305 + - *304 - *105 - - &710 + - &709 name: actor_name description: The handle for the GitHub user account to filter on. When specified, only rule evaluations triggered by this actor will be returned. in: query schema: type: string - - &711 + - &710 name: rule_suite_result description: The rule suite results to filter on. When specified, only suites with this result will be returned. @@ -60205,7 +62862,7 @@ paths: description: Response content: application/json: - schema: &712 + schema: &711 title: Rule Suites description: Response type: array @@ -60261,7 +62918,7 @@ paths: whether rules would pass or fail if all rules in the rule suite were `active`. examples: - default: &713 + default: &712 value: - id: 21 actor_id: 12 @@ -60305,7 +62962,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/rule-suites#get-an-organization-rule-suite parameters: - *87 - - &714 + - &713 name: rule_suite_id description: |- The unique identifier of the rule suite result. @@ -60321,7 +62978,7 @@ paths: description: Response content: application/json: - schema: &715 + schema: &714 title: Rule Suite description: Response type: object @@ -60428,7 +63085,7 @@ paths: description: The detailed failure message for the rule. Null if the rule passed. examples: - default: &716 + default: &715 value: id: 21 actor_id: 12 @@ -60503,7 +63160,7 @@ paths: application/json: schema: *187 examples: - default: *421 + default: *420 '404': *6 '500': *38 put: @@ -60552,11 +63209,11 @@ paths: type: array description: The actors that can bypass the rules in this ruleset items: *165 - conditions: *420 + conditions: *419 rules: description: An array of rules within the ruleset. type: array - items: *422 + items: *421 examples: default: value: @@ -60593,7 +63250,7 @@ paths: application/json: schema: *187 examples: - default: *421 + default: *420 '404': *6 '422': *15 '500': *38 @@ -60653,7 +63310,7 @@ paths: type: array items: *191 examples: - default: *423 + default: *422 '404': *6 '500': *38 x-github: @@ -60690,7 +63347,7 @@ paths: description: Response content: application/json: - schema: *424 + schema: *423 examples: default: value: @@ -60753,15 +63410,15 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-an-organization parameters: - *87 + - *424 - *425 - *426 - *427 - *428 - - *429 - *110 - *19 - *17 - - &718 + - &717 name: before description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events before this cursor. To @@ -60771,7 +63428,7 @@ paths: required: false schema: type: string - - &719 + - &718 name: after description: A cursor, as given in the [Link header](https://docs.github.com/enterprise-cloud@latest//rest/guides/using-pagination-in-the-rest-api#using-link-headers). If specified, the query only searches for events after this cursor. To @@ -60781,10 +63438,10 @@ paths: required: false schema: type: string + - *429 - *430 - *431 - *432 - - *433 responses: '200': description: Response @@ -60792,9 +63449,9 @@ paths: application/json: schema: type: array - items: *434 + items: *433 examples: - default: *435 + default: *434 headers: Link: *45 '404': *6 @@ -60829,9 +63486,9 @@ paths: description: Response content: application/json: - schema: *436 + schema: *435 examples: - default: *437 + default: *436 '403': *27 '404': *6 patch: @@ -60984,7 +63641,7 @@ paths: application/json: schema: type: array - items: &740 + items: &739 description: A repository security advisory. type: object properties: @@ -61228,7 +63885,7 @@ paths: login: type: string description: The username of the user credited. - type: *438 + type: *437 credits_detailed: type: - array @@ -61239,7 +63896,7 @@ paths: type: object properties: user: *4 - type: *438 + type: *437 state: type: string description: The state of the user's acceptance of the @@ -61265,7 +63922,7 @@ paths: - array - 'null' description: A list of teams that collaborate on the advisory. - items: *308 + items: *307 private_fork: readOnly: true description: A temporary private fork of the advisory's repository @@ -61303,7 +63960,7 @@ paths: - private_fork additionalProperties: false examples: - default: &741 + default: &740 value: - ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -61690,7 +64347,7 @@ paths: application/json: schema: type: array - items: *385 + items: *384 examples: default: value: @@ -61789,7 +64446,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/billing/billing#get-github-advanced-security-active-committers-for-an-organization parameters: - *87 - - *439 + - *438 - *17 - *19 responses: @@ -61797,9 +64454,9 @@ paths: description: Success content: application/json: - schema: *440 + schema: *439 examples: - default: *441 + default: *440 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -61945,9 +64602,9 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 examples: - default: *293 + default: *292 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -62016,7 +64673,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#enable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: Response @@ -62039,7 +64696,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/orgs#disable-a-selected-repository-for-immutable-releases-in-an-organization parameters: - *87 - - *273 + - *272 responses: '204': description: Response @@ -62082,7 +64739,7 @@ paths: type: array items: *144 examples: - default: *442 + default: *441 headers: Link: *45 x-github: @@ -62131,6 +64788,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. required: - name - network_settings_ids @@ -62227,6 +64897,19 @@ paths: must be specified in the list. items: type: string + failover_network_settings_ids: + type: array + minItems: 0 + maxItems: 1 + description: A list of identifiers of the failover network settings + resources to use for the network configuration. Exactly one resource + identifier must be specified in the list. + items: + type: string + failover_network_enabled: + type: boolean + description: Indicates whether the failover network resource is + enabled. examples: default: value: @@ -62285,15 +64968,15 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/orgs/network-configurations#get-a-hosted-compute-network-settings-resource-for-an-organization parameters: - *87 - - *443 + - *442 responses: '200': description: Response content: application/json: - schema: *444 + schema: *443 examples: - default: *445 + default: *444 headers: Link: *45 x-github: @@ -62331,7 +65014,7 @@ paths: description: Response content: application/json: - schema: &456 + schema: &455 title: GroupMapping description: External Groups to be mapped to a team for membership type: object @@ -62383,7 +65066,7 @@ paths: group_description: Another group of Developers working on AzureAD SAML SSO examples: - default: &457 + default: &456 value: groups: - group_id: '123' @@ -62507,9 +65190,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: *386 + default: *385 headers: Link: *45 '403': *27 @@ -62603,7 +65286,7 @@ paths: description: Response content: application/json: - schema: &446 + schema: &445 title: Full Team description: Groups of organization members that gives permissions on specified repositories. @@ -62677,7 +65360,7 @@ paths: parent: anyOf: - type: 'null' - - *385 + - *384 members_count: type: integer examples: @@ -63002,7 +65685,7 @@ paths: - repos_count - organization examples: - default: &447 + default: &446 value: id: 1 node_id: MDQ6VGVhbTE= @@ -63079,9 +65762,9 @@ paths: description: Response content: application/json: - schema: *446 + schema: *445 examples: - default: *447 + default: *446 '404': *6 x-github: githubCloudOnly: false @@ -63166,16 +65849,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *446 + schema: *445 examples: - default: *447 + default: *446 '201': description: Response content: application/json: - schema: *446 + schema: *445 examples: - default: *447 + default: *446 '404': *6 '422': *15 '403': *27 @@ -63205,7 +65888,7 @@ paths: responses: '204': description: Response - '422': &450 + '422': &449 description: Unprocessable entity if you attempt to modify an enterprise team at the organization level. x-github: @@ -63234,10 +65917,10 @@ paths: description: Response content: application/json: - schema: *448 + schema: *447 examples: - default: *449 - '422': *450 + default: *448 + '422': *449 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -63281,10 +65964,10 @@ paths: description: Response content: application/json: - schema: *451 + schema: *450 examples: - default: *452 - '422': *450 + default: *451 + '422': *449 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -63308,7 +65991,7 @@ paths: responses: '204': description: Response - '422': *450 + '422': *449 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -63340,12 +66023,12 @@ paths: application/json: schema: type: array - items: *366 + items: *365 examples: - default: *367 + default: *366 headers: Link: *45 - '422': *450 + '422': *449 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -63427,7 +66110,7 @@ paths: description: Response content: application/json: - schema: &453 + schema: &452 title: Team Membership description: Team Membership type: object @@ -63455,7 +66138,7 @@ paths: - state - url examples: - response-if-user-is-a-team-maintainer: &783 + response-if-user-is-a-team-maintainer: &782 summary: Response if user is a team maintainer value: url: https://api.github.com/teams/1/memberships/octocat @@ -63518,9 +66201,9 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: - response-if-users-membership-with-team-is-now-pending: &784 + response-if-users-membership-with-team-is-now-pending: &783 summary: Response if user's membership with team is now pending value: url: https://api.github.com/teams/1/memberships/octocat @@ -63594,9 +66277,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 x-github: @@ -63627,14 +66310,14 @@ paths: parameters: - *87 - *214 + - *453 - *454 - - *455 responses: '200': description: Alternative response with repository permissions content: application/json: - schema: &785 + schema: &784 title: Team Repository description: A team's access to a repository. type: object @@ -64277,8 +66960,8 @@ paths: parameters: - *87 - *214 + - *453 - *454 - - *455 requestBody: required: false content: @@ -64325,8 +67008,8 @@ paths: parameters: - *87 - *214 + - *453 - *454 - - *455 responses: '204': description: Response @@ -64359,10 +67042,10 @@ paths: description: Response content: application/json: - schema: *456 + schema: *455 examples: - default: *457 - '422': *450 + default: *456 + '422': *449 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -64428,7 +67111,7 @@ paths: description: Response content: application/json: - schema: *456 + schema: *455 examples: default: value: @@ -64440,7 +67123,7 @@ paths: group_name: Octocat docs members group_description: The people who make your octoworld come to life. - '422': *450 + '422': *449 x-github: githubCloudOnly: true enabledForGitHubApps: false @@ -64472,9 +67155,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - response-if-child-teams-exist: &786 + response-if-child-teams-exist: &785 value: - id: 2 node_id: MDQ6VGVhbTI= @@ -64628,7 +67311,7 @@ paths: resources: type: object properties: - core: &458 + core: &457 title: Rate Limit type: object properties: @@ -64645,21 +67328,21 @@ paths: - remaining - reset - used - graphql: *458 - search: *458 - code_search: *458 - source_import: *458 - integration_manifest: *458 - code_scanning_upload: *458 - actions_runner_registration: *458 - scim: *458 - dependency_snapshots: *458 - dependency_sbom: *458 - code_scanning_autofix: *458 + graphql: *457 + search: *457 + code_search: *457 + source_import: *457 + integration_manifest: *457 + code_scanning_upload: *457 + actions_runner_registration: *457 + scim: *457 + dependency_snapshots: *457 + dependency_sbom: *457 + code_scanning_autofix: *457 required: - core - search - rate: *458 + rate: *457 required: - rate - resources @@ -64764,14 +67447,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *459 + schema: *458 examples: default-response: summary: Default response @@ -65280,7 +67963,7 @@ paths: status: disabled '403': *27 '404': *6 - '301': *460 + '301': *459 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -65298,8 +67981,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#update-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: false content: @@ -65601,10 +68284,10 @@ paths: description: Response content: application/json: - schema: *459 + schema: *458 examples: - default: *461 - '307': &462 + default: *460 + '307': &461 description: Temporary Redirect content: application/json: @@ -65633,8 +68316,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#delete-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -65656,7 +68339,7 @@ paths: value: message: Organization members cannot delete repositories. documentation_url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#delete-a-repository - '307': *462 + '307': *461 '404': *6 '409': *119 x-github: @@ -65680,11 +68363,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#list-artifacts-for-a-repository parameters: + - *453 - *454 - - *455 - *17 - *19 - - &479 + - &478 name: name description: The name field of an artifact. When specified, only artifacts with this name will be returned. @@ -65707,7 +68390,7 @@ paths: type: integer artifacts: type: array - items: &463 + items: &462 title: Artifact description: An artifact type: object @@ -65802,7 +68485,7 @@ paths: - expires_at - updated_at examples: - default: &480 + default: &479 value: total_count: 2 artifacts: @@ -65863,9 +68546,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#get-an-artifact parameters: + - *453 - *454 - - *455 - - &464 + - &463 name: artifact_id description: The unique identifier of the artifact. in: path @@ -65877,7 +68560,7 @@ paths: description: Response content: application/json: - schema: *463 + schema: *462 examples: default: value: @@ -65915,9 +68598,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#delete-an-artifact parameters: + - *453 - *454 - - *455 - - *464 + - *463 responses: '204': description: Response @@ -65941,9 +68624,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#download-an-artifact parameters: + - *453 - *454 - - *455 - - *464 + - *463 - name: archive_format in: path required: true @@ -65957,7 +68640,7 @@ paths: example: https://pipelines.actions.githubusercontent.com/OhgS4QRKqmgx7bKC27GKU83jnQjyeqG8oIMTge8eqtheppcmw8/_apis/pipelines/1/runs/176/signedlogcontent?urlExpires=2020-01-24T18%3A10%3A31.5729946Z&urlSigningMethod=HMACV1&urlSignature=agG73JakPYkHrh06seAkvmH7rBR4Ji4c2%2B6a2ejYh3E%3D schema: type: string - '410': &641 + '410': &640 description: Gone content: application/json: @@ -65982,14 +68665,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-retention-limit-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: &465 + schema: &464 title: Actions cache retention limit for a repository description: GitHub Actions cache retention policy for a repository. type: object @@ -66023,13 +68706,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#set-github-actions-cache-retention-limit-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: application/json: - schema: *465 + schema: *464 examples: selected_actions: *42 responses: @@ -66058,14 +68741,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-storage-limit-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: &466 + schema: &465 title: Actions cache storage limit for a repository description: GitHub Actions cache storage policy for a repository. type: object @@ -66099,13 +68782,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#set-github-actions-cache-storage-limit-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: application/json: - schema: *466 + schema: *465 examples: selected_actions: *44 responses: @@ -66136,14 +68819,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#get-github-actions-cache-usage-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *467 + schema: *466 examples: default: value: @@ -66169,11 +68852,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#list-github-actions-caches-for-a-repository parameters: + - *453 - *454 - - *455 - *17 - *19 - - &468 + - &467 name: ref description: The full Git reference for narrowing down the cache. The `ref` for a branch should be formatted as `refs/heads/`. To reference @@ -66207,7 +68890,7 @@ paths: description: Response content: application/json: - schema: &469 + schema: &468 title: Repository actions caches description: Repository actions caches type: object @@ -66257,7 +68940,7 @@ paths: - total_count - actions_caches examples: - default: &470 + default: &469 value: total_count: 1 actions_caches: @@ -66289,23 +68972,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#delete-github-actions-caches-for-a-repository-using-a-cache-key parameters: + - *453 - *454 - - *455 - name: key description: A key for identifying the cache. in: query required: true schema: type: string - - *468 + - *467 responses: '200': description: Response content: application/json: - schema: *469 + schema: *468 examples: - default: *470 + default: *469 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -66325,8 +69008,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/cache#delete-a-github-actions-cache-for-a-repository-using-a-cache-id parameters: + - *453 - *454 - - *455 - name: cache_id description: The unique identifier of the GitHub Actions cache. in: path @@ -66357,9 +69040,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#get-a-job-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - &471 + - &470 name: job_id description: The unique identifier of the job. in: path @@ -66371,7 +69054,7 @@ paths: description: Response content: application/json: - schema: &483 + schema: &482 title: Job description: Information of a job execution in a workflow run type: object @@ -66718,9 +69401,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#download-job-logs-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - *471 + - *470 responses: '302': description: Response @@ -66748,9 +69431,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-job-from-a-workflow-run parameters: + - *453 - *454 - - *455 - - *471 + - *470 requestBody: required: false content: @@ -66772,7 +69455,7 @@ paths: description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -66796,8 +69479,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#get-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Status response @@ -66847,8 +69530,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/oidc#set-the-customization-template-for-an-oidc-subject-claim-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -66882,7 +69565,7 @@ paths: description: Empty response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -66911,8 +69594,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-repository-organization-secrets parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -66930,7 +69613,7 @@ paths: type: integer secrets: type: array - items: &485 + items: &484 title: Actions Secret description: Set secrets for GitHub Actions. type: object @@ -66951,7 +69634,7 @@ paths: - created_at - updated_at examples: - default: &486 + default: &485 value: total_count: 2 secrets: @@ -66984,9 +69667,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-repository-organization-variables parameters: + - *453 - *454 - - *455 - - *472 + - *471 - *19 responses: '200': @@ -67003,7 +69686,7 @@ paths: type: integer variables: type: array - items: &489 + items: &488 title: Actions Variable type: object properties: @@ -67037,7 +69720,7 @@ paths: - created_at - updated_at examples: - default: &490 + default: &489 value: total_count: 2 variables: @@ -67070,8 +69753,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-github-actions-permissions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -67080,11 +69763,11 @@ paths: schema: type: object properties: - enabled: &473 + enabled: &472 type: boolean description: Whether GitHub Actions is enabled on the repository. allowed_actions: *60 - selected_actions_url: *266 + selected_actions_url: *265 sha_pinning_required: *61 required: - enabled @@ -67115,8 +69798,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-github-actions-permissions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -67127,7 +69810,7 @@ paths: schema: type: object properties: - enabled: *473 + enabled: *472 allowed_actions: *60 sha_pinning_required: *61 required: @@ -67160,14 +69843,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: &474 + schema: &473 type: object properties: access_level: @@ -67185,7 +69868,7 @@ paths: required: - access_level examples: - default: &475 + default: &474 value: access_level: organization x-github: @@ -67210,15 +69893,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-the-level-of-access-for-workflows-outside-of-the-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: application/json: - schema: *474 + schema: *473 examples: - default: *475 + default: *474 responses: '204': description: Response @@ -67242,14 +69925,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-artifact-and-log-retention-settings-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *268 + schema: *267 examples: default: value: @@ -67273,8 +69956,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-artifact-and-log-retention-settings-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Empty response for successful settings update @@ -67284,7 +69967,7 @@ paths: required: true content: application/json: - schema: *269 + schema: *268 examples: default: summary: Set retention days @@ -67308,8 +69991,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -67317,7 +70000,7 @@ paths: application/json: schema: *62 examples: - default: *270 + default: *269 '404': *6 x-github: enabledForGitHubApps: true @@ -67336,8 +70019,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-fork-pr-contributor-approval-permissions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -67371,14 +70054,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *271 + schema: *270 examples: default: *63 '403': *27 @@ -67400,13 +70083,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-private-repo-fork-pr-workflow-settings-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: application/json: - schema: *272 + schema: *271 examples: default: *63 responses: @@ -67432,8 +70115,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -67464,8 +70147,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-allowed-actions-and-reusable-workflows-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -67497,14 +70180,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#get-default-workflow-permissions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *275 + schema: *274 examples: default: *69 x-github: @@ -67527,8 +70210,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/permissions#set-default-workflow-permissions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Success response @@ -67539,7 +70222,7 @@ paths: required: true content: application/json: - schema: *276 + schema: *275 examples: default: *69 x-github: @@ -67568,8 +70251,8 @@ paths: in: query schema: type: string + - *453 - *454 - - *455 - *17 - *19 responses: @@ -67613,8 +70296,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-runner-applications-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -67622,9 +70305,9 @@ paths: application/json: schema: type: array - items: *280 + items: *279 examples: - default: *281 + default: *280 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67646,8 +70329,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-configuration-for-a-just-in-time-runner-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -67690,7 +70373,7 @@ paths: - no-gpu work_folder: _work responses: - '201': *282 + '201': *281 '404': *6 '422': *7 '409': *119 @@ -67721,8 +70404,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-registration-token-for-a-repository parameters: + - *453 - *454 - - *455 responses: '201': description: Response @@ -67730,7 +70413,7 @@ paths: application/json: schema: *79 examples: - default: *283 + default: *282 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67758,8 +70441,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#create-a-remove-token-for-a-repository parameters: + - *453 - *454 - - *455 responses: '201': description: Response @@ -67767,7 +70450,7 @@ paths: application/json: schema: *79 examples: - default: *284 + default: *283 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67789,8 +70472,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#get-a-self-hosted-runner-for-a-repository parameters: + - *453 - *454 - - *455 - *75 responses: '200': @@ -67799,7 +70482,7 @@ paths: application/json: schema: *76 examples: - default: *285 + default: *284 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -67820,8 +70503,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#delete-a-self-hosted-runner-from-a-repository parameters: + - *453 - *454 - - *455 - *75 responses: '204': @@ -67848,8 +70531,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#list-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *453 - *454 - - *455 - *75 responses: '200': *81 @@ -67874,8 +70557,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#add-custom-labels-to-a-self-hosted-runner-for-a-repository parameters: + - *453 - *454 - - *455 - *75 requestBody: required: true @@ -67924,8 +70607,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#set-custom-labels-for-a-self-hosted-runner-for-a-repository parameters: + - *453 - *454 - - *455 - *75 requestBody: required: true @@ -67975,11 +70658,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-all-custom-labels-from-a-self-hosted-runner-for-a-repository parameters: + - *453 - *454 - - *455 - *75 responses: - '200': *286 + '200': *285 '404': *6 x-github: githubCloudOnly: false @@ -68006,10 +70689,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/self-hosted-runners#remove-a-custom-label-from-a-self-hosted-runner-for-a-repository parameters: + - *453 - *454 - - *455 - *75 - - *287 + - *286 responses: '200': *81 '404': *6 @@ -68037,9 +70720,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#list-workflow-runs-for-a-repository parameters: + - *453 - *454 - - *455 - - &493 + - &492 name: actor description: Returns someone's workflow runs. Use the login for the user who created the `push` associated with the check suite or workflow run. @@ -68047,7 +70730,7 @@ paths: required: false schema: type: string - - &494 + - &493 name: branch description: Returns workflow runs associated with a branch. Use the name of the branch of the `push`. @@ -68055,7 +70738,7 @@ paths: required: false schema: type: string - - &495 + - &494 name: event description: Returns workflow run triggered by the event you specify. For example, `push`, `pull_request` or `issue`. For more information, see "[Events @@ -68064,7 +70747,7 @@ paths: required: false schema: type: string - - &496 + - &495 name: status description: Returns workflow runs with the check run `status` or `conclusion` that you specify. For example, a conclusion can be `success` or a status @@ -68091,7 +70774,7 @@ paths: - pending - *17 - *19 - - &497 + - &496 name: created description: Returns workflow runs created within the given date-time range. For more information on the syntax, see "[Understanding the search syntax](https://docs.github.com/enterprise-cloud@latest//search-github/getting-started-with-searching-on-github/understanding-the-search-syntax#query-for-dates)." @@ -68100,7 +70783,7 @@ paths: schema: type: string format: date-time - - &476 + - &475 name: exclude_pull_requests description: If `true` pull requests are omitted from the response (empty array). @@ -68109,13 +70792,13 @@ paths: schema: type: boolean default: false - - &498 + - &497 name: check_suite_id description: Returns workflow runs with the `check_suite_id` that you specify. in: query schema: type: integer - - &499 + - &498 name: head_sha description: Only returns workflow runs that are associated with the specified `head_sha`. @@ -68138,7 +70821,7 @@ paths: type: integer workflow_runs: type: array - items: &477 + items: &476 title: Workflow Run description: An invocation of a workflow type: object @@ -68316,7 +70999,7 @@ paths: head_commit: anyOf: - type: 'null' - - &521 + - &520 title: Simple Commit description: A commit. type: object @@ -68390,8 +71073,8 @@ paths: - timestamp - author - committer - repository: *279 - head_repository: *279 + repository: *278 + head_repository: *278 head_repository_id: type: integer examples: @@ -68431,7 +71114,7 @@ paths: - workflow_url - pull_requests examples: - default: &500 + default: &499 value: total_count: 1 workflow_runs: @@ -68667,24 +71350,24 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-a-workflow-run parameters: + - *453 - *454 - - *455 - - &478 + - &477 name: run_id description: The unique identifier of the workflow run. in: path required: true schema: type: integer - - *476 + - *475 responses: '200': description: Response content: application/json: - schema: *477 + schema: *476 examples: - default: &481 + default: &480 value: id: 30433642 name: Build @@ -68925,9 +71608,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#delete-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '204': description: Response @@ -68950,9 +71633,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-the-review-history-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '200': description: Response @@ -69080,15 +71763,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#approve-a-workflow-run-for-a-fork-pull-request parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '201': description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -69115,12 +71798,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/artifacts#list-workflow-run-artifacts parameters: + - *453 - *454 - - *455 - - *478 + - *477 - *17 - *19 - - *479 + - *478 - *110 responses: '200': @@ -69137,9 +71820,9 @@ paths: type: integer artifacts: type: array - items: *463 + items: *462 examples: - default: *480 + default: *479 headers: Link: *45 x-github: @@ -69163,25 +71846,25 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-a-workflow-run-attempt parameters: + - *453 - *454 - - *455 - - *478 - - &482 + - *477 + - &481 name: attempt_number description: The attempt number of the workflow run. in: path required: true schema: type: integer - - *476 + - *475 responses: '200': description: Response content: application/json: - schema: *477 + schema: *476 examples: - default: *481 + default: *480 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -69204,10 +71887,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#list-jobs-for-a-workflow-run-attempt parameters: + - *453 - *454 - - *455 - - *478 - - *482 + - *477 + - *481 - *17 - *19 responses: @@ -69225,9 +71908,9 @@ paths: type: integer jobs: type: array - items: *483 + items: *482 examples: - default: &484 + default: &483 value: total_count: 1 jobs: @@ -69340,10 +72023,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#download-workflow-run-attempt-logs parameters: + - *453 - *454 - - *455 - - *478 - - *482 + - *477 + - *481 responses: '302': description: Response @@ -69371,15 +72054,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#cancel-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '202': description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -69406,9 +72089,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#review-custom-deployment-protection-rules-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 requestBody: required: true content: @@ -69475,15 +72158,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#force-cancel-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '202': description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -69510,9 +72193,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-jobs#list-jobs-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 - name: filter description: Filters jobs by their `completed_at` timestamp. `latest` returns jobs from the most recent execution of the workflow run. `all` returns all @@ -69542,9 +72225,9 @@ paths: type: integer jobs: type: array - items: *483 + items: *482 examples: - default: *484 + default: *483 headers: Link: *45 x-github: @@ -69569,9 +72252,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#download-workflow-run-logs parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '302': description: Response @@ -69598,9 +72281,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#delete-workflow-run-logs parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '204': description: Response @@ -69627,9 +72310,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-pending-deployments-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '200': description: Response @@ -69698,7 +72381,7 @@ paths: items: type: object properties: - type: &608 + type: &607 type: string description: The type of reviewer. enum: @@ -69709,7 +72392,7 @@ paths: reviewer: anyOf: - *4 - - *308 + - *307 required: - environment - wait_timer @@ -69784,9 +72467,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#review-pending-deployments-for-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 requestBody: required: true content: @@ -69836,7 +72519,7 @@ paths: application/json: schema: type: array - items: &593 + items: &592 title: Deployment description: A request for a specific ref(branch,sha,tag) to be deployed @@ -69948,7 +72631,7 @@ paths: - created_at - updated_at examples: - default: &594 + default: &593 value: - url: https://api.github.com/repos/octocat/example/deployments/1 id: 1 @@ -70004,9 +72687,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-a-workflow parameters: + - *453 - *454 - - *455 - - *478 + - *477 requestBody: required: false content: @@ -70028,7 +72711,7 @@ paths: description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -70051,9 +72734,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#re-run-failed-jobs-from-a-workflow-run parameters: + - *453 - *454 - - *455 - - *478 + - *477 requestBody: required: false content: @@ -70075,7 +72758,7 @@ paths: description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -70108,9 +72791,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#get-workflow-run-usage parameters: + - *453 - *454 - - *455 - - *478 + - *477 responses: '200': description: Response @@ -70247,8 +72930,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-repository-secrets parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -70266,9 +72949,9 @@ paths: type: integer secrets: type: array - items: *485 + items: *484 examples: - default: *486 + default: *485 headers: Link: *45 x-github: @@ -70293,16 +72976,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-a-repository-public-key parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: *488 + default: *487 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -70324,17 +73007,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 responses: '200': description: Response content: application/json: - schema: *485 + schema: *484 examples: - default: &621 + default: &620 value: name: GH_TOKEN created_at: '2019-08-10T14:59:22Z' @@ -70360,9 +73043,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 requestBody: required: true content: @@ -70393,7 +73076,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -70419,9 +73102,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 responses: '204': description: Response @@ -70446,9 +73129,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-repository-variables parameters: + - *453 - *454 - - *455 - - *472 + - *471 - *19 responses: '200': @@ -70465,9 +73148,9 @@ paths: type: integer variables: type: array - items: *489 + items: *488 examples: - default: *490 + default: *489 headers: Link: *45 x-github: @@ -70490,8 +73173,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-a-repository-variable parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -70518,7 +73201,7 @@ paths: description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -70543,17 +73226,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-a-repository-variable parameters: + - *453 - *454 - - *455 - - *292 + - *291 responses: '200': description: Response content: application/json: - schema: *489 + schema: *488 examples: - default: &622 + default: &621 value: name: USERNAME value: octocat @@ -70579,9 +73262,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-a-repository-variable parameters: + - *453 - *454 - - *455 - - *292 + - *291 requestBody: required: true content: @@ -70623,9 +73306,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-a-repository-variable parameters: + - *453 - *454 - - *455 - - *292 + - *291 responses: '204': description: Response @@ -70650,8 +73333,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#list-repository-workflows parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -70669,7 +73352,7 @@ paths: type: integer workflows: type: array - items: &491 + items: &490 title: Workflow description: A GitHub Actions workflow type: object @@ -70787,9 +73470,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#get-a-workflow parameters: + - *453 - *454 - - *455 - - &492 + - &491 name: workflow_id in: path description: The ID of the workflow. You can also pass the workflow file name @@ -70804,7 +73487,7 @@ paths: description: Response content: application/json: - schema: *491 + schema: *490 examples: default: value: @@ -70837,9 +73520,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#disable-a-workflow parameters: + - *453 - *454 - - *455 - - *492 + - *491 responses: '204': description: Response @@ -70864,9 +73547,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#create-a-workflow-dispatch-event parameters: + - *453 - *454 - - *455 - - *492 + - *491 responses: '204': description: Empty response when `return_run_details` parameter is `false`. @@ -70953,9 +73636,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#enable-a-workflow parameters: + - *453 - *454 - - *455 - - *492 + - *491 responses: '204': description: Response @@ -70982,19 +73665,19 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflow-runs#list-workflow-runs-for-a-workflow parameters: + - *453 - *454 - - *455 + - *491 - *492 - *493 - *494 - *495 - - *496 - *17 - *19 + - *496 + - *475 - *497 - - *476 - *498 - - *499 responses: '200': description: Response @@ -71010,9 +73693,9 @@ paths: type: integer workflow_runs: type: array - items: *477 + items: *476 examples: - default: *500 + default: *499 headers: Link: *45 x-github: @@ -71045,9 +73728,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/workflows#get-workflow-usage parameters: + - *453 - *454 - - *455 - - *492 + - *491 responses: '200': description: Response @@ -71108,8 +73791,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-activities parameters: + - *453 - *454 - - *455 - *110 - *17 - *108 @@ -71277,8 +73960,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#list-assignees parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -71315,8 +73998,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#check-if-a-user-can-be-assigned parameters: + - *453 - *454 - - *455 - name: assignee in: path required: true @@ -71352,8 +74035,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/attestations#create-an-attestation parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -71463,8 +74146,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/attestations#list-attestations parameters: + - *453 - *454 - - *455 - *17 - *108 - *109 @@ -71521,7 +74204,7 @@ paths: initiator: type: string examples: - default: *501 + default: *500 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -71541,8 +74224,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#get-all-autolinks-of-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -71550,7 +74233,7 @@ paths: application/json: schema: type: array - items: &502 + items: &501 title: Autolink reference description: An autolink reference. type: object @@ -71609,8 +74292,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#create-an-autolink-reference-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -71649,9 +74332,9 @@ paths: description: response content: application/json: - schema: *502 + schema: *501 examples: - default: &503 + default: &502 value: id: 1 key_prefix: TICKET- @@ -71682,9 +74365,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#get-an-autolink-reference-of-a-repository parameters: + - *453 - *454 - - *455 - - &504 + - &503 name: autolink_id description: The unique identifier of the autolink. in: path @@ -71696,9 +74379,9 @@ paths: description: Response content: application/json: - schema: *502 + schema: *501 examples: - default: *503 + default: *502 '404': *6 x-github: githubCloudOnly: false @@ -71718,9 +74401,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/autolinks#delete-an-autolink-reference-from-a-repository parameters: + - *453 - *454 - - *455 - - *504 + - *503 responses: '204': description: Response @@ -71744,8 +74427,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-dependabot-security-updates-are-enabled-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response if Dependabot is enabled @@ -71795,8 +74478,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-dependabot-security-updates parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -71817,8 +74500,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-dependabot-security-updates parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -71838,8 +74521,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#list-branches parameters: + - *453 - *454 - - *455 - name: protected description: Setting to `true` returns only branches protected by branch protections or rulesets. When set to `false`, only unprotected branches are returned. @@ -71877,7 +74560,7 @@ paths: - url protected: type: boolean - protection: &506 + protection: &505 title: Branch Protection description: Branch Protection type: object @@ -71920,7 +74603,7 @@ paths: required: - contexts - checks - enforce_admins: &509 + enforce_admins: &508 title: Protected Branch Admin Enforced description: Protected Branch Admin Enforced type: object @@ -71937,7 +74620,7 @@ paths: required: - url - enabled - required_pull_request_reviews: &511 + required_pull_request_reviews: &510 title: Protected Branch Pull Request Review description: Protected Branch Pull Request Review type: object @@ -71959,7 +74642,7 @@ paths: description: The list of teams with review dismissal access. type: array - items: *308 + items: *307 apps: description: The list of apps with review dismissal access. @@ -71991,7 +74674,7 @@ paths: description: The list of teams allowed to bypass pull request requirements. type: array - items: *308 + items: *307 apps: description: The list of apps allowed to bypass pull request requirements. @@ -72021,7 +74704,7 @@ paths: required: - dismiss_stale_reviews - require_code_owner_reviews - restrictions: &508 + restrictions: &507 title: Branch Restriction Policy description: Branch Restriction Policy type: object @@ -72084,7 +74767,7 @@ paths: type: string teams: type: array - items: *308 + items: *307 apps: type: array items: @@ -72314,9 +74997,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#get-a-branch parameters: + - *453 - *454 - - *455 - - &507 + - &506 name: branch description: The name of the branch. Cannot contain wildcard characters. To use wildcard characters in branch names, use [the GraphQL API](https://docs.github.com/enterprise-cloud@latest//graphql). @@ -72330,14 +75013,14 @@ paths: description: Response content: application/json: - schema: &517 + schema: &516 title: Branch With Protection description: Branch With Protection type: object properties: name: type: string - commit: &568 + commit: &567 title: Commit description: Commit type: object @@ -72376,7 +75059,7 @@ paths: author: anyOf: - type: 'null' - - &505 + - &504 title: Git User description: Metaproperties for Git author/committer information. @@ -72398,7 +75081,7 @@ paths: committer: anyOf: - type: 'null' - - *505 + - *504 message: type: string examples: @@ -72422,7 +75105,7 @@ paths: required: - sha - url - verification: &628 + verification: &627 title: Verification type: object properties: @@ -72458,14 +75141,14 @@ paths: author: oneOf: - *4 - - *290 + - *289 type: - 'null' - object committer: oneOf: - *4 - - *290 + - *289 type: - 'null' - object @@ -72502,7 +75185,7 @@ paths: type: integer files: type: array - items: &579 + items: &578 title: Diff Entry description: Diff Entry type: object @@ -72598,7 +75281,7 @@ paths: - self protected: type: boolean - protection: *506 + protection: *505 protection_url: type: string format: uri @@ -72707,7 +75390,7 @@ paths: contexts: [] checks: [] protection_url: https://api.github.com/repos/octocat/Hello-World/branches/main/protection - '301': *460 + '301': *459 '404': *6 x-github: githubCloudOnly: false @@ -72729,15 +75412,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-branch-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *506 + schema: *505 examples: default: value: @@ -72931,9 +75614,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-branch-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -73193,7 +75876,7 @@ paths: url: type: string format: uri - required_status_checks: &514 + required_status_checks: &513 title: Status Check Policy description: Status Check Policy type: object @@ -73274,7 +75957,7 @@ paths: items: *4 teams: type: array - items: *308 + items: *307 apps: type: array items: *5 @@ -73292,7 +75975,7 @@ paths: items: *4 teams: type: array - items: *308 + items: *307 apps: type: array items: *5 @@ -73352,7 +76035,7 @@ paths: additionalProperties: false required: - enabled - restrictions: *508 + restrictions: *507 required_conversation_resolution: type: object properties: @@ -73464,9 +76147,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-branch-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '204': description: Response @@ -73491,17 +76174,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-admin-branch-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *509 + schema: *508 examples: - default: &510 + default: &509 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/enforce_admins enabled: true @@ -73523,17 +76206,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-admin-branch-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *509 + schema: *508 examples: - default: *510 + default: *509 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -73552,9 +76235,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-admin-branch-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '204': description: Response @@ -73579,17 +76262,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-pull-request-review-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *511 + schema: *510 examples: - default: &512 + default: &511 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_pull_request_reviews dismissal_restrictions: @@ -73685,9 +76368,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-pull-request-review-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: false content: @@ -73785,9 +76468,9 @@ paths: description: Response content: application/json: - schema: *511 + schema: *510 examples: - default: *512 + default: *511 '422': *15 x-github: githubCloudOnly: false @@ -73808,9 +76491,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-pull-request-review-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '204': description: Response @@ -73837,17 +76520,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-commit-signature-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *509 + schema: *508 examples: - default: &513 + default: &512 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_signatures enabled: true @@ -73870,17 +76553,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#create-commit-signature-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *509 + schema: *508 examples: - default: *513 + default: *512 '404': *6 x-github: githubCloudOnly: false @@ -73900,9 +76583,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-commit-signature-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '204': description: Response @@ -73927,17 +76610,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-status-checks-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *514 + schema: *513 examples: - default: &515 + default: &514 value: url: https://api.github.com/repos/octocat/Hello-World/branches/master/protection/required_status_checks strict: true @@ -73963,9 +76646,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#update-status-check-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: false content: @@ -74017,9 +76700,9 @@ paths: description: Response content: application/json: - schema: *514 + schema: *513 examples: - default: *515 + default: *514 '404': *6 '422': *15 x-github: @@ -74041,9 +76724,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-status-check-protection parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '204': description: Response @@ -74067,9 +76750,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-all-status-check-contexts parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response @@ -74103,9 +76786,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-status-check-contexts parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: false content: @@ -74172,9 +76855,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-status-check-contexts parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: false content: @@ -74238,9 +76921,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-status-check-contexts parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: content: application/json: @@ -74306,15 +76989,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response content: application/json: - schema: *508 + schema: *507 examples: default: value: @@ -74405,9 +77088,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#delete-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '204': description: Response @@ -74430,9 +77113,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-apps-with-access-to-the-protected-branch parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response @@ -74442,7 +77125,7 @@ paths: type: array items: *5 examples: - default: &516 + default: &515 value: - id: 1 slug: octoapp @@ -74499,9 +77182,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-app-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -74535,7 +77218,7 @@ paths: type: array items: *5 examples: - default: *516 + default: *515 '422': *15 x-github: githubCloudOnly: false @@ -74556,9 +77239,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-app-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -74592,7 +77275,7 @@ paths: type: array items: *5 examples: - default: *516 + default: *515 '422': *15 x-github: githubCloudOnly: false @@ -74613,9 +77296,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-app-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -74649,7 +77332,7 @@ paths: type: array items: *5 examples: - default: *516 + default: *515 '422': *15 x-github: githubCloudOnly: false @@ -74671,9 +77354,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-teams-with-access-to-the-protected-branch parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response @@ -74681,9 +77364,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: *386 + default: *385 '404': *6 x-github: githubCloudOnly: false @@ -74703,9 +77386,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-team-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: false content: @@ -74741,9 +77424,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: *386 + default: *385 '422': *15 x-github: githubCloudOnly: false @@ -74764,9 +77447,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-team-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: false content: @@ -74802,9 +77485,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: *386 + default: *385 '422': *15 x-github: githubCloudOnly: false @@ -74825,9 +77508,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-team-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: content: application/json: @@ -74862,9 +77545,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: *386 + default: *385 '422': *15 x-github: githubCloudOnly: false @@ -74886,9 +77569,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#get-users-with-access-to-the-protected-branch parameters: + - *453 - *454 - - *455 - - *507 + - *506 responses: '200': description: Response @@ -74922,9 +77605,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#add-user-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -74982,9 +77665,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#set-user-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -75042,9 +77725,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branch-protection#remove-user-access-restrictions parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -75104,9 +77787,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#rename-a-branch parameters: + - *453 - *454 - - *455 - - *507 + - *506 requestBody: required: true content: @@ -75128,7 +77811,7 @@ paths: description: Response content: application/json: - schema: *517 + schema: *516 examples: default: value: @@ -75242,8 +77925,8 @@ paths: category: repos subcategory: bypass-requests parameters: + - *453 - *454 - - *455 - *103 - *104 - *105 @@ -75257,9 +77940,9 @@ paths: application/json: schema: type: array - items: *303 + items: *302 examples: - default: *304 + default: *303 '404': *6 '500': *38 "/repos/{owner}/{repo}/bypass-requests/push-rules/{bypass_request_number}": @@ -75279,8 +77962,8 @@ paths: category: repos subcategory: bypass-requests parameters: + - *453 - *454 - - *455 - name: bypass_request_number in: path required: true @@ -75294,7 +77977,7 @@ paths: description: Response content: application/json: - schema: *303 + schema: *302 examples: default: value: @@ -75353,8 +78036,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: + - *453 - *454 - - *455 - *103 - *104 - *105 @@ -75368,9 +78051,9 @@ paths: application/json: schema: type: array - items: *306 + items: *305 examples: - default: *307 + default: *306 '404': *6 '403': *27 '500': *38 @@ -75394,8 +78077,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: + - *453 - *454 - - *455 - name: bypass_request_number in: path required: true @@ -75407,7 +78090,7 @@ paths: description: A single bypass request. content: application/json: - schema: *306 + schema: *305 examples: default: value: @@ -75465,8 +78148,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: + - *453 - *454 - - *455 - name: bypass_request_number in: path required: true @@ -75537,8 +78220,8 @@ paths: category: secret-scanning subcategory: delegated-bypass parameters: + - *453 - *454 - - *455 - name: bypass_response_id in: path required: true @@ -75571,8 +78254,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#create-a-check-run parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -75851,7 +78534,7 @@ paths: description: Response content: application/json: - schema: &518 + schema: &517 title: CheckRun description: A check performed on the code of a given code change type: object @@ -75987,7 +78670,7 @@ paths: check. type: array items: *222 - deployment: &846 + deployment: &845 title: Deployment description: A deployment created as the result of an Actions check run from a workflow that references an environment @@ -76274,9 +78957,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#get-a-check-run parameters: + - *453 - *454 - - *455 - - &519 + - &518 name: check_run_id description: The unique identifier of the check run. in: path @@ -76288,9 +78971,9 @@ paths: description: Response content: application/json: - schema: *518 + schema: *517 examples: - default: &520 + default: &519 value: id: 4 head_sha: ce587453ced02b1526dfb4cb910479d431683101 @@ -76390,9 +79073,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#update-a-check-run parameters: + - *453 - *454 - - *455 - - *519 + - *518 requestBody: required: true content: @@ -76632,9 +79315,9 @@ paths: description: Response content: application/json: - schema: *518 + schema: *517 examples: - default: *520 + default: *519 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -76654,9 +79337,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-run-annotations parameters: + - *453 - *454 - - *455 - - *519 + - *518 - *17 - *19 responses: @@ -76766,15 +79449,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#rerequest-a-check-run parameters: + - *453 - *454 - - *455 - - *519 + - *518 responses: '201': description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -76812,8 +79495,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#create-a-check-suite parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -76835,7 +79518,7 @@ paths: description: Response when the suite already exists content: application/json: - schema: &522 + schema: &521 title: CheckSuite description: A suite of checks performed on the code of a given code change @@ -76922,7 +79605,7 @@ paths: anyOf: - type: 'null' - *5 - repository: *279 + repository: *278 created_at: type: - string @@ -76933,7 +79616,7 @@ paths: - string - 'null' format: date-time - head_commit: *521 + head_commit: *520 latest_check_runs_count: type: integer check_runs_url: @@ -76961,7 +79644,7 @@ paths: - check_runs_url - pull_requests examples: - default: &523 + default: &522 value: id: 5 node_id: MDEwOkNoZWNrU3VpdGU1 @@ -77252,9 +79935,9 @@ paths: description: Response when the suite was created content: application/json: - schema: *522 + schema: *521 examples: - default: *523 + default: *522 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77273,8 +79956,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#update-repository-preferences-for-check-suites parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -77335,7 +80018,7 @@ paths: required: - app_id - setting - repository: *279 + repository: *278 examples: default: value: @@ -77583,9 +80266,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#get-a-check-suite parameters: + - *453 - *454 - - *455 - - &524 + - &523 name: check_suite_id description: The unique identifier of the check suite. in: path @@ -77597,9 +80280,9 @@ paths: description: Response content: application/json: - schema: *522 + schema: *521 examples: - default: *523 + default: *522 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -77622,17 +80305,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-runs-in-a-check-suite parameters: + - *453 - *454 - - *455 - - *524 - - &574 + - *523 + - &573 name: check_name description: Returns check runs with the specified `name`. in: query required: false schema: type: string - - &575 + - &574 name: status description: Returns check runs with the specified `status`. in: query @@ -77671,9 +80354,9 @@ paths: type: integer check_runs: type: array - items: *518 + items: *517 examples: - default: &576 + default: &575 value: total_count: 1 check_runs: @@ -77775,15 +80458,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#rerequest-a-check-suite parameters: + - *453 - *454 - - *455 - - *524 + - *523 responses: '201': description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -77810,21 +80493,21 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-alerts-for-a-repository parameters: + - *453 - *454 - - *455 + - *311 - *312 - - *313 - *19 - *17 - - &540 + - &539 name: ref description: The Git reference for the results you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. in: query required: false - schema: *525 - - &541 + schema: *524 + - &540 name: pr description: The number of the pull request for the results you want to list. in: query @@ -77849,13 +80532,13 @@ paths: be returned. in: query required: false - schema: *314 + schema: *313 - name: severity description: If specified, only code scanning alerts with this severity will be returned. in: query required: false - schema: *526 + schema: *525 - name: assignees description: | Filter alerts by assignees. Provide a comma-separated list of user handles (e.g., `octocat` or `octocat,hubot`). @@ -77879,7 +80562,7 @@ paths: updated_at: *134 url: *131 html_url: *132 - instances_url: *527 + instances_url: *526 state: *113 fixed_at: *136 dismissed_by: @@ -77887,11 +80570,11 @@ paths: - type: 'null' - *4 dismissed_at: *135 - dismissed_reason: *528 - dismissed_comment: *529 - rule: *530 - tool: *531 - most_recent_instance: *532 + dismissed_reason: *527 + dismissed_comment: *528 + rule: *529 + tool: *530 + most_recent_instance: *531 dismissal_approved_by: anyOf: - type: 'null' @@ -78014,7 +80697,7 @@ paths: classifications: [] instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/3/instances '304': *35 - '403': &533 + '403': &532 description: Response if GitHub Advanced Security is not enabled for this repository content: @@ -78041,9 +80724,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-alert parameters: + - *453 - *454 - - *455 - - &534 + - &533 name: alert_number in: path description: The number that identifies an alert. You can find this at the @@ -78057,7 +80740,7 @@ paths: description: Response content: application/json: - schema: &535 + schema: &534 type: object properties: number: *126 @@ -78065,7 +80748,7 @@ paths: updated_at: *134 url: *131 html_url: *132 - instances_url: *527 + instances_url: *526 state: *113 fixed_at: *136 dismissed_by: @@ -78073,8 +80756,8 @@ paths: - type: 'null' - *4 dismissed_at: *135 - dismissed_reason: *528 - dismissed_comment: *529 + dismissed_reason: *527 + dismissed_comment: *528 rule: type: object properties: @@ -78136,8 +80819,8 @@ paths: - 'null' description: A link to the documentation for the rule used to detect the alert. - tool: *531 - most_recent_instance: *532 + tool: *530 + most_recent_instance: *531 dismissal_approved_by: anyOf: - type: 'null' @@ -78233,7 +80916,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '304': *35 - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -78253,9 +80936,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#update-a-code-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 requestBody: required: true content: @@ -78270,8 +80953,8 @@ paths: enum: - open - dismissed - dismissed_reason: *528 - dismissed_comment: *529 + dismissed_reason: *527 + dismissed_comment: *528 create_request: type: boolean description: If `true`, attempt to create an alert dismissal request. @@ -78299,7 +80982,7 @@ paths: description: Response content: application/json: - schema: *535 + schema: *534 examples: default: value: @@ -78375,7 +81058,7 @@ paths: - test instances_url: https://api.github.com/repos/octocat/hello-world/code-scanning/alerts/42/instances '400': *14 - '403': &539 + '403': &538 description: Response if the repository is archived or if GitHub Advanced Security is not enabled for this repository content: @@ -78402,15 +81085,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 responses: '200': description: Response content: application/json: - schema: &536 + schema: &535 type: object properties: status: @@ -78437,13 +81120,13 @@ paths: - description - started_at examples: - default: &537 + default: &536 value: status: success description: This fixes an XSS vulnerability by escaping the user input. started_at: '2024-02-14T12:29:18Z' - '400': &538 + '400': &537 description: Bad Request content: application/json: @@ -78454,7 +81137,7 @@ paths: message: The alert_number is not valid documentation_url: https://docs.github.com/rest/code-scanning/code-scanning#get-the-status-of-an-autofix-for-a-code-scanning-alert status: '400' - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -78479,29 +81162,29 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#create-an-autofix-for-a-code-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 responses: '200': description: OK content: application/json: - schema: *536 + schema: *535 examples: - default: *537 + default: *536 '202': description: Accepted content: application/json: - schema: *536 + schema: *535 examples: default: value: status: pending description: started_at: '2024-02-14T12:29:18Z' - '400': *538 + '400': *537 '403': description: Response if the repository is archived, if GitHub Advanced Security is not enabled for this repository or if rate limit is exceeded @@ -78533,9 +81216,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#commit-an-autofix-for-a-code-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 requestBody: required: false content: @@ -78581,8 +81264,8 @@ paths: value: target_ref: refs/heads/main sha: 178f4f6090b3fccad4a65b3e83d076a622d59652 - '400': *538 - '403': *539 + '400': *537 + '403': *538 '404': *6 '422': description: Unprocessable Entity @@ -78606,13 +81289,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-instances-of-a-code-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 - *19 - *17 + - *539 - *540 - - *541 responses: '200': description: Response @@ -78623,10 +81306,10 @@ paths: items: type: object properties: - ref: *525 - analysis_key: *542 - environment: *543 - category: *544 + ref: *524 + analysis_key: *541 + environment: *542 + category: *543 state: type: - string @@ -78643,7 +81326,7 @@ paths: properties: text: type: string - location: *545 + location: *544 html_url: type: string classifications: @@ -78651,7 +81334,7 @@ paths: description: |- Classifications that have been applied to the file that triggered the alert. For example identifying it as documentation, or a generated file. - items: *546 + items: *545 examples: default: value: @@ -78688,7 +81371,7 @@ paths: end_column: 50 classifications: - source - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -78722,25 +81405,25 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-code-scanning-analyses-for-a-repository parameters: + - *453 - *454 - - *455 + - *311 - *312 - - *313 - *19 - *17 - - *541 + - *540 - name: ref in: query description: The Git reference for the analyses you want to list. The `ref` for a branch can be formatted either as `refs/heads/` or simply ``. To reference a pull request use `refs/pull//merge`. required: false - schema: *525 + schema: *524 - name: sarif_id in: query description: Filter analyses belonging to the same SARIF upload. required: false - schema: &547 + schema: &546 type: string description: An identifier for the upload. examples: @@ -78762,23 +81445,23 @@ paths: application/json: schema: type: array - items: &548 + items: &547 type: object properties: - ref: *525 - commit_sha: &556 + ref: *524 + commit_sha: &555 description: The SHA of the commit to which the analysis you are uploading relates. type: string minLength: 40 maxLength: 40 pattern: "^[0-9a-fA-F]+$" - analysis_key: *542 + analysis_key: *541 environment: type: string description: Identifies the variable values associated with the environment in which this analysis was performed. - category: *544 + category: *543 error: type: string examples: @@ -78803,8 +81486,8 @@ paths: description: The REST API URL of the analysis resource. format: uri readOnly: true - sarif_id: *547 - tool: *531 + sarif_id: *546 + tool: *530 deletable: type: boolean warning: @@ -78866,7 +81549,7 @@ paths: version: 1.2.0 deletable: true warning: '' - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -78902,8 +81585,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-analysis-for-a-repository parameters: + - *453 - *454 - - *455 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -78916,7 +81599,7 @@ paths: description: Response content: application/json: - schema: *548 + schema: *547 examples: response: summary: application/json response @@ -78970,7 +81653,7 @@ paths: properties: - github/alertNumber: 2 - github/alertUrl: https://api.github.com/repos/monalisa/monalisa/code-scanning/alerts/2 - '403': *533 + '403': *532 '404': *6 '422': description: Response if analysis could not be processed @@ -79057,8 +81740,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#delete-a-code-scanning-analysis-from-a-repository parameters: + - *453 - *454 - - *455 - name: analysis_id in: path description: The ID of the analysis, as returned from the `GET /repos/{owner}/{repo}/code-scanning/analyses` @@ -79114,7 +81797,7 @@ paths: next_analysis_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41 confirm_delete_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses/41?confirm_delete '400': *14 - '403': *539 + '403': *538 '404': *6 '503': *192 x-github: @@ -79136,8 +81819,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#list-codeql-databases-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -79145,7 +81828,7 @@ paths: application/json: schema: type: array - items: &549 + items: &548 title: CodeQL Database description: A CodeQL database. type: object @@ -79257,7 +81940,7 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/ruby commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -79286,8 +81969,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-codeql-database-for-a-repository parameters: + - *453 - *454 - - *455 - name: language in: path description: The language of the CodeQL database. @@ -79299,7 +81982,7 @@ paths: description: Response content: application/json: - schema: *549 + schema: *548 examples: default: value: @@ -79331,9 +82014,9 @@ paths: updated_at: '2022-09-12T12:14:32Z' url: https://api.github.com/repos/octocat/Hello-World/code-scanning/codeql/databases/java commit_oid: 1927de39fefa25a9d0e64e3f540ff824a72f538c - '302': &581 + '302': &580 description: Found - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -79355,8 +82038,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#delete-a-codeql-database parameters: + - *453 - *454 - - *455 - name: language in: path description: The language of the CodeQL database. @@ -79366,7 +82049,7 @@ paths: responses: '204': description: Response - '403': *539 + '403': *538 '404': *6 '503': *192 x-github: @@ -79394,8 +82077,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#create-a-codeql-variant-analysis parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -79404,7 +82087,7 @@ paths: type: object additionalProperties: false properties: - language: &550 + language: &549 type: string description: The language targeted by the CodeQL query enum: @@ -79484,7 +82167,7 @@ paths: description: Variant analysis submitted for processing content: application/json: - schema: &554 + schema: &553 title: Variant Analysis description: A run of a CodeQL query against one or more repositories. type: object @@ -79494,7 +82177,7 @@ paths: description: The ID of the variant analysis. controller_repo: *120 actor: *4 - query_language: *550 + query_language: *549 query_pack_url: type: string description: The download url for the query pack. @@ -79542,7 +82225,7 @@ paths: items: type: object properties: - repository: &551 + repository: &550 title: Repository Identifier description: Repository Identifier type: object @@ -79584,7 +82267,7 @@ paths: - private - stargazers_count - updated_at - analysis_status: &555 + analysis_status: &554 type: string description: The new status of the CodeQL variant analysis repository task. @@ -79616,7 +82299,7 @@ paths: from processing. This information is only available to the user that initiated the variant analysis. properties: - access_mismatch_repos: &552 + access_mismatch_repos: &551 type: object properties: repository_count: @@ -79631,7 +82314,7 @@ paths: This list may not include all repositories that were skipped. This is only available when the repository was found and the user has access to it. - items: *551 + items: *550 required: - repository_count - repositories @@ -79654,8 +82337,8 @@ paths: required: - repository_count - repository_full_names - no_codeql_db_repos: *552 - over_limit_repos: *552 + no_codeql_db_repos: *551 + over_limit_repos: *551 required: - access_mismatch_repos - not_found_repos @@ -79671,7 +82354,7 @@ paths: examples: repositories_parameter: summary: Response for a successful variant analysis submission - value: &553 + value: &552 summary: Default response value: id: 1 @@ -79817,10 +82500,10 @@ paths: private: false repository_owners: summary: Response for a successful variant analysis submission - value: *553 + value: *552 repository_lists: summary: Response for a successful variant analysis submission - value: *553 + value: *552 '404': *6 '422': description: Unable to process variant analysis submission @@ -79848,8 +82531,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-summary-of-a-codeql-variant-analysis parameters: + - *453 - *454 - - *455 - name: codeql_variant_analysis_id in: path description: The unique identifier of the variant analysis. @@ -79861,9 +82544,9 @@ paths: description: Response content: application/json: - schema: *554 + schema: *553 examples: - default: *553 + default: *552 '404': *6 '503': *192 x-github: @@ -79886,7 +82569,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-the-analysis-status-of-a-repository-in-a-codeql-variant-analysis parameters: - - *454 + - *453 - name: repo in: path description: The name of the controller repository. @@ -79921,7 +82604,7 @@ paths: type: object properties: repository: *120 - analysis_status: *555 + analysis_status: *554 artifact_size_in_bytes: type: integer description: The size of the artifact. This is only available @@ -80046,8 +82729,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-a-code-scanning-default-setup-configuration parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -80140,7 +82823,7 @@ paths: threat_model: remote updated_at: '2023-01-19T11:21:34Z' schedule: weekly - '403': *533 + '403': *532 '404': *6 '503': *192 x-github: @@ -80161,8 +82844,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#update-a-code-scanning-default-setup-configuration parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -80231,7 +82914,7 @@ paths: description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -80256,7 +82939,7 @@ paths: value: run_id: 42 run_url: https://api.github.com/repos/octoorg/octocat/actions/runs/42 - '403': *539 + '403': *538 '404': *6 '409': description: Response if there is already a validation run in progress with @@ -80327,8 +83010,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#upload-an-analysis-as-sarif-data parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -80336,7 +83019,7 @@ paths: schema: type: object properties: - commit_sha: *556 + commit_sha: *555 ref: type: string description: |- @@ -80396,7 +83079,7 @@ paths: schema: type: object properties: - id: *547 + id: *546 url: type: string description: The REST API URL for checking the status of the upload. @@ -80410,7 +83093,7 @@ paths: url: https://api.github.com/repos/octocat/hello-world/code-scanning/sarifs/47177e22-5596-11eb-80a1-c1e54ef945c6 '400': description: Bad Request if the sarif field is invalid - '403': *539 + '403': *538 '404': *6 '413': description: Payload Too Large if the sarif field is too large @@ -80433,8 +83116,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-scanning/code-scanning#get-information-about-a-sarif-upload parameters: + - *453 - *454 - - *455 - name: sarif_id description: The SARIF ID obtained after uploading. in: path @@ -80482,7 +83165,7 @@ paths: value: processing_status: complete analyses_url: https://api.github.com/repos/octocat/hello-world/code-scanning/analyses?sarif_id=47177e22-5596-11eb-80a1-c1e54ef945c6 - '403': *533 + '403': *532 '404': description: Not Found if the sarif id does not match any upload '503': *192 @@ -80507,8 +83190,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/code-security/configurations#get-the-code-security-configuration-associated-with-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -80589,8 +83272,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-codeowners-errors parameters: + - *453 - *454 - - *455 - name: ref description: 'A branch, tag or commit name used to determine which version of the CODEOWNERS file to use. Default: the repository''s default branch @@ -80718,8 +83401,8 @@ paths: parameters: - *17 - *19 + - *453 - *454 - - *455 responses: '200': description: Response @@ -80735,7 +83418,7 @@ paths: type: integer codespaces: type: array - items: *377 + items: *376 examples: default: value: @@ -81033,8 +83716,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-codespace-in-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -81098,17 +83781,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '400': *14 '401': *23 '403': *27 @@ -81137,8 +83820,8 @@ paths: parameters: - *17 - *19 + - *453 - *454 - - *455 responses: '200': description: Response @@ -81202,8 +83885,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/machines#list-available-machine-types-for-a-repository parameters: + - *453 - *454 - - *455 - name: location description: The location to check for available machines. Assigned by IP if not provided. @@ -81240,9 +83923,9 @@ paths: type: integer machines: type: array - items: *558 + items: *557 examples: - default: &792 + default: &791 value: total_count: 2 machines: @@ -81282,8 +83965,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-default-attributes-for-a-codespace parameters: + - *453 - *454 - - *455 - name: ref description: The branch or commit to check for a default devcontainer path. If not specified, the default branch will be checked. @@ -81370,8 +84053,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#check-if-permissions-defined-by-a-devcontainer-have-been-accepted-by-the-authenticated-user parameters: + - *453 - *454 - - *455 - name: ref description: The git reference that points to the location of the devcontainer configuration to use for the permission check. The value of `ref` will typically @@ -81440,8 +84123,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#list-repository-secrets parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -81459,7 +84142,7 @@ paths: type: integer secrets: type: array - items: &562 + items: &561 title: Codespaces Secret description: Set repository secrets for GitHub Codespaces. type: object @@ -81480,7 +84163,7 @@ paths: - created_at - updated_at examples: - default: *559 + default: *558 headers: Link: *45 x-github: @@ -81503,16 +84186,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#get-a-repository-public-key parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *560 + schema: *559 examples: - default: *561 + default: *560 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -81532,17 +84215,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#get-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 responses: '200': description: Response content: application/json: - schema: *562 + schema: *561 examples: - default: *563 + default: *562 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -81562,9 +84245,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#create-or-update-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 requestBody: required: true content: @@ -81592,7 +84275,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -81616,9 +84299,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/repository-secrets#delete-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 responses: '204': description: Response @@ -81646,8 +84329,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#list-repository-collaborators parameters: + - *453 - *454 - - *455 - name: affiliation description: Filter collaborators returned by their affiliation. `outside` means all outside collaborators of an organization-owned repository. `direct` @@ -81685,7 +84368,7 @@ paths: application/json: schema: type: array - items: &564 + items: &563 title: Collaborator description: Collaborator type: object @@ -81878,8 +84561,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#check-if-a-user-is-a-repository-collaborator parameters: + - *453 - *454 - - *455 - *139 responses: '204': @@ -81926,8 +84609,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#add-a-repository-collaborator parameters: + - *453 - *454 - - *455 - *139 requestBody: required: false @@ -81954,7 +84637,7 @@ paths: description: Response when a new invitation is created content: application/json: - schema: &640 + schema: &639 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -81966,7 +84649,7 @@ paths: format: int64 examples: - 42 - repository: *279 + repository: *278 invitee: anyOf: - type: 'null' @@ -82182,8 +84865,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#remove-a-repository-collaborator parameters: + - *453 - *454 - - *455 - *139 responses: '204': @@ -82215,8 +84898,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/collaborators#get-repository-permissions-for-a-user parameters: + - *453 - *454 - - *455 - *139 responses: '200': @@ -82237,7 +84920,7 @@ paths: user: anyOf: - type: 'null' - - *564 + - *563 required: - permission - role_name @@ -82291,8 +84974,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#list-commit-comments-for-a-repository parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -82302,7 +84985,7 @@ paths: application/json: schema: type: array - items: &565 + items: &564 title: Commit Comment description: Commit Comment type: object @@ -82360,7 +85043,7 @@ paths: - created_at - updated_at examples: - default: &570 + default: &569 value: - html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -82419,17 +85102,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#get-a-commit-comment parameters: + - *453 - *454 - - *455 - *233 responses: '200': description: Response content: application/json: - schema: *565 + schema: *564 examples: - default: &571 + default: &570 value: html_url: https://github.com/octocat/Hello-World/commit/6dcb09b5b57875f334f61aebed695e2e4193db5e#commitcomment-1 url: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -82486,8 +85169,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#update-a-commit-comment parameters: + - *453 - *454 - - *455 - *233 requestBody: required: true @@ -82510,7 +85193,7 @@ paths: description: Response content: application/json: - schema: *565 + schema: *564 examples: default: value: @@ -82561,8 +85244,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#delete-a-commit-comment parameters: + - *453 - *454 - - *455 - *233 responses: '204': @@ -82584,8 +85267,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-commit-comment parameters: + - *453 - *454 - - *455 - *233 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). @@ -82612,7 +85295,7 @@ paths: application/json: schema: type: array - items: &566 + items: &565 title: Reaction description: Reactions to conversations provide a way to help people express their feelings more simply and effectively. @@ -82656,7 +85339,7 @@ paths: - content - created_at examples: - default: &643 + default: &642 value: - id: 1 node_id: MDg6UmVhY3Rpb24x @@ -82701,8 +85384,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-commit-comment parameters: + - *453 - *454 - - *455 - *233 requestBody: required: true @@ -82735,9 +85418,9 @@ paths: description: Reaction exists content: application/json: - schema: *566 + schema: *565 examples: - default: &567 + default: &566 value: id: 1 node_id: MDg6UmVhY3Rpb24x @@ -82766,9 +85449,9 @@ paths: description: Reaction created content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '422': *15 x-github: githubCloudOnly: false @@ -82790,10 +85473,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-commit-comment-reaction parameters: + - *453 - *454 - - *455 - *233 - - &644 + - &643 name: reaction_id description: The unique identifier of the reaction. in: path @@ -82848,8 +85531,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-commits parameters: + - *453 - *454 - - *455 - name: sha description: 'SHA or branch to start listing commits from. Default: the repository’s default branch (usually `main`).' @@ -82905,9 +85588,9 @@ paths: application/json: schema: type: array - items: *568 + items: *567 examples: - default: &692 + default: &691 value: - url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -83001,9 +85684,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-branches-for-head-commit parameters: + - *453 - *454 - - *455 - - &569 + - &568 name: commit_sha description: The SHA of the commit. in: path @@ -83075,9 +85758,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#list-commit-comments parameters: + - *453 - *454 - - *455 - - *569 + - *568 - *17 - *19 responses: @@ -83087,9 +85770,9 @@ paths: application/json: schema: type: array - items: *565 + items: *564 examples: - default: *570 + default: *569 headers: Link: *45 x-github: @@ -83117,9 +85800,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/comments#create-a-commit-comment parameters: + - *453 - *454 - - *455 - - *569 + - *568 requestBody: required: true content: @@ -83154,9 +85837,9 @@ paths: description: Response content: application/json: - schema: *565 + schema: *564 examples: - default: *571 + default: *570 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/comments/1 @@ -83184,9 +85867,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#list-pull-requests-associated-with-a-commit parameters: + - *453 - *454 - - *455 - - *569 + - *568 - *17 - *19 responses: @@ -83196,9 +85879,9 @@ paths: application/json: schema: type: array - items: *572 + items: *571 examples: - default: &684 + default: &683 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -83735,11 +86418,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#get-a-commit parameters: + - *453 - *454 - - *455 - *19 - *17 - - &573 + - &572 name: ref description: 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](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" @@ -83754,9 +86437,9 @@ paths: description: Response content: application/json: - schema: *568 + schema: *567 examples: - default: &670 + default: &669 value: url: https://api.github.com/repos/octocat/Hello-World/commits/6dcb09b5b57875f334f61aebed695e2e4193db5e sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e @@ -83869,11 +86552,11 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/runs#list-check-runs-for-a-git-reference parameters: + - *453 - *454 - - *455 + - *572 - *573 - *574 - - *575 - name: filter description: Filters check runs by their `completed_at` timestamp. `latest` returns the most recent check runs. @@ -83907,9 +86590,9 @@ paths: type: integer check_runs: type: array - items: *518 + items: *517 examples: - default: *576 + default: *575 headers: Link: *45 x-github: @@ -83934,9 +86617,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/checks/suites#list-check-suites-for-a-git-reference parameters: + - *453 - *454 - - *455 - - *573 + - *572 - name: app_id description: Filters check suites by GitHub App `id`. in: query @@ -83944,7 +86627,7 @@ paths: schema: type: integer example: 1 - - *574 + - *573 - *17 - *19 responses: @@ -83962,7 +86645,7 @@ paths: type: integer check_suites: type: array - items: *522 + items: *521 examples: default: value: @@ -84162,9 +86845,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#get-the-combined-status-for-a-specific-reference parameters: + - *453 - *454 - - *455 - - *573 + - *572 - *17 - *19 responses: @@ -84235,7 +86918,7 @@ paths: type: string total_count: type: integer - repository: *279 + repository: *278 commit_url: type: string format: uri @@ -84366,9 +87049,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#list-commit-statuses-for-a-reference parameters: + - *453 - *454 - - *455 - - *573 + - *572 - *17 - *19 responses: @@ -84378,7 +87061,7 @@ paths: application/json: schema: type: array - items: &745 + items: &744 title: Status description: The status of a commit. type: object @@ -84459,7 +87142,7 @@ paths: site_admin: false headers: Link: *45 - '301': *460 + '301': *459 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -84487,8 +87170,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/community#get-community-profile-metrics parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -84521,11 +87204,11 @@ paths: code_of_conduct: anyOf: - type: 'null' - - *577 + - *576 code_of_conduct_file: anyOf: - type: 'null' - - &578 + - &577 title: Community Health File type: object properties: @@ -84545,19 +87228,19 @@ paths: contributing: anyOf: - type: 'null' - - *578 + - *577 readme: anyOf: - type: 'null' - - *578 + - *577 issue_template: anyOf: - type: 'null' - - *578 + - *577 pull_request_template: anyOf: - type: 'null' - - *578 + - *577 required: - code_of_conduct - code_of_conduct_file @@ -84686,8 +87369,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/commits#compare-two-commits parameters: + - *453 - *454 - - *455 - *19 - *17 - name: basehead @@ -84735,8 +87418,8 @@ paths: format: uri examples: - https://github.com/octocat/Hello-World/compare/master...topic.patch - base_commit: *568 - merge_base_commit: *568 + base_commit: *567 + merge_base_commit: *567 status: type: string enum: @@ -84760,10 +87443,10 @@ paths: - 6 commits: type: array - items: *568 + items: *567 files: type: array - items: *579 + items: *578 required: - url - html_url @@ -85049,8 +87732,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-repository-content parameters: + - *453 - *454 - - *455 - name: path description: path parameter in: path @@ -85220,7 +87903,7 @@ paths: - type - url examples: - response-if-content-is-a-file-github-object: &580 + response-if-content-is-a-file-github-object: &579 summary: Response if content is a file value: type: file @@ -85357,7 +88040,7 @@ paths: - size - type - url - - &697 + - &696 title: Content File description: Content File type: object @@ -85575,7 +88258,7 @@ paths: - url - submodule_git_url examples: - response-if-content-is-a-file: *580 + response-if-content-is-a-file: *579 response-if-content-is-a-directory: summary: Response if content is a directory and the application/json media type is requested @@ -85644,7 +88327,7 @@ paths: html: https://github.com/jquery/qunit/tree/6ca3721222109997540bd6d9ccd396902e0ad2f9 '404': *6 '403': *27 - '302': *581 + '302': *580 '304': *35 x-github: githubCloudOnly: false @@ -85667,8 +88350,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#create-or-update-file-contents parameters: + - *453 - *454 - - *455 - name: path description: path parameter in: path @@ -85763,7 +88446,7 @@ paths: description: Response content: application/json: - schema: &582 + schema: &581 title: File Commit description: File Commit type: object @@ -85919,7 +88602,7 @@ paths: description: Response content: application/json: - schema: *582 + schema: *581 examples: example-for-creating-a-file: value: @@ -85973,7 +88656,7 @@ paths: schema: oneOf: - *3 - - &623 + - &622 description: Repository rule violation was detected type: object properties: @@ -85994,7 +88677,7 @@ paths: items: type: object properties: - placeholder_id: &737 + placeholder_id: &736 description: The ID of the push protection bypass placeholder. This value is returned on any push protected routes. @@ -86026,8 +88709,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#delete-a-file parameters: + - *453 - *454 - - *455 - name: path description: path parameter in: path @@ -86088,7 +88771,7 @@ paths: description: Response content: application/json: - schema: *582 + schema: *581 examples: default: value: @@ -86143,8 +88826,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-contributors parameters: + - *453 - *454 - - *455 - name: anon description: Set to `1` or `true` to include anonymous contributors in results. in: query @@ -86268,23 +88951,23 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#list-dependabot-alerts-for-a-repository parameters: + - *453 - *454 - - *455 + - *328 - *329 - *330 - *331 - - *332 - name: manifest in: query description: A comma-separated list of full manifest paths. If specified, only alerts for these manifests will be returned. schema: type: string + - *332 + - *582 - *333 - - *583 - *334 - *335 - - *336 - *110 - *108 - *109 @@ -86296,7 +88979,7 @@ paths: application/json: schema: type: array - items: &587 + items: &586 type: object description: A Dependabot alert. properties: @@ -86345,8 +89028,9 @@ paths: - unknown - direct - transitive + - inconclusive - - security_advisory: *584 + security_advisory: *583 security_vulnerability: *130 url: *131 html_url: *132 @@ -86377,8 +89061,8 @@ paths: dismissal. maxLength: 280 fixed_at: *136 - auto_dismissed_at: *585 - dismissal_request: *586 + auto_dismissed_at: *584 + dismissal_request: *585 assignees: type: array description: The users assigned to this alert. @@ -86450,7 +89134,7 @@ paths: vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:N/VA:N/SC:N/SI:N/SA:N score: 8.7 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-200 @@ -86633,9 +89317,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#get-a-dependabot-alert parameters: + - *453 - *454 - - *455 - - &588 + - &587 name: alert_number in: path description: |- @@ -86650,7 +89334,7 @@ paths: description: Response content: application/json: - schema: *587 + schema: *586 examples: default: value: @@ -86707,7 +89391,7 @@ paths: vector_string: CVSS:4.0/AV:L/AC:L/AT:N/PR:N/UI:P/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N score: 8.5 epss: - - percentage: 0.00045 + percentage: 0.00045 percentile: 0.16001e0 cwes: - cwe_id: CWE-532 @@ -86782,9 +89466,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/alerts#update-a-dependabot-alert parameters: + - *453 - *454 - - *455 - - *588 + - *587 requestBody: required: true content: @@ -86840,7 +89524,7 @@ paths: description: Response content: application/json: - schema: *587 + schema: *586 examples: default: value: @@ -86970,8 +89654,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#list-repository-secrets parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -86989,7 +89673,7 @@ paths: type: integer secrets: type: array - items: &591 + items: &590 title: Dependabot Secret description: Set secrets for Dependabot. type: object @@ -87043,16 +89727,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-a-repository-public-key parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *589 + schema: *588 examples: - default: *590 + default: *589 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -87072,15 +89756,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#get-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 responses: '200': description: Response content: application/json: - schema: *591 + schema: *590 examples: default: value: @@ -87106,9 +89790,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#create-or-update-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 requestBody: required: true content: @@ -87136,7 +89820,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -87160,9 +89844,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependabot/secrets#delete-a-repository-secret parameters: + - *453 - *454 - - *455 - - *289 + - *288 responses: '204': description: Response @@ -87184,8 +89868,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/dependency-review#get-a-diff-of-the-dependencies-between-commits parameters: + - *453 - *454 - - *455 - name: basehead description: The base and head Git revisions to compare. The Git revisions will be resolved to commit SHAs. Named revisions will be resolved to their @@ -87359,8 +90043,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/sboms#export-a-software-bill-of-materials-sbom-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -87620,8 +90304,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/dependency-graph/dependency-submission#create-a-snapshot-of-dependencies-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -87704,7 +90388,7 @@ paths: - version - url additionalProperties: false - metadata: &592 + metadata: &591 title: metadata description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -87743,7 +90427,7 @@ paths: examples: - "/src/build/package-lock.json" additionalProperties: false - metadata: *592 + metadata: *591 resolved: type: object description: A collection of resolved package dependencies. @@ -87757,7 +90441,7 @@ paths: pattern: "^pkg" examples: - pkg:/npm/%40actions/http-client@1.0.11 - metadata: *592 + metadata: *591 relationship: type: string description: A notation of whether a dependency is requested @@ -87890,8 +90574,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#list-deployments parameters: + - *453 - *454 - - *455 - name: sha description: The SHA recorded at creation time. in: query @@ -87932,9 +90616,9 @@ paths: application/json: schema: type: array - items: *593 + items: *592 examples: - default: *594 + default: *593 headers: Link: *45 x-github: @@ -88000,8 +90684,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#create-a-deployment parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -88083,7 +90767,7 @@ paths: description: Response content: application/json: - schema: *593 + schema: *592 examples: simple-example: summary: Simple example @@ -88156,9 +90840,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#get-a-deployment parameters: + - *453 - *454 - - *455 - - &595 + - &594 name: deployment_id description: deployment_id parameter in: path @@ -88170,7 +90854,7 @@ paths: description: Response content: application/json: - schema: *593 + schema: *592 examples: default: value: @@ -88235,9 +90919,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/deployments#delete-a-deployment parameters: + - *453 - *454 - - *455 - - *595 + - *594 responses: '204': description: Response @@ -88259,9 +90943,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#list-deployment-statuses parameters: + - *453 - *454 - - *455 - - *595 + - *594 - *17 - *19 responses: @@ -88271,7 +90955,7 @@ paths: application/json: schema: type: array - items: &596 + items: &595 title: Deployment Status description: The status of a deployment. type: object @@ -88435,9 +91119,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#create-a-deployment-status parameters: + - *453 - *454 - - *455 - - *595 + - *594 requestBody: required: true content: @@ -88512,9 +91196,9 @@ paths: description: Response content: application/json: - schema: *596 + schema: *595 examples: - default: &597 + default: &596 value: url: https://api.github.com/repos/octocat/example/deployments/42/statuses/1 id: 1 @@ -88570,9 +91254,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/statuses#get-a-deployment-status parameters: + - *453 - *454 - - *455 - - *595 + - *594 - name: status_id in: path required: true @@ -88583,9 +91267,9 @@ paths: description: Response content: application/json: - schema: *596 + schema: *595 examples: - default: *597 + default: *596 '404': *6 x-github: githubCloudOnly: false @@ -88612,12 +91296,12 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 + - *597 - *598 - *599 - *600 - - *601 - *17 - *19 responses: @@ -88627,9 +91311,9 @@ paths: application/json: schema: type: array - items: *602 + items: *601 examples: - default: *603 + default: *602 '404': *6 '403': *27 '500': *38 @@ -88653,8 +91337,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -88666,7 +91350,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *602 + schema: *601 examples: default: value: @@ -88722,8 +91406,8 @@ paths: category: code-scanning subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -88782,12 +91466,12 @@ paths: category: dependabot subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 + - *597 - *598 - *599 - *600 - - *601 - *17 - *19 responses: @@ -88797,9 +91481,9 @@ paths: application/json: schema: type: array - items: *604 + items: *603 examples: - default: *605 + default: *604 '404': *6 '403': *27 '500': *38 @@ -88823,8 +91507,8 @@ paths: category: dependabot subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -88836,7 +91520,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *604 + schema: *603 examples: default: value: @@ -88887,8 +91571,8 @@ paths: category: dependabot subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -88926,7 +91610,7 @@ paths: description: The created dismissal request. content: application/json: - schema: *604 + schema: *603 examples: default: value: @@ -88977,8 +91661,8 @@ paths: category: dependabot subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -89049,8 +91733,8 @@ paths: category: dependabot subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -89083,12 +91767,12 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - *103 - *104 - *105 - - *341 + - *340 - *17 - *19 responses: @@ -89098,9 +91782,9 @@ paths: application/json: schema: type: array - items: *606 + items: *605 examples: - default: *607 + default: *606 '404': *6 '403': *27 '500': *38 @@ -89125,8 +91809,8 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -89138,7 +91822,7 @@ paths: description: A single dismissal request. content: application/json: - schema: *606 + schema: *605 examples: default: value: @@ -89196,8 +91880,8 @@ paths: category: secret-scanning subcategory: alert-dismissal-requests parameters: + - *453 - *454 - - *455 - name: alert_number in: path required: true @@ -89266,8 +91950,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#create-a-repository-dispatch-event parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -89324,8 +92008,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#list-environments parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -89343,7 +92027,7 @@ paths: - 5 environments: type: array - items: &609 + items: &608 title: Environment description: Details of a deployment environment type: object @@ -89405,7 +92089,7 @@ paths: type: string examples: - wait_timer - wait_timer: &611 + wait_timer: &610 type: integer description: The amount of time to delay a job after the job is initially triggered. The time (in minutes) @@ -89447,11 +92131,11 @@ paths: items: type: object properties: - type: *608 + type: *607 reviewer: anyOf: - *4 - - *308 + - *307 required: - id - node_id @@ -89474,7 +92158,7 @@ paths: - id - node_id - type - deployment_branch_policy: &612 + deployment_branch_policy: &611 type: - object - 'null' @@ -89591,9 +92275,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#get-an-environment parameters: + - *453 - *454 - - *455 - - &610 + - &609 name: environment_name in: path required: true @@ -89606,9 +92290,9 @@ paths: description: Response content: application/json: - schema: *609 + schema: *608 examples: - default: &613 + default: &612 value: id: 161088068 node_id: MDExOkVudmlyb25tZW50MTYxMDg4MDY4 @@ -89692,9 +92376,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#create-or-update-an-environment parameters: + - *453 - *454 - - *455 - - *610 + - *609 requestBody: required: false content: @@ -89704,7 +92388,7 @@ paths: - object - 'null' properties: - wait_timer: *611 + wait_timer: *610 prevent_self_review: type: boolean description: Whether or not a user who created the job is prevented @@ -89723,14 +92407,14 @@ paths: items: type: object properties: - type: *608 + type: *607 id: type: integer description: The id of the user or team who can review the deployment examples: - 4532992 - deployment_branch_policy: *612 + deployment_branch_policy: *611 additionalProperties: false examples: default: @@ -89750,9 +92434,9 @@ paths: description: Response content: application/json: - schema: *609 + schema: *608 examples: - default: *613 + default: *612 '422': description: Validation error when the environment name is invalid or when `protected_branches` and `custom_branch_policies` in `deployment_branch_policy` @@ -89776,9 +92460,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/environments#delete-an-environment parameters: + - *453 - *454 - - *455 - - *610 + - *609 responses: '204': description: Default response @@ -89803,9 +92487,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#list-deployment-branch-policies parameters: + - *453 - *454 - - *455 - - *610 + - *609 - *17 - *19 responses: @@ -89824,7 +92508,7 @@ paths: - 2 branch_policies: type: array - items: &614 + items: &613 title: Deployment branch policy description: Details of a deployment branch or tag policy. type: object @@ -89885,9 +92569,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#create-a-deployment-branch-policy parameters: + - *453 - *454 - - *455 - - *610 + - *609 requestBody: required: true content: @@ -89935,9 +92619,9 @@ paths: description: Response content: application/json: - schema: *614 + schema: *613 examples: - example-wildcard: &615 + example-wildcard: &614 value: id: 364662 node_id: MDE2OkdhdGVCcmFuY2hQb2xpY3kzNjQ2NjI= @@ -89979,10 +92663,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#get-a-deployment-branch-policy parameters: + - *453 - *454 - - *455 - - *610 - - &616 + - *609 + - &615 name: branch_policy_id in: path required: true @@ -89994,9 +92678,9 @@ paths: description: Response content: application/json: - schema: *614 + schema: *613 examples: - default: *615 + default: *614 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90015,10 +92699,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#update-a-deployment-branch-policy parameters: + - *453 - *454 - - *455 - - *610 - - *616 + - *609 + - *615 requestBody: required: true content: @@ -90047,9 +92731,9 @@ paths: description: Response content: application/json: - schema: *614 + schema: *613 examples: - default: *615 + default: *614 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90068,10 +92752,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/branch-policies#delete-a-deployment-branch-policy parameters: + - *453 - *454 - - *455 - - *610 - - *616 + - *609 + - *615 responses: '204': description: Response @@ -90096,9 +92780,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#get-all-deployment-protection-rules-for-an-environment parameters: - - *610 - - *455 + - *609 - *454 + - *453 responses: '200': description: List of deployment protection rules @@ -90115,7 +92799,7 @@ paths: - 10 custom_deployment_protection_rules: type: array - items: &617 + items: &616 title: Deployment protection rule description: Deployment protection rule type: object @@ -90137,7 +92821,7 @@ paths: for the environment. examples: - true - app: &618 + app: &617 title: Custom deployment protection rule app description: A GitHub App that is providing a custom deployment protection rule. @@ -90240,9 +92924,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#create-a-custom-deployment-protection-rule-on-an-environment parameters: - - *610 - - *455 + - *609 - *454 + - *453 requestBody: content: application/json: @@ -90263,9 +92947,9 @@ paths: description: The enabled custom deployment protection rule content: application/json: - schema: *617 + schema: *616 examples: - default: &619 + default: &618 value: id: 3 node_id: IEH37kRlcGxveW1lbnRTdGF0ddiv @@ -90300,9 +92984,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#list-custom-deployment-rule-integrations-available-for-an-environment parameters: - - *610 - - *455 + - *609 - *454 + - *453 - *19 - *17 responses: @@ -90322,7 +93006,7 @@ paths: - 35 available_custom_deployment_protection_rule_integrations: type: array - items: *618 + items: *617 examples: default: value: @@ -90357,10 +93041,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#get-a-custom-deployment-protection-rule parameters: + - *453 - *454 - - *455 - - *610 - - &620 + - *609 + - &619 name: protection_rule_id description: The unique identifier of the protection rule. in: path @@ -90372,9 +93056,9 @@ paths: description: Response content: application/json: - schema: *617 + schema: *616 examples: - default: *619 + default: *618 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90395,10 +93079,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deployments/protection-rules#disable-a-custom-protection-rule-for-an-environment parameters: - - *610 - - *455 + - *609 - *454 - - *620 + - *453 + - *619 responses: '204': description: Response @@ -90424,9 +93108,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#list-environment-secrets parameters: + - *453 - *454 - - *455 - - *610 + - *609 - *17 - *19 responses: @@ -90444,9 +93128,9 @@ paths: type: integer secrets: type: array - items: *485 + items: *484 examples: - default: *486 + default: *485 headers: Link: *45 x-github: @@ -90471,17 +93155,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-environment-public-key parameters: + - *453 - *454 - - *455 - - *610 + - *609 responses: '200': description: Response content: application/json: - schema: *487 + schema: *486 examples: - default: *488 + default: *487 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90503,18 +93187,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#get-an-environment-secret parameters: + - *453 - *454 - - *455 - - *610 - - *289 + - *609 + - *288 responses: '200': description: Response content: application/json: - schema: *485 + schema: *484 examples: - default: *621 + default: *620 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90536,10 +93220,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#create-or-update-an-environment-secret parameters: + - *453 - *454 - - *455 - - *610 - - *289 + - *609 + - *288 requestBody: required: true content: @@ -90570,7 +93254,7 @@ paths: description: Response when creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -90596,10 +93280,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/secrets#delete-an-environment-secret parameters: + - *453 - *454 - - *455 - - *610 - - *289 + - *609 + - *288 responses: '204': description: Default response @@ -90624,10 +93308,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#list-environment-variables parameters: + - *453 - *454 - - *455 - - *610 - - *472 + - *609 + - *471 - *19 responses: '200': @@ -90644,9 +93328,9 @@ paths: type: integer variables: type: array - items: *489 + items: *488 examples: - default: *490 + default: *489 headers: Link: *45 x-github: @@ -90669,9 +93353,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#create-an-environment-variable parameters: + - *453 - *454 - - *455 - - *610 + - *609 requestBody: required: true content: @@ -90698,7 +93382,7 @@ paths: description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -90723,18 +93407,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#get-an-environment-variable parameters: + - *453 - *454 - - *455 - - *610 - - *292 + - *609 + - *291 responses: '200': description: Response content: application/json: - schema: *489 + schema: *488 examples: - default: *622 + default: *621 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -90755,10 +93439,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#update-an-environment-variable parameters: + - *453 - *454 - - *455 - - *292 - - *610 + - *291 + - *609 requestBody: required: true content: @@ -90800,10 +93484,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/actions/variables#delete-an-environment-variable parameters: + - *453 - *454 - - *455 - - *292 - - *610 + - *291 + - *609 responses: '204': description: Response @@ -90825,8 +93509,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/events#list-repository-events parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -90894,8 +93578,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/forks#list-forks parameters: + - *453 - *454 - - *455 - name: sort description: The sort order. `stargazers` will sort by star count. in: query @@ -90917,7 +93601,7 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: default: value: @@ -91054,8 +93738,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/forks#create-a-fork parameters: + - *453 - *454 - - *455 requestBody: required: false content: @@ -91088,9 +93772,9 @@ paths: description: Response content: application/json: - schema: *459 + schema: *458 examples: - default: *461 + default: *460 '400': *14 '422': *15 '403': *27 @@ -91111,8 +93795,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/blobs#create-a-blob parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -91172,7 +93856,7 @@ paths: schema: oneOf: - *253 - - *623 + - *622 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -91197,8 +93881,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/blobs#get-a-blob parameters: + - *453 - *454 - - *455 - name: file_sha in: path required: true @@ -91298,8 +93982,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/commits#create-a-commit parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -91408,7 +94092,7 @@ paths: description: Response content: application/json: - schema: &624 + schema: &623 title: Git Commit description: Low-level Git commit operations within a repository type: object @@ -91635,15 +94319,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/commits#get-a-commit-object parameters: + - *453 - *454 - - *455 - - *569 + - *568 responses: '200': description: Response content: application/json: - schema: *624 + schema: *623 examples: default: value: @@ -91699,9 +94383,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#list-matching-references parameters: + - *453 - *454 - - *455 - - &625 + - &624 name: ref description: The Git reference. For more information, see "[Git References](https://git-scm.com/book/en/v2/Git-Internals-Git-References)" in the Git documentation. @@ -91718,7 +94402,7 @@ paths: application/json: schema: type: array - items: &626 + items: &625 title: Git Reference description: Git references within a repository type: object @@ -91794,17 +94478,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#get-a-reference parameters: + - *453 - *454 - - *455 - - *625 + - *624 responses: '200': description: Response content: application/json: - schema: *626 + schema: *625 examples: - default: &627 + default: &626 value: ref: refs/heads/featureA node_id: MDM6UmVmcmVmcy9oZWFkcy9mZWF0dXJlQQ== @@ -91833,8 +94517,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#create-a-reference parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -91863,9 +94547,9 @@ paths: description: Response content: application/json: - schema: *626 + schema: *625 examples: - default: *627 + default: *626 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/git/refs/heads/featureA @@ -91891,9 +94575,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#update-a-reference parameters: + - *453 - *454 - - *455 - - *625 + - *624 requestBody: required: true content: @@ -91922,9 +94606,9 @@ paths: description: Response content: application/json: - schema: *626 + schema: *625 examples: - default: *627 + default: *626 '422': *15 '409': *119 x-github: @@ -91942,9 +94626,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/refs#delete-a-reference parameters: + - *453 - *454 - - *455 - - *625 + - *624 responses: '204': description: Response @@ -91999,8 +94683,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/tags#create-a-tag-object parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -92067,7 +94751,7 @@ paths: description: Response content: application/json: - schema: &629 + schema: &628 title: Git Tag description: Metadata for a Git tag type: object @@ -92123,7 +94807,7 @@ paths: - sha - type - url - verification: *628 + verification: *627 required: - sha - url @@ -92133,7 +94817,7 @@ paths: - tag - message examples: - default: &630 + default: &629 value: node_id: MDM6VGFnOTQwYmQzMzYyNDhlZmFlMGY5ZWU1YmM3YjJkNWM5ODU4ODdiMTZhYw== tag: v0.0.1 @@ -92206,8 +94890,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/tags#get-a-tag parameters: + - *453 - *454 - - *455 - name: tag_sha in: path required: true @@ -92218,9 +94902,9 @@ paths: description: Response content: application/json: - schema: *629 + schema: *628 examples: - default: *630 + default: *629 '404': *6 '409': *119 x-github: @@ -92244,8 +94928,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/trees#create-a-tree parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -92319,7 +95003,7 @@ paths: description: Response content: application/json: - schema: &631 + schema: &630 title: Git Tree description: The hierarchy between files in a Git repository. type: object @@ -92421,8 +95105,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/git/trees#get-a-tree parameters: + - *453 - *454 - - *455 - name: tree_sha description: The SHA1 value or ref (branch or tag) name of the tree. in: path @@ -92445,7 +95129,7 @@ paths: description: Response content: application/json: - schema: *631 + schema: *630 examples: default-response: summary: Default response @@ -92504,8 +95188,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#list-repository-webhooks parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -92515,7 +95199,7 @@ paths: application/json: schema: type: array - items: &632 + items: &631 title: Webhook description: Webhooks for repositories. type: object @@ -92578,7 +95262,7 @@ paths: format: uri examples: - https://api.github.com/repos/octocat/Hello-World/hooks/1/deliveries - last_response: &882 + last_response: &881 title: Hook Response type: object properties: @@ -92655,8 +95339,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#create-a-repository-webhook parameters: + - *453 - *454 - - *455 requestBody: required: false content: @@ -92709,9 +95393,9 @@ paths: description: Response content: application/json: - schema: *632 + schema: *631 examples: - default: &633 + default: &632 value: type: Repository id: 12345678 @@ -92759,17 +95443,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 responses: '200': description: Response content: application/json: - schema: *632 + schema: *631 examples: - default: *633 + default: *632 '404': *6 x-github: githubCloudOnly: false @@ -92789,9 +95473,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#update-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 requestBody: required: true content: @@ -92836,9 +95520,9 @@ paths: description: Response content: application/json: - schema: *632 + schema: *631 examples: - default: *633 + default: *632 '422': *15 '404': *6 x-github: @@ -92859,9 +95543,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#delete-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 responses: '204': description: Response @@ -92885,9 +95569,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-webhook-configuration-for-a-repository parameters: + - *453 - *454 - - *455 - - *344 + - *343 responses: '200': description: Response @@ -92914,9 +95598,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#update-a-webhook-configuration-for-a-repository parameters: + - *453 - *454 - - *455 - - *344 + - *343 requestBody: required: false content: @@ -92960,12 +95644,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#list-deliveries-for-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 - *17 + - *344 - *345 - - *346 responses: '200': description: Response @@ -92973,9 +95657,9 @@ paths: application/json: schema: type: array - items: *347 + items: *346 examples: - default: *348 + default: *347 '400': *14 '422': *15 x-github: @@ -92994,18 +95678,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#get-a-delivery-for-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 - *16 responses: '200': description: Response content: application/json: - schema: *349 + schema: *348 examples: - default: *350 + default: *349 '400': *14 '422': *15 x-github: @@ -93024,9 +95708,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#redeliver-a-delivery-for-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 - *16 responses: '202': *37 @@ -93049,9 +95733,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#ping-a-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 responses: '204': description: Response @@ -93076,9 +95760,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/webhooks#test-the-push-repository-webhook parameters: + - *453 - *454 - - *455 - - *344 + - *343 responses: '204': description: Response @@ -93101,8 +95785,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-immutable-releases-are-enabled-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response if immutable releases are enabled @@ -93150,8 +95834,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-immutable-releases parameters: + - *453 - *454 - - *455 responses: '204': *151 '409': *119 @@ -93171,8 +95855,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-immutable-releases parameters: + - *453 - *454 - - *455 responses: '204': *151 '409': *119 @@ -93229,14 +95913,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-an-import-status parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: &634 + schema: &633 title: Import description: A repository import from an external source. type: object @@ -93343,7 +96027,7 @@ paths: - html_url - authors_url examples: - default: &637 + default: &636 value: vcs: subversion use_lfs: true @@ -93359,7 +96043,7 @@ paths: authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm '404': *6 - '503': &635 + '503': &634 description: Unavailable due to service under maintenance. content: application/json: @@ -93388,8 +96072,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#start-an-import parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -93437,7 +96121,7 @@ paths: description: Response content: application/json: - schema: *634 + schema: *633 examples: default: value: @@ -93462,7 +96146,7 @@ paths: type: string '422': *15 '404': *6 - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93490,8 +96174,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#update-an-import parameters: + - *453 - *454 - - *455 requestBody: required: false content: @@ -93543,7 +96227,7 @@ paths: description: Response content: application/json: - schema: *634 + schema: *633 examples: example-1: summary: Example 1 @@ -93591,7 +96275,7 @@ paths: html_url: https://import.github.com/octocat/socm/import authors_url: https://api.github.com/repos/octocat/socm/import/authors repository_url: https://api.github.com/repos/octocat/socm - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93614,12 +96298,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#cancel-an-import parameters: + - *453 - *454 - - *455 responses: '204': description: Response - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93645,9 +96329,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-commit-authors parameters: + - *453 - *454 - - *455 - - &813 + - &812 name: since description: A user ID. Only return users with an ID greater than this ID. in: query @@ -93661,7 +96345,7 @@ paths: application/json: schema: type: array - items: &636 + items: &635 title: Porter Author description: Porter Author type: object @@ -93715,7 +96399,7 @@ paths: url: https://api.github.com/repos/octocat/socm/import/authors/2268559 import_url: https://api.github.com/repos/octocat/socm/import '404': *6 - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93740,8 +96424,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#map-a-commit-author parameters: + - *453 - *454 - - *455 - name: author_id in: path required: true @@ -93771,7 +96455,7 @@ paths: description: Response content: application/json: - schema: *636 + schema: *635 examples: default: value: @@ -93784,7 +96468,7 @@ paths: import_url: https://api.github.com/repos/octocat/socm/import '422': *15 '404': *6 - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93808,8 +96492,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#get-large-files parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -93850,7 +96534,7 @@ paths: path: foo/bar/3 oid: c20ad4d76fe97759aa27a0c99bff6710 size: 12582912 - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93878,8 +96562,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/source-imports#update-git-lfs-preference parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -93906,11 +96590,11 @@ paths: description: Response content: application/json: - schema: *634 + schema: *633 examples: - default: *637 + default: *636 '422': *15 - '503': *635 + '503': *634 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -93933,8 +96617,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/apps/apps#get-a-repository-installation-for-the-authenticated-app parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -93942,8 +96626,8 @@ paths: application/json: schema: *20 examples: - default: *362 - '301': *460 + default: *361 + '301': *459 '404': *6 x-github: githubCloudOnly: false @@ -93963,8 +96647,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#get-interaction-restrictions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -93972,12 +96656,12 @@ paths: application/json: schema: anyOf: - - *364 + - *363 - type: object properties: {} additionalProperties: false examples: - default: &639 + default: &638 value: limit: collaborators_only origin: repository @@ -94002,13 +96686,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#set-interaction-restrictions-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: application/json: - schema: *638 + schema: *637 examples: default: summary: Example request body @@ -94020,9 +96704,9 @@ paths: description: Response content: application/json: - schema: *364 + schema: *363 examples: - default: *639 + default: *638 '409': description: Response x-github: @@ -94044,8 +96728,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/interactions/repos#remove-interaction-restrictions-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -94068,8 +96752,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#list-repository-invitations parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -94079,9 +96763,9 @@ paths: application/json: schema: type: array - items: *640 + items: *639 examples: - default: &806 + default: &805 value: - id: 1 repository: @@ -94212,9 +96896,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#update-a-repository-invitation parameters: + - *453 - *454 - - *455 - - *368 + - *367 requestBody: required: false content: @@ -94243,7 +96927,7 @@ paths: description: Response content: application/json: - schema: *640 + schema: *639 examples: default: value: @@ -94374,9 +97058,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#delete-a-repository-invitation parameters: + - *453 - *454 - - *455 - - *368 + - *367 responses: '204': description: Response @@ -94407,8 +97091,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#list-repository-issues parameters: + - *453 - *454 - - *455 - name: milestone description: If an `integer` is passed, it should refer to a milestone by its `number` field. If the string `*` is passed, issues with any milestone @@ -94456,7 +97140,7 @@ paths: required: false schema: type: string - - *375 + - *374 - name: sort description: What to sort results by. in: query @@ -94481,7 +97165,7 @@ paths: type: array items: *219 examples: - default: &649 + default: &648 value: - id: 1 node_id: MDU6SXNzdWUx @@ -94630,7 +97314,7 @@ paths: state_reason: completed headers: Link: *45 - '301': *460 + '301': *459 '422': *15 '404': *6 x-github: @@ -94659,8 +97343,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#create-an-issue parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -94752,7 +97436,7 @@ paths: application/json: schema: *219 examples: - default: &646 + default: &645 value: id: 1 node_id: MDU6SXNzdWUx @@ -94909,7 +97593,7 @@ paths: '422': *15 '503': *192 '404': *6 - '410': *641 + '410': *640 x-github: triggersNotification: true githubCloudOnly: false @@ -94937,8 +97621,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#list-issue-comments-for-a-repository parameters: + - *453 - *454 - - *455 - *241 - name: direction description: Either `asc` or `desc`. Ignored without the `sort` parameter. @@ -94961,7 +97645,7 @@ paths: type: array items: *220 examples: - default: &648 + default: &647 value: - id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -95019,8 +97703,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#get-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 responses: '200': @@ -95029,7 +97713,7 @@ paths: application/json: schema: *220 examples: - default: &642 + default: &641 value: id: 1 node_id: MDEyOklzc3VlQ29tbWVudDE= @@ -95084,8 +97768,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#update-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 requestBody: required: true @@ -95110,7 +97794,7 @@ paths: application/json: schema: *220 examples: - default: *642 + default: *641 '422': *15 x-github: githubCloudOnly: false @@ -95128,8 +97812,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#delete-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 responses: '204': @@ -95158,8 +97842,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#pin-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 responses: '200': @@ -95222,7 +97906,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *641 + '410': *640 '422': *15 x-github: githubCloudOnly: false @@ -95239,8 +97923,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#unpin-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 responses: '204': @@ -95248,7 +97932,7 @@ paths: '401': *23 '403': *27 '404': *6 - '410': *641 + '410': *640 '503': *192 x-github: githubCloudOnly: false @@ -95266,8 +97950,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). @@ -95294,9 +97978,9 @@ paths: application/json: schema: type: array - items: *566 + items: *565 examples: - default: *643 + default: *642 headers: Link: *45 '404': *6 @@ -95317,8 +98001,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-an-issue-comment parameters: + - *453 - *454 - - *455 - *233 requestBody: required: true @@ -95351,16 +98035,16 @@ paths: description: Reaction exists content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '201': description: Reaction created content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '422': *15 x-github: githubCloudOnly: false @@ -95382,10 +98066,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-an-issue-comment-reaction parameters: + - *453 - *454 - - *455 - *233 - - *644 + - *643 responses: '204': description: Response @@ -95405,8 +98089,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#list-issue-events-for-a-repository parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -95416,7 +98100,7 @@ paths: application/json: schema: type: array - items: &645 + items: &644 title: Issue Event description: Issue Event type: object @@ -95496,7 +98180,7 @@ paths: anyOf: - type: 'null' - *4 - requested_team: *308 + requested_team: *307 dismissed_review: title: Issue Event Dismissed Review type: object @@ -95756,8 +98440,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#get-an-issue-event parameters: + - *453 - *454 - - *455 - name: event_id in: path required: true @@ -95768,7 +98452,7 @@ paths: description: Response content: application/json: - schema: *645 + schema: *644 examples: default: value: @@ -95961,7 +98645,7 @@ paths: author_association: COLLABORATOR state_reason: completed '404': *6 - '410': *641 + '410': *640 '403': *27 x-github: githubCloudOnly: false @@ -95995,9 +98679,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue parameters: + - *453 - *454 - - *455 - - &647 + - &646 name: issue_number description: The number that identifies the issue. in: path @@ -96013,7 +98697,7 @@ paths: examples: default: summary: Issue - value: *646 + value: *645 pinned_comment: summary: Issue with pinned comment value: @@ -96212,9 +98896,9 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 '304': *35 x-github: githubCloudOnly: false @@ -96239,9 +98923,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#update-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: false content: @@ -96382,13 +99066,13 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 '422': *15 '503': *192 '403': *27 - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96406,9 +99090,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#add-assignees-to-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: false content: @@ -96436,7 +99120,7 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96452,9 +99136,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#remove-assignees-from-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: content: application/json: @@ -96481,7 +99165,7 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96503,9 +99187,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/assignees#check-if-a-user-can-be-assigned-to-a-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 - name: assignee in: path required: true @@ -96545,9 +99229,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#list-issue-comments parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *224 - *17 - *19 @@ -96560,11 +99244,11 @@ paths: type: array items: *220 examples: - default: *648 + default: *647 headers: Link: *45 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96593,9 +99277,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#create-an-issue-comment parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: true content: @@ -96619,14 +99303,14 @@ paths: application/json: schema: *220 examples: - default: *642 + default: *641 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/comments/1 schema: type: string '403': *27 - '410': *641 + '410': *640 '422': *15 '404': *6 x-github: @@ -96654,9 +99338,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocked-by parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -96668,12 +99352,12 @@ paths: type: array items: *219 examples: - default: *649 + default: *648 headers: Link: *45 - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96701,9 +99385,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-dependencies#add-a-dependency-an-issue-is-blocked-by parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: true content: @@ -96727,15 +99411,15 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/dependencies/blocked_by schema: type: string - '301': *460 + '301': *459 '403': *27 - '410': *641 + '410': *640 '422': *15 '404': *6 x-github: @@ -96766,9 +99450,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-dependencies#remove-dependency-an-issue-is-blocked-by parameters: + - *453 - *454 - - *455 - - *647 + - *646 - name: issue_id in: path description: The id of the blocking issue to remove as a dependency @@ -96782,13 +99466,13 @@ paths: application/json: schema: *219 examples: - default: *646 - '301': *460 + default: *645 + '301': *459 '400': *14 '401': *23 '403': *27 '404': *6 - '410': *641 + '410': *640 x-github: triggersNotification: true githubCloudOnly: false @@ -96814,9 +99498,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-dependencies#list-dependencies-an-issue-is-blocking parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -96828,12 +99512,12 @@ paths: type: array items: *219 examples: - default: *649 + default: *648 headers: Link: *45 - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -96850,9 +99534,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/events#list-issue-events parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -96866,7 +99550,7 @@ paths: title: Issue Event for Issue description: Issue Event for Issue anyOf: - - &652 + - &651 title: Labeled Issue Event description: Labeled Issue Event type: object @@ -96915,7 +99599,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &653 + - &652 title: Unlabeled Issue Event description: Unlabeled Issue Event type: object @@ -97043,7 +99727,7 @@ paths: - performed_via_github_app - assignee - assigner - - &654 + - &653 title: Milestoned Issue Event description: Milestoned Issue Event type: object @@ -97089,7 +99773,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &655 + - &654 title: Demilestoned Issue Event description: Demilestoned Issue Event type: object @@ -97135,7 +99819,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &656 + - &655 title: Renamed Issue Event description: Renamed Issue Event type: object @@ -97184,7 +99868,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &657 + - &656 title: Review Requested Issue Event description: Review Requested Issue Event type: object @@ -97213,7 +99897,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *308 + requested_team: *307 requested_reviewer: *4 required: - review_requester @@ -97226,7 +99910,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &658 + - &657 title: Review Request Removed Issue Event description: Review Request Removed Issue Event type: object @@ -97255,7 +99939,7 @@ paths: - type: 'null' - *5 review_requester: *4 - requested_team: *308 + requested_team: *307 requested_reviewer: *4 required: - review_requester @@ -97268,7 +99952,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &659 + - &658 title: Review Dismissed Issue Event description: Review Dismissed Issue Event type: object @@ -97324,7 +100008,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &660 + - &659 title: Locked Issue Event description: Locked Issue Event type: object @@ -97369,7 +100053,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &661 + - &660 title: Added to Project Issue Event description: Added to Project Issue Event type: object @@ -97430,7 +100114,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &662 + - &661 title: Moved Column in Project Issue Event description: Moved Column in Project Issue Event type: object @@ -97491,7 +100175,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &663 + - &662 title: Removed from Project Issue Event description: Removed from Project Issue Event type: object @@ -97552,7 +100236,7 @@ paths: - commit_url - created_at - performed_via_github_app - - &664 + - &663 title: Converted Note to Issue Issue Event description: Converted Note to Issue Issue Event type: object @@ -97645,7 +100329,7 @@ paths: color: red headers: Link: *45 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97662,9 +100346,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-field-values#list-issue-field-values-for-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -97674,9 +100358,9 @@ paths: application/json: schema: type: array - items: *650 + items: *649 examples: - default: &751 + default: &750 value: - issue_field_id: 1 node_id: IFT_GDKND @@ -97700,9 +100384,9 @@ paths: value: '2025-12-25' headers: Link: *45 - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97719,9 +100403,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -97733,7 +100417,7 @@ paths: type: array items: *218 examples: - default: &651 + default: &650 value: - id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -97751,9 +100435,9 @@ paths: default: false headers: Link: *45 - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97769,9 +100453,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#add-labels-to-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: false content: @@ -97816,10 +100500,10 @@ paths: type: array items: *218 examples: - default: *651 - '301': *460 + default: *650 + '301': *459 '404': *6 - '410': *641 + '410': *640 '422': *15 x-github: githubCloudOnly: false @@ -97836,9 +100520,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#set-labels-for-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: false content: @@ -97900,10 +100584,10 @@ paths: type: array items: *218 examples: - default: *651 - '301': *460 + default: *650 + '301': *459 '404': *6 - '410': *641 + '410': *640 '422': *15 x-github: githubCloudOnly: false @@ -97920,15 +100604,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#remove-all-labels-from-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 responses: '204': description: Response - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97947,9 +100631,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#remove-a-label-from-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 - name: name in: path required: true @@ -97973,9 +100657,9 @@ paths: description: Something isn't working color: f29513 default: true - '301': *460 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -97995,9 +100679,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#lock-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: false content: @@ -98026,7 +100710,7 @@ paths: '204': description: Response '403': *27 - '410': *641 + '410': *640 '404': *6 '422': *15 x-github: @@ -98044,9 +100728,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#unlock-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 responses: '204': description: Response @@ -98076,9 +100760,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#get-parent-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 responses: '200': description: Response @@ -98086,10 +100770,10 @@ paths: application/json: schema: *219 examples: - default: *646 - '301': *460 + default: *645 + '301': *459 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -98106,9 +100790,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to an issue. @@ -98134,13 +100818,13 @@ paths: application/json: schema: type: array - items: *566 + items: *565 examples: - default: *643 + default: *642 headers: Link: *45 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -98158,9 +100842,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: true content: @@ -98192,16 +100876,16 @@ paths: description: Response content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '201': description: Response content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '422': *15 x-github: githubCloudOnly: false @@ -98223,10 +100907,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-an-issue-reaction parameters: + - *453 - *454 - - *455 - - *647 - - *644 + - *646 + - *643 responses: '204': description: Response @@ -98255,9 +100939,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#remove-sub-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: true content: @@ -98281,7 +100965,7 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1/sub-issue @@ -98314,9 +100998,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#list-sub-issues parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -98328,11 +101012,11 @@ paths: type: array items: *219 examples: - default: *649 + default: *648 headers: Link: *45 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -98360,9 +101044,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#add-sub-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: true content: @@ -98391,14 +101075,14 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/sub-issues/1 schema: type: string '403': *27 - '410': *641 + '410': *640 '422': *15 '404': *6 x-github: @@ -98418,9 +101102,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/sub-issues#reprioritize-sub-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 requestBody: required: true content: @@ -98453,7 +101137,7 @@ paths: application/json: schema: *219 examples: - default: *646 + default: *645 '403': *27 '404': *6 '422': *7 @@ -98475,9 +101159,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/timeline#list-timeline-events-for-an-issue parameters: + - *453 - *454 - - *455 - - *647 + - *646 - *17 - *19 responses: @@ -98492,6 +101176,7 @@ paths: description: Timeline Event type: object anyOf: + - *651 - *652 - *653 - *654 @@ -98504,7 +101189,6 @@ paths: - *661 - *662 - *663 - - *664 - title: Timeline Comment Event description: Timeline Comment Event type: object @@ -98561,7 +101245,7 @@ paths: pin: anyOf: - type: 'null' - - *665 + - *664 required: - event - actor @@ -98837,7 +101521,7 @@ paths: type: string comments: type: array - items: &686 + items: &685 title: Pull Request Review Comment description: Pull Request Review Comments are comments on a portion of the Pull Request's diff. @@ -99078,7 +101762,7 @@ paths: type: string comments: type: array - items: *565 + items: *564 - title: Timeline Assigned Issue Event description: Timeline Assigned Issue Event type: object @@ -99353,7 +102037,7 @@ paths: headers: Link: *45 '404': *6 - '410': *641 + '410': *640 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -99370,8 +102054,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#list-deploy-keys parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -99381,7 +102065,7 @@ paths: application/json: schema: type: array - items: &666 + items: &665 title: Deploy Key description: An SSH key granting access to a single repository. type: object @@ -99449,8 +102133,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#create-a-deploy-key parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -99486,9 +102170,9 @@ paths: description: Response content: application/json: - schema: *666 + schema: *665 examples: - default: &667 + default: &666 value: id: 1 key: ssh-rsa AAA... @@ -99522,9 +102206,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#get-a-deploy-key parameters: + - *453 - *454 - - *455 - - &668 + - &667 name: key_id description: The unique identifier of the key. in: path @@ -99536,9 +102220,9 @@ paths: description: Response content: application/json: - schema: *666 + schema: *665 examples: - default: *667 + default: *666 '404': *6 x-github: githubCloudOnly: false @@ -99556,9 +102240,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#delete-a-deploy-key parameters: + - *453 - *454 - - *455 - - *668 + - *667 responses: '204': description: Response @@ -99578,8 +102262,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-a-repository parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -99591,7 +102275,7 @@ paths: type: array items: *218 examples: - default: *651 + default: *650 headers: Link: *45 '404': *6 @@ -99612,8 +102296,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#create-a-label parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -99651,7 +102335,7 @@ paths: application/json: schema: *218 examples: - default: &669 + default: &668 value: id: 208045946 node_id: MDU6TGFiZWwyMDgwNDU5NDY= @@ -99683,8 +102367,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#get-a-label parameters: + - *453 - *454 - - *455 - name: name in: path required: true @@ -99697,7 +102381,7 @@ paths: application/json: schema: *218 examples: - default: *669 + default: *668 '404': *6 x-github: githubCloudOnly: false @@ -99714,8 +102398,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#update-a-label parameters: + - *453 - *454 - - *455 - name: name in: path required: true @@ -99780,8 +102464,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#delete-a-label parameters: + - *453 - *454 - - *455 - name: name in: path required: true @@ -99807,8 +102491,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-languages parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -99844,8 +102528,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/lfs#enable-git-lfs-for-a-repository parameters: + - *453 - *454 - - *455 responses: '202': *37 '403': @@ -99873,8 +102557,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/lfs#disable-git-lfs-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -99900,9 +102584,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/licenses/licenses#get-the-license-for-a-repository parameters: + - *453 - *454 - - *455 - - *540 + - *539 responses: '200': description: Response @@ -100049,8 +102733,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#sync-a-fork-branch-with-the-upstream-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -100115,8 +102799,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/branches/branches#merge-a-branch parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -100150,9 +102834,9 @@ paths: description: Successful Response (The resulting merge commit) content: application/json: - schema: *568 + schema: *567 examples: - default: *670 + default: *669 '204': description: Response when already merged '404': @@ -100177,8 +102861,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#list-milestones parameters: + - *453 - *454 - - *455 - name: state description: The state of the milestone. Either `open`, `closed`, or `all`. in: query @@ -100219,7 +102903,7 @@ paths: application/json: schema: type: array - items: *406 + items: *405 examples: default: value: @@ -100275,8 +102959,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#create-a-milestone parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -100316,9 +103000,9 @@ paths: description: Response content: application/json: - schema: *406 + schema: *405 examples: - default: &671 + default: &670 value: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -100377,9 +103061,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#get-a-milestone parameters: + - *453 - *454 - - *455 - - &672 + - &671 name: milestone_number description: The number that identifies the milestone. in: path @@ -100391,9 +103075,9 @@ paths: description: Response content: application/json: - schema: *406 + schema: *405 examples: - default: *671 + default: *670 '404': *6 x-github: githubCloudOnly: false @@ -100410,9 +103094,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#update-a-milestone parameters: + - *453 - *454 - - *455 - - *672 + - *671 requestBody: required: false content: @@ -100450,9 +103134,9 @@ paths: description: Response content: application/json: - schema: *406 + schema: *405 examples: - default: *671 + default: *670 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -100468,9 +103152,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/milestones#delete-a-milestone parameters: + - *453 - *454 - - *455 - - *672 + - *671 responses: '204': description: Response @@ -100491,9 +103175,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/labels#list-labels-for-issues-in-a-milestone parameters: + - *453 - *454 - - *455 - - *672 + - *671 - *17 - *19 responses: @@ -100505,7 +103189,7 @@ paths: type: array items: *218 examples: - default: *651 + default: *650 headers: Link: *45 x-github: @@ -100524,12 +103208,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#list-repository-notifications-for-the-authenticated-user parameters: + - *453 - *454 - - *455 + - *672 - *673 - - *674 - *224 - - *675 + - *674 - *17 - *19 responses: @@ -100541,7 +103225,7 @@ paths: type: array items: *244 examples: - default: *676 + default: *675 headers: Link: *45 x-github: @@ -100565,8 +103249,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/notifications#mark-repository-notifications-as-read parameters: + - *453 - *454 - - *455 requestBody: required: false content: @@ -100624,14 +103308,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-a-apiname-pages-site parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: &677 + schema: &676 title: GitHub Pages description: The configuration for GitHub Pages for a repository. type: object @@ -100775,7 +103459,7 @@ paths: - custom_404 - public examples: - default: &678 + default: &677 value: url: https://api.github.com/repos/github/developer.github.com/pages status: built @@ -100816,8 +103500,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#create-a-apiname-pages-site parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -100872,9 +103556,9 @@ paths: description: Response content: application/json: - schema: *677 + schema: *676 examples: - default: *678 + default: *677 '422': *15 '409': *119 x-github: @@ -100897,8 +103581,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#update-information-about-a-apiname-pages-site parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -101006,8 +103690,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#delete-a-apiname-pages-site parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -101033,8 +103717,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#list-apiname-pages-builds parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -101044,7 +103728,7 @@ paths: application/json: schema: type: array - items: &679 + items: &678 title: Page Build description: Page Build type: object @@ -101136,8 +103820,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#request-a-apiname-pages-build parameters: + - *453 - *454 - - *455 responses: '201': description: Response @@ -101184,16 +103868,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-latest-pages-build parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *679 + schema: *678 examples: - default: &680 + default: &679 value: url: https://api.github.com/repos/github/developer.github.com/pages/builds/5472601 status: built @@ -101241,8 +103925,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-apiname-pages-build parameters: + - *453 - *454 - - *455 - name: build_id in: path required: true @@ -101253,9 +103937,9 @@ paths: description: Response content: application/json: - schema: *679 + schema: *678 examples: - default: *680 + default: *679 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -101275,8 +103959,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#create-a-github-pages-deployment parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -101384,9 +104068,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-the-status-of-a-github-pages-deployment parameters: + - *453 - *454 - - *455 - - &681 + - &680 name: pages_deployment_id description: The ID of the Pages deployment. You can also give the commit SHA of the deployment. @@ -101444,9 +104128,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#cancel-a-github-pages-deployment parameters: + - *453 - *454 - - *455 - - *681 + - *680 responses: '204': *151 '404': *6 @@ -101473,8 +104157,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pages/pages#get-a-dns-health-check-for-github-pages parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -101742,7 +104426,7 @@ paths: description: Empty response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -101769,8 +104453,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-private-vulnerability-reporting-is-enabled-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Private vulnerability reporting status @@ -101807,8 +104491,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-private-vulnerability-reporting-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': *151 '422': *14 @@ -101829,8 +104513,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-private-vulnerability-reporting-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': *151 '422': *14 @@ -101852,8 +104536,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/custom-properties#get-all-custom-property-values-for-a-repository parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -101863,7 +104547,7 @@ paths: type: array items: *152 examples: - default: *682 + default: *681 '403': *27 '404': *6 x-github: @@ -101885,8 +104569,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/custom-properties#create-or-update-custom-property-values-for-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -101902,7 +104586,7 @@ paths: required: - properties examples: - default: *683 + default: *682 responses: '204': description: No Content when custom property values are successfully created @@ -101940,8 +104624,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-pull-requests parameters: + - *453 - *454 - - *455 - name: state description: Either `open`, `closed`, or `all` to filter by state. in: query @@ -102001,9 +104685,9 @@ paths: application/json: schema: type: array - items: *572 + items: *571 examples: - default: *684 + default: *683 headers: Link: *45 '304': *35 @@ -102035,8 +104719,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#create-a-pull-request parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -102103,7 +104787,7 @@ paths: description: Response content: application/json: - schema: &688 + schema: &687 type: object title: Pull Request description: Pull requests let you tell others about changes you've @@ -102232,7 +104916,7 @@ paths: milestone: anyOf: - type: 'null' - - *406 + - *405 active_lock_reason: type: - string @@ -102281,7 +104965,7 @@ paths: items: *4 requested_teams: type: array - items: *385 + items: *384 head: type: object properties: @@ -102319,14 +105003,14 @@ paths: _links: type: object properties: - comments: *407 - commits: *407 - statuses: *407 - html: *407 - issue: *407 - review_comments: *407 - review_comment: *407 - self: *407 + comments: *406 + commits: *406 + statuses: *406 + html: *406 + issue: *406 + review_comments: *406 + review_comment: *406 + self: *406 required: - comments - commits @@ -102337,7 +105021,7 @@ paths: - review_comment - self author_association: *216 - auto_merge: *685 + auto_merge: *684 draft: description: Indicates whether or not the pull request is a draft. type: boolean @@ -102439,7 +105123,7 @@ paths: - merged_by - review_comments examples: - default: &689 + default: &688 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 id: 1 @@ -102966,8 +105650,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#list-review-comments-in-a-repository parameters: + - *453 - *454 - - *455 - name: sort in: query required: false @@ -102996,9 +105680,9 @@ paths: application/json: schema: type: array - items: *686 + items: *685 examples: - default: &691 + default: &690 value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -103075,17 +105759,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#get-a-review-comment-for-a-pull-request parameters: + - *453 - *454 - - *455 - *233 responses: '200': description: Response content: application/json: - schema: *686 + schema: *685 examples: - default: &687 + default: &686 value: url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 pull_request_review_id: 42 @@ -103160,8 +105844,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#update-a-review-comment-for-a-pull-request parameters: + - *453 - *454 - - *455 - *233 requestBody: required: true @@ -103184,9 +105868,9 @@ paths: description: Response content: application/json: - schema: *686 + schema: *685 examples: - default: *687 + default: *686 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -103202,8 +105886,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#delete-a-review-comment-for-a-pull-request parameters: + - *453 - *454 - - *455 - *233 responses: '204': @@ -103225,8 +105909,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-pull-request-review-comment parameters: + - *453 - *454 - - *455 - *233 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). @@ -103253,9 +105937,9 @@ paths: application/json: schema: type: array - items: *566 + items: *565 examples: - default: *643 + default: *642 headers: Link: *45 '404': *6 @@ -103276,8 +105960,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-pull-request-review-comment parameters: + - *453 - *454 - - *455 - *233 requestBody: required: true @@ -103310,16 +105994,16 @@ paths: description: Reaction exists content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '201': description: Reaction created content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '422': *15 x-github: githubCloudOnly: false @@ -103341,10 +106025,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-pull-request-comment-reaction parameters: + - *453 - *454 - - *455 - *233 - - *644 + - *643 responses: '204': description: Response @@ -103387,9 +106071,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#get-a-pull-request parameters: + - *453 - *454 - - *455 - - &690 + - &689 name: pull_number description: The number that identifies the pull request. in: path @@ -103402,9 +106086,9 @@ paths: to fetch diff and patch formats. content: application/json: - schema: *688 + schema: *687 examples: - default: *689 + default: *688 '304': *35 '404': *6 '406': @@ -103439,9 +106123,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#update-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: false content: @@ -103483,9 +106167,9 @@ paths: description: Response content: application/json: - schema: *688 + schema: *687 examples: - default: *689 + default: *688 '422': *15 '403': *27 x-github: @@ -103507,9 +106191,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-codespace-from-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: true content: @@ -103570,17 +106254,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '401': *23 '403': *27 '404': *6 @@ -103610,9 +106294,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#list-review-comments-on-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 - *241 - name: direction description: The direction to sort results. Ignored without `sort` parameter. @@ -103633,9 +106317,9 @@ paths: application/json: schema: type: array - items: *686 + items: *685 examples: - default: *691 + default: *690 headers: Link: *45 x-github: @@ -103668,9 +106352,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#create-a-review-comment-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: true content: @@ -103776,7 +106460,7 @@ paths: description: Response content: application/json: - schema: *686 + schema: *685 examples: example-for-a-multi-line-comment: value: @@ -103864,9 +106548,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#create-a-reply-for-a-review-comment parameters: + - *453 - *454 - - *455 - - *690 + - *689 - *233 requestBody: required: true @@ -103889,7 +106573,7 @@ paths: description: Response content: application/json: - schema: *686 + schema: *685 examples: default: value: @@ -103975,9 +106659,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-commits-on-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 - *17 - *19 responses: @@ -103987,9 +106671,9 @@ paths: application/json: schema: type: array - items: *568 + items: *567 examples: - default: *692 + default: *691 headers: Link: *45 x-github: @@ -104019,9 +106703,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#list-pull-requests-files parameters: + - *453 - *454 - - *455 - - *690 + - *689 - *17 - *19 responses: @@ -104031,7 +106715,7 @@ paths: application/json: schema: type: array - items: *579 + items: *578 examples: default: value: @@ -104069,9 +106753,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#check-if-a-pull-request-has-been-merged parameters: + - *453 - *454 - - *455 - - *690 + - *689 responses: '204': description: Response if pull request has been merged @@ -104094,9 +106778,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#merge-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: false content: @@ -104208,9 +106892,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#get-all-requested-reviewers-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 responses: '200': description: Response @@ -104226,7 +106910,7 @@ paths: items: *4 teams: type: array - items: *308 + items: *307 required: - users - teams @@ -104285,9 +106969,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#request-reviewers-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: false content: @@ -104324,7 +107008,7 @@ paths: description: Response content: application/json: - schema: *572 + schema: *571 examples: default: value: @@ -104860,9 +107544,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/review-requests#remove-requested-reviewers-from-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: true content: @@ -104896,7 +107580,7 @@ paths: description: Response content: application/json: - schema: *572 + schema: *571 examples: default: value: @@ -105401,9 +108085,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-reviews-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 - *17 - *19 responses: @@ -105413,7 +108097,7 @@ paths: application/json: schema: type: array - items: &693 + items: &692 title: Pull Request Review description: Pull Request Reviews are reviews on pull requests. type: object @@ -105569,9 +108253,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#create-a-review-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: false content: @@ -105661,9 +108345,9 @@ paths: description: Response content: application/json: - schema: *693 + schema: *692 examples: - default: &695 + default: &694 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -105726,10 +108410,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#get-a-review-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 - - &694 + - *689 + - &693 name: review_id description: The unique identifier of the review. in: path @@ -105741,9 +108425,9 @@ paths: description: Response content: application/json: - schema: *693 + schema: *692 examples: - default: &696 + default: &695 value: id: 80 node_id: MDE3OlB1bGxSZXF1ZXN0UmV2aWV3ODA= @@ -105802,10 +108486,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#update-a-review-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 - - *694 + - *689 + - *693 requestBody: required: true content: @@ -105828,7 +108512,7 @@ paths: description: Response content: application/json: - schema: *693 + schema: *692 examples: default: value: @@ -105890,18 +108574,18 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#delete-a-pending-review-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 - - *694 + - *689 + - *693 responses: '200': description: Response content: application/json: - schema: *693 + schema: *692 examples: - default: *695 + default: *694 '422': *7 '404': *6 x-github: @@ -105928,10 +108612,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#list-comments-for-a-pull-request-review parameters: + - *453 - *454 - - *455 - - *690 - - *694 + - *689 + - *693 - *17 - *19 responses: @@ -106029,9 +108713,9 @@ paths: _links: type: object properties: - self: *407 - html: *407 - pull_request: *407 + self: *406 + html: *406 + pull_request: *406 required: - self - html @@ -106189,10 +108873,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#dismiss-a-review-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 - - *694 + - *689 + - *693 requestBody: required: true content: @@ -106221,7 +108905,7 @@ paths: description: Response content: application/json: - schema: *693 + schema: *692 examples: default: value: @@ -106284,10 +108968,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/reviews#submit-a-review-for-a-pull-request parameters: + - *453 - *454 - - *455 - - *690 - - *694 + - *689 + - *693 requestBody: required: true content: @@ -106322,9 +109006,9 @@ paths: description: Response content: application/json: - schema: *693 + schema: *692 examples: - default: *696 + default: *695 '404': *6 '422': *7 '403': *27 @@ -106346,9 +109030,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/pulls/pulls#update-a-pull-request-branch parameters: + - *453 - *454 - - *455 - - *690 + - *689 requestBody: required: false content: @@ -106412,8 +109096,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-a-repository-readme parameters: + - *453 - *454 - - *455 - name: ref description: 'The name of the commit/branch/tag. Default: the repository’s default branch.' @@ -106426,9 +109110,9 @@ paths: description: Response content: application/json: - schema: *697 + schema: *696 examples: - default: &698 + default: &697 value: type: file encoding: base64 @@ -106470,8 +109154,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#get-a-repository-readme-for-a-directory parameters: + - *453 - *454 - - *455 - name: dir description: The alternate path to look for a README file in: path @@ -106491,9 +109175,9 @@ paths: description: Response content: application/json: - schema: *697 + schema: *696 examples: - default: *698 + default: *697 '404': *6 '422': *15 x-github: @@ -106515,8 +109199,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#list-releases parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -106526,7 +109210,7 @@ paths: application/json: schema: type: array - items: *699 + items: *698 examples: default: value: @@ -106620,8 +109304,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#create-a-release parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -106697,9 +109381,9 @@ paths: description: Response content: application/json: - schema: *699 + schema: *698 examples: - default: &703 + default: &702 value: url: https://api.github.com/repos/octocat/Hello-World/releases/1 html_url: https://github.com/octocat/Hello-World/releases/v1.0.0 @@ -106804,9 +109488,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#get-a-release-asset parameters: + - *453 - *454 - - *455 - - &701 + - &700 name: asset_id description: The unique identifier of the asset. in: path @@ -106818,9 +109502,9 @@ paths: description: Response content: application/json: - schema: *700 + schema: *699 examples: - default: &702 + default: &701 value: url: https://api.github.com/repos/octocat/Hello-World/releases/assets/1 browser_download_url: https://github.com/octocat/Hello-World/releases/download/v1.0.0/example.zip @@ -106855,7 +109539,7 @@ paths: type: User site_admin: false '404': *6 - '302': *581 + '302': *580 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -106871,9 +109555,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#update-a-release-asset parameters: + - *453 - *454 - - *455 - - *701 + - *700 requestBody: required: false content: @@ -106902,9 +109586,9 @@ paths: description: Response content: application/json: - schema: *700 + schema: *699 examples: - default: *702 + default: *701 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -106920,9 +109604,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#delete-a-release-asset parameters: + - *453 - *454 - - *455 - - *701 + - *700 responses: '204': description: Response @@ -106947,8 +109631,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#generate-release-notes-content-for-a-release parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -107034,16 +109718,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-the-latest-release parameters: + - *453 - *454 - - *455 responses: '200': description: Response content: application/json: - schema: *699 + schema: *698 examples: - default: *703 + default: *702 '404': *6 x-github: githubCloudOnly: false @@ -107061,8 +109745,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-a-release-by-tag-name parameters: + - *453 - *454 - - *455 - name: tag description: tag parameter in: path @@ -107075,9 +109759,9 @@ paths: description: Response content: application/json: - schema: *699 + schema: *698 examples: - default: *703 + default: *702 '404': *6 x-github: githubCloudOnly: false @@ -107099,9 +109783,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#get-a-release parameters: + - *453 - *454 - - *455 - - &704 + - &703 name: release_id description: The unique identifier of the release. in: path @@ -107115,9 +109799,9 @@ paths: For more information, see "[Getting started with the REST API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/getting-started-with-the-rest-api#hypermedia)."' content: application/json: - schema: *699 + schema: *698 examples: - default: *703 + default: *702 '401': description: Unauthorized x-github: @@ -107135,9 +109819,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#update-a-release parameters: + - *453 - *454 - - *455 - - *704 + - *703 requestBody: required: false content: @@ -107201,9 +109885,9 @@ paths: description: Response content: application/json: - schema: *699 + schema: *698 examples: - default: *703 + default: *702 '404': description: Not Found if the discussion category name is invalid content: @@ -107224,9 +109908,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/releases#delete-a-release parameters: + - *453 - *454 - - *455 - - *704 + - *703 responses: '204': description: Response @@ -107247,9 +109931,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/releases/assets#list-release-assets parameters: + - *453 - *454 - - *455 - - *704 + - *703 - *17 - *19 responses: @@ -107259,7 +109943,7 @@ paths: application/json: schema: type: array - items: *700 + items: *699 examples: default: value: @@ -107341,9 +110025,9 @@ paths: description: The URL origin (protocol + host name + port) is included in `upload_url` returned in the response of the "Create a release" endpoint parameters: + - *453 - *454 - - *455 - - *704 + - *703 - name: name in: query required: true @@ -107369,7 +110053,7 @@ paths: description: Response for successful upload content: application/json: - schema: *700 + schema: *699 examples: response-for-successful-upload: value: @@ -107424,9 +110108,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#list-reactions-for-a-release parameters: + - *453 - *454 - - *455 - - *704 + - *703 - name: content description: Returns a single [reaction type](https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#about-reactions). Omit this parameter to list all reactions to a release. @@ -107450,9 +110134,9 @@ paths: application/json: schema: type: array - items: *566 + items: *565 examples: - default: *643 + default: *642 headers: Link: *45 '404': *6 @@ -107473,9 +110157,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#create-reaction-for-a-release parameters: + - *453 - *454 - - *455 - - *704 + - *703 requestBody: required: true content: @@ -107505,16 +110189,16 @@ paths: description: Reaction exists content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '201': description: Reaction created content: application/json: - schema: *566 + schema: *565 examples: - default: *567 + default: *566 '422': *15 x-github: githubCloudOnly: false @@ -107536,10 +110220,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/reactions/reactions#delete-a-release-reaction parameters: + - *453 - *454 - - *455 - - *704 - - *644 + - *703 + - *643 responses: '204': description: Response @@ -107563,9 +110247,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-rules-for-a-branch parameters: + - *453 - *454 - - *455 - - *507 + - *506 - *17 - *19 responses: @@ -107582,7 +110266,7 @@ paths: oneOf: - allOf: - *166 - - &705 + - &704 title: repository ruleset data for rule description: User-defined metadata to store domain-specific information limited to 8 keys with scalar values. @@ -107603,67 +110287,67 @@ paths: description: The ID of the ruleset that includes this rule. - allOf: - *167 - - *705 + - *704 - allOf: - *168 - - *705 + - *704 - allOf: - *169 - - *705 + - *704 - allOf: - - *706 - *705 + - *704 - allOf: - *170 - - *705 + - *704 - allOf: - *171 - - *705 + - *704 - allOf: - *172 - - *705 + - *704 - allOf: - *173 - - *705 + - *704 - allOf: - *174 - - *705 + - *704 - allOf: - *175 - - *705 + - *704 - allOf: - *176 - - *705 + - *704 - allOf: - *177 - - *705 + - *704 - allOf: - *178 - - *705 + - *704 - allOf: - *179 - - *705 + - *704 - allOf: - *180 - - *705 + - *704 - allOf: - *181 - - *705 + - *704 - allOf: - *182 - - *705 + - *704 - allOf: - *183 - - *705 + - *704 - allOf: - *184 - - *705 + - *704 - allOf: - *185 - - *705 + - *704 - allOf: - *186 - - *705 + - *704 examples: default: value: @@ -107702,8 +110386,8 @@ paths: category: repos subcategory: rules parameters: + - *453 - *454 - - *455 - *17 - *19 - name: includes_parents @@ -107714,7 +110398,7 @@ paths: schema: type: boolean default: true - - *707 + - *706 responses: '200': description: Response @@ -107769,8 +110453,8 @@ paths: category: repos subcategory: rules parameters: + - *453 - *454 - - *455 requestBody: description: Request body required: true @@ -107799,7 +110483,7 @@ paths: rules: type: array description: An array of rules within the ruleset. - items: *708 + items: *707 required: - name - enforcement @@ -107832,7 +110516,7 @@ paths: application/json: schema: *187 examples: - default: &717 + default: &716 value: id: 42 name: super cool ruleset @@ -107880,12 +110564,12 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rule-suites#list-repository-rule-suites parameters: + - *453 - *454 - - *455 - - *709 + - *708 - *105 + - *709 - *710 - - *711 - *17 - *19 responses: @@ -107893,9 +110577,9 @@ paths: description: Response content: application/json: - schema: *712 + schema: *711 examples: - default: *713 + default: *712 '404': *6 '500': *38 x-github: @@ -107916,17 +110600,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rule-suites#get-a-repository-rule-suite parameters: + - *453 - *454 - - *455 - - *714 + - *713 responses: '200': description: Response content: application/json: - schema: *715 + schema: *714 examples: - default: *716 + default: *715 '404': *6 '500': *38 x-github: @@ -107954,8 +110638,8 @@ paths: category: repos subcategory: rules parameters: + - *453 - *454 - - *455 - name: ruleset_id description: The ID of the ruleset. in: path @@ -107977,7 +110661,7 @@ paths: application/json: schema: *187 examples: - default: *717 + default: *716 '404': *6 '500': *38 put: @@ -107995,8 +110679,8 @@ paths: category: repos subcategory: rules parameters: + - *453 - *454 - - *455 - name: ruleset_id description: The ID of the ruleset. in: path @@ -108030,7 +110714,7 @@ paths: rules: description: An array of rules within the ruleset. type: array - items: *708 + items: *707 examples: default: value: @@ -108060,7 +110744,7 @@ paths: application/json: schema: *187 examples: - default: *717 + default: *716 '404': *6 '422': *15 '500': *38 @@ -108079,8 +110763,8 @@ paths: category: repos subcategory: rules parameters: + - *453 - *454 - - *455 - name: ruleset_id description: The ID of the ruleset. in: path @@ -108103,8 +110787,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-repository-ruleset-history parameters: + - *453 - *454 - - *455 - *17 - *19 - name: ruleset_id @@ -108122,7 +110806,7 @@ paths: type: array items: *191 examples: - default: *423 + default: *422 '404': *6 '500': *38 x-github: @@ -108141,8 +110825,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/rules#get-repository-ruleset-version parameters: + - *453 - *454 - - *455 - name: ruleset_id description: The ID of the ruleset. in: path @@ -108160,7 +110844,7 @@ paths: description: Response content: application/json: - schema: *424 + schema: *423 examples: default: value: @@ -108215,22 +110899,22 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-secret-scanning-alerts-for-a-repository parameters: + - *453 - *454 - - *455 + - *424 - *425 - *426 - *427 - *428 - - *429 - *110 - *19 - *17 + - *717 - *718 - - *719 + - *429 - *430 - *431 - *432 - - *433 responses: '200': description: Response @@ -108238,7 +110922,7 @@ paths: application/json: schema: type: array - items: &723 + items: &722 type: object properties: number: *126 @@ -108254,8 +110938,8 @@ paths: format: uri description: The REST API URL of the code locations for this alert. - state: *720 - resolution: *721 + state: *719 + resolution: *720 resolved_at: type: - string @@ -108349,7 +111033,7 @@ paths: first_location_detected: anyOf: - type: 'null' - - *722 + - *721 has_more_locations: type: boolean description: A boolean value representing whether or not the @@ -108494,16 +111178,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#get-a-secret-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 - - *433 + - *533 + - *432 responses: '200': description: Response content: application/json: - schema: *723 + schema: *722 examples: default: value: @@ -108557,9 +111241,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#update-a-secret-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 requestBody: required: true content: @@ -108567,8 +111251,8 @@ paths: schema: type: object properties: - state: *720 - resolution: *721 + state: *719 + resolution: *720 resolution_comment: description: An optional comment when closing or reopening an alert. Cannot be updated or deleted. @@ -108606,7 +111290,7 @@ paths: description: Response content: application/json: - schema: *723 + schema: *722 examples: default: value: @@ -108701,9 +111385,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#list-locations-for-a-secret-scanning-alert parameters: + - *453 - *454 - - *455 - - *534 + - *533 - *19 - *17 responses: @@ -108714,7 +111398,7 @@ paths: schema: type: array description: List of locations where the secret was detected - items: &902 + items: &901 type: object properties: type: @@ -108741,6 +111425,7 @@ paths: - commit details: oneOf: + - *723 - *724 - *725 - *726 @@ -108753,7 +111438,6 @@ paths: - *733 - *734 - *735 - - *736 examples: default: value: @@ -108839,8 +111523,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#create-a-push-protection-bypass parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -108848,14 +111532,14 @@ paths: schema: type: object properties: - reason: &738 + reason: &737 description: The reason for bypassing push protection. type: string enum: - false_positive - used_in_tests - will_fix_later - placeholder_id: *737 + placeholder_id: *736 required: - reason - placeholder_id @@ -108872,7 +111556,7 @@ paths: schema: type: object properties: - reason: *738 + reason: *737 expire_at: type: - string @@ -108919,8 +111603,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/secret-scanning/secret-scanning#get-secret-scanning-scan-history-for-a-repository parameters: + - *453 - *454 - - *455 responses: '404': description: Repository does not have GitHub Advanced Security or secret @@ -108935,7 +111619,7 @@ paths: properties: incremental_scans: type: array - items: &739 + items: &738 description: Information on a single scan performed by secret scanning on the repository type: object @@ -108963,15 +111647,15 @@ paths: the scan is pending pattern_update_scans: type: array - items: *739 + items: *738 backfill_scans: type: array - items: *739 + items: *738 custom_pattern_backfill_scans: type: array items: allOf: - - *739 + - *738 - type: object properties: pattern_name: @@ -109041,8 +111725,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#list-repository-security-advisories parameters: + - *453 - *454 - - *455 - *110 - name: sort description: The property to sort the results by. @@ -109086,9 +111770,9 @@ paths: application/json: schema: type: array - items: *740 + items: *739 examples: - default: *741 + default: *740 '400': *14 '404': *6 x-github: @@ -109111,8 +111795,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#create-a-repository-security-advisory parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -109192,7 +111876,7 @@ paths: login: type: string description: The username of the user credited. - type: *438 + type: *437 required: - login - type @@ -109282,9 +111966,9 @@ paths: description: Response content: application/json: - schema: *740 + schema: *739 examples: - default: &743 + default: &742 value: ghsa_id: GHSA-abcd-1234-efgh cve_id: CVE-2050-00000 @@ -109517,8 +112201,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#privately-report-a-security-vulnerability parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -109631,7 +112315,7 @@ paths: description: Response content: application/json: - schema: *740 + schema: *739 examples: default: value: @@ -109778,17 +112462,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#get-a-repository-security-advisory parameters: + - *453 - *454 - - *455 - - *742 + - *741 responses: '200': description: Response content: application/json: - schema: *740 + schema: *739 examples: - default: *743 + default: *742 '403': *27 '404': *6 x-github: @@ -109812,9 +112496,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#update-a-repository-security-advisory parameters: + - *453 - *454 - - *455 - - *742 + - *741 requestBody: required: true content: @@ -109894,7 +112578,7 @@ paths: login: type: string description: The username of the user credited. - type: *438 + type: *437 required: - login - type @@ -109985,10 +112669,10 @@ paths: description: Response content: application/json: - schema: *740 + schema: *739 examples: - default: *743 - add_credit: *743 + default: *742 + add_credit: *742 '403': *27 '404': *6 '422': @@ -110026,9 +112710,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#request-a-cve-for-a-repository-security-advisory parameters: + - *453 - *454 - - *455 - - *742 + - *741 responses: '202': *37 '400': *14 @@ -110055,17 +112739,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/security-advisories/repository-advisories#create-a-temporary-private-fork parameters: + - *453 - *454 - - *455 - - *742 + - *741 responses: '202': description: Response content: application/json: - schema: *459 + schema: *458 examples: - default: *461 + default: *460 '400': *14 '422': *15 '403': *27 @@ -110091,8 +112775,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-stargazers parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -110188,8 +112872,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-weekly-commit-activity parameters: + - *453 - *454 - - *455 responses: '200': description: Returns a weekly aggregate of the number of additions and deletions @@ -110198,7 +112882,7 @@ paths: application/json: schema: type: array - items: &744 + items: &743 title: Code Frequency Stat description: Code Frequency Stat type: array @@ -110231,8 +112915,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-last-year-of-commit-activity parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -110310,8 +112994,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-all-contributor-commit-activity parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -110405,8 +113089,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-weekly-commit-count parameters: + - *453 - *454 - - *455 responses: '200': description: The array order is oldest week (index 0) to most recent week. @@ -110560,8 +113244,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/statistics#get-the-hourly-commit-count-for-each-day parameters: + - *453 - *454 - - *455 responses: '200': description: For example, `[2, 14, 25]` indicates that there were 25 total @@ -110571,7 +113255,7 @@ paths: application/json: schema: type: array - items: *744 + items: *743 examples: default: value: @@ -110604,8 +113288,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/commits/statuses#create-a-commit-status parameters: + - *453 - *454 - - *455 - name: sha in: path required: true @@ -110661,7 +113345,7 @@ paths: description: Response content: application/json: - schema: *745 + schema: *744 examples: default: value: @@ -110715,8 +113399,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#list-watchers parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -110748,14 +113432,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#get-a-repository-subscription parameters: + - *453 - *454 - - *455 responses: '200': description: if you subscribe to the repository content: application/json: - schema: &746 + schema: &745 title: Repository Invitation description: Repository invitations let you manage who you collaborate with. @@ -110828,8 +113512,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#set-a-repository-subscription parameters: + - *453 - *454 - - *455 requestBody: required: false content: @@ -110855,7 +113539,7 @@ paths: description: Response content: application/json: - schema: *746 + schema: *745 examples: default: value: @@ -110882,8 +113566,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/watching#delete-a-repository-subscription parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -110903,8 +113587,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-tags parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -110986,8 +113670,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#download-a-repository-archive-tar operationId: repos/download-tarball-archive parameters: + - *453 - *454 - - *455 - name: ref in: path required: true @@ -111023,8 +113707,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#list-repository-teams parameters: + - *453 - *454 - - *455 - *17 - *19 responses: @@ -111034,9 +113718,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - default: *386 + default: *385 headers: Link: *45 '404': *6 @@ -111056,8 +113740,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-all-repository-topics parameters: + - *453 - *454 - - *455 - *19 - *17 responses: @@ -111065,7 +113749,7 @@ paths: description: Response content: application/json: - schema: &747 + schema: &746 title: Topic description: A topic aggregates entities that are related to a subject. type: object @@ -111077,7 +113761,7 @@ paths: required: - names examples: - default: &748 + default: &747 value: names: - octocat @@ -111100,8 +113784,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#replace-all-repository-topics parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -111132,9 +113816,9 @@ paths: description: Response content: application/json: - schema: *747 + schema: *746 examples: - default: *748 + default: *747 '404': *6 '422': *7 x-github: @@ -111155,9 +113839,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-repository-clones parameters: + - *453 - *454 - - *455 - - &749 + - &748 name: per description: The time frame to display results for. in: query @@ -111188,7 +113872,7 @@ paths: - 128 clones: type: array - items: &750 + items: &749 title: Traffic type: object properties: @@ -111275,8 +113959,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-top-referral-paths parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -111370,8 +114054,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-top-referral-sources parameters: + - *453 - *454 - - *455 responses: '200': description: Response @@ -111434,9 +114118,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/metrics/traffic#get-page-views parameters: + - *453 - *454 - - *455 - - *749 + - *748 responses: '200': description: Response @@ -111457,7 +114141,7 @@ paths: - 3782 views: type: array - items: *750 + items: *749 required: - uniques - count @@ -111534,8 +114218,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#transfer-a-repository parameters: + - *453 - *454 - - *455 requestBody: required: true content: @@ -111571,7 +114255,7 @@ paths: description: Response content: application/json: - schema: *279 + schema: *278 examples: default: value: @@ -111809,8 +114493,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#check-if-vulnerability-alerts-are-enabled-for-a-repository parameters: + - *453 - *454 - - *455 responses: '204': description: Response if repository is enabled with vulnerability alerts @@ -111833,8 +114517,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#enable-vulnerability-alerts parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -111856,8 +114540,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#disable-vulnerability-alerts parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -111883,8 +114567,8 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/repos/contents#download-a-repository-archive-zip operationId: repos/download-zipball-archive parameters: + - *453 - *454 - - *455 - name: ref in: path required: true @@ -111976,9 +114660,9 @@ paths: description: Response content: application/json: - schema: *459 + schema: *458 examples: - default: *461 + default: *460 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -112019,7 +114703,7 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: default: value: @@ -112125,8 +114809,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-field-values#add-issue-field-values-to-an-issue parameters: - - *273 - - *647 + - *272 + - *646 requestBody: required: true content: @@ -112192,9 +114876,9 @@ paths: type: array description: The current issue field values for this issue after adding the new values - items: *650 + items: *649 examples: - default: *751 + default: *750 '400': *14 '403': *27 '404': *6 @@ -112230,8 +114914,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-field-values#set-issue-field-values-for-an-issue parameters: - - *273 - - *647 + - *272 + - *646 requestBody: required: true content: @@ -112298,9 +114982,9 @@ paths: type: array description: The current issue field values for this issue after setting the new values - items: *650 + items: *649 examples: - default: *751 + default: *750 '400': *14 '403': *27 '404': *6 @@ -112331,9 +115015,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issue-field-values#delete-an-issue-field-value-from-an-issue parameters: - - *273 - - *647 - - *371 + - *272 + - *646 + - *370 responses: '204': description: Issue field value deleted successfully @@ -112375,7 +115059,7 @@ paths: value: Engineering externalId: value: 8aa1a0c0-c4c3-4bc0-b4a5-2ef676900159 - - &759 + - &758 name: excludedAttributes description: Excludes the specified attribute from being returned in the results. Using this parameter can speed up response time. @@ -112385,7 +115069,7 @@ paths: type: string examples: - members - - &764 + - &763 name: startIndex description: 'Used for pagination: the starting index of the first result to return when paginating through values.' @@ -112397,7 +115081,7 @@ paths: format: int32 examples: - 1 - - &765 + - &764 name: count description: 'Used for pagination: the number of results to return per page.' in: query @@ -112441,7 +115125,7 @@ paths: Resources: type: array description: Information about each provisioned group. - items: &754 + items: &753 allOf: - type: object required: @@ -112523,7 +115207,7 @@ paths: - value: 0db508eb-91e2-46e4-809c-30dcbda0c685 "$+ref": https://api.github.localhost/scim/v2/Users/0db508eb-91e2-46e4-809c-30dcbda0c685 displayName: User 2 - meta: &766 + meta: &765 type: object description: The metadata associated with the creation/updates to the user. @@ -112588,30 +115272,30 @@ paths: location: https://api.github.localhost/scim/v2/Groups/24b28bbb-5fc4-4686-a153-a020debb1155 startIndex: 1 itemsPerPage: 20 - '400': &755 + '400': &754 description: Bad request content: application/json: - schema: *752 + schema: *751 application/scim+json: - schema: *752 - '401': *753 - '403': &756 + schema: *751 + '401': *752 + '403': &755 description: Permission denied - '429': &757 + '429': &756 description: Too many requests content: application/json: - schema: *752 + schema: *751 application/scim+json: - schema: *752 - '500': &758 + schema: *751 + '500': &757 description: Internal server error content: application/json: - schema: *752 + schema: *751 application/scim+json: - schema: *752 + schema: *751 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -112635,7 +115319,7 @@ paths: required: true content: application/json: - schema: &762 + schema: &761 type: object required: - schemas @@ -112699,9 +115383,9 @@ paths: description: Group has been created content: application/scim+json: - schema: *754 + schema: *753 examples: - group: &760 + group: &759 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:Group @@ -112720,13 +115404,13 @@ paths: created: '2012-03-27T19:59:26.000Z' lastModified: '2018-03-27T19:59:26.000Z' location: https://api.github.localhost/scim/v2/Groups/24b28bbb-5fc4-4686-a153-a020debb1155 - '400': *755 - '401': *753 - '403': *756 - '409': &763 + '400': *754 + '401': *752 + '403': *755 + '409': &762 description: Duplicate record detected - '429': *757 - '500': *758 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -112743,7 +115427,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#get-scim-provisioning-information-for-an-enterprise-group parameters: - - &761 + - &760 name: scim_group_id description: A unique identifier of the SCIM group. in: path @@ -112752,22 +115436,22 @@ paths: type: string examples: - 7fce0092-d52e-4f76-b727-3955bd72c939 - - *759 + - *758 - *39 responses: '200': description: Success, a group was found content: application/scim+json: - schema: *754 + schema: *753 examples: - default: *760 - '400': *755 - '401': *753 - '403': *756 + default: *759 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '429': *757 - '500': *758 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -112786,13 +115470,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#set-scim-information-for-a-provisioned-enterprise-group parameters: - - *761 + - *760 - *39 requestBody: required: true content: application/json: - schema: *762 + schema: *761 examples: group: summary: Group @@ -112818,17 +115502,17 @@ paths: description: Group was updated content: application/scim+json: - schema: *754 + schema: *753 examples: - group: *760 - groupWithMembers: *760 - '400': *755 - '401': *753 - '403': *756 + group: *759 + groupWithMembers: *759 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '409': *763 - '429': *757 - '500': *758 + '409': *762 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -112852,13 +115536,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#update-an-attribute-for-a-scim-enterprise-group parameters: - - *761 + - *760 - *39 requestBody: required: true content: application/json: - schema: &773 + schema: &772 type: object required: - Operations @@ -112918,17 +115602,17 @@ paths: description: Success, group was updated content: application/scim+json: - schema: *754 + schema: *753 examples: - updateGroup: *760 - addMembers: *760 - '400': *755 - '401': *753 - '403': *756 + updateGroup: *759 + addMembers: *759 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '409': *763 - '429': *757 - '500': *758 + '409': *762 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -112944,17 +115628,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#delete-a-scim-group-from-an-enterprise parameters: - - *761 + - *760 - *39 responses: '204': description: Group was deleted, no content - '400': *755 - '401': *753 - '403': *756 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '429': *757 - '500': *758 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -112988,8 +115672,8 @@ paths: value: userName eq 'E012345' externalId: value: externalId eq 'E012345' + - *763 - *764 - - *765 - *39 responses: '200': @@ -113023,7 +115707,7 @@ paths: Resources: type: array description: Information about each provisioned account. - items: &768 + items: &767 allOf: - type: object required: @@ -113115,7 +115799,7 @@ paths: address. examples: - true - roles: &767 + roles: &766 type: array description: The roles assigned to the user. items: @@ -113174,7 +115858,7 @@ paths: type: string description: Provisioned SCIM groups that the user is a member of. - meta: *766 + meta: *765 startIndex: type: integer description: A starting index for the returned page @@ -113213,11 +115897,11 @@ paths: primary: false startIndex: 1 itemsPerPage: 20 - '400': *755 - '401': *753 - '403': *756 - '429': *757 - '500': *758 + '400': *754 + '401': *752 + '403': *755 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -113241,7 +115925,7 @@ paths: required: true content: application/json: - schema: &771 + schema: &770 type: object required: - schemas @@ -113334,9 +116018,9 @@ paths: description: Whether this email address is the primary address. examples: - true - roles: *767 + roles: *766 examples: - user: &772 + user: &771 summary: User value: schemas: @@ -113383,9 +116067,9 @@ paths: description: User has been created content: application/scim+json: - schema: *768 + schema: *767 examples: - user: &769 + user: &768 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:User @@ -113411,13 +116095,13 @@ paths: created: '2012-03-27T19:59:26.000Z' lastModified: '2018-03-27T19:59:26.000Z' location: https://api.github.localhost/scim/v2/Users/7fce0092-d52e-4f76-b727-3955bd72c939 - enterpriseOwner: *769 - '400': *755 - '401': *753 - '403': *756 - '409': *763 - '429': *757 - '500': *758 + enterpriseOwner: *768 + '400': *754 + '401': *752 + '403': *755 + '409': *762 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -113434,7 +116118,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#get-scim-provisioning-information-for-an-enterprise-user parameters: - - &770 + - &769 name: scim_user_id description: The unique identifier of the SCIM user. in: path @@ -113447,15 +116131,15 @@ paths: description: Success, a user was found content: application/scim+json: - schema: *768 + schema: *767 examples: - default: *769 - '400': *755 - '401': *753 - '403': *756 + default: *768 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '429': *757 - '500': *758 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -113506,30 +116190,30 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#set-scim-information-for-a-provisioned-enterprise-user parameters: - - *770 + - *769 - *39 requestBody: required: true content: application/json: - schema: *771 + schema: *770 examples: - user: *772 + user: *771 responses: '200': description: User was updated content: application/scim+json: - schema: *768 + schema: *767 examples: - user: *769 - '400': *755 - '401': *753 - '403': *756 + user: *768 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '409': *763 - '429': *757 - '500': *758 + '409': *762 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -113570,13 +116254,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#update-an-attribute-for-a-scim-enterprise-user parameters: - - *770 + - *769 - *39 requestBody: required: true content: application/json: - schema: *773 + schema: *772 examples: userMultiValuedProperties: summary: Multi Valued Property @@ -113616,18 +116300,18 @@ paths: description: Success, user was updated content: application/scim+json: - schema: *768 + schema: *767 examples: - userMultiValuedProperties: *769 - userSingleValuedProperties: *769 - disableUser: *769 - '400': *755 - '401': *753 - '403': *756 + userMultiValuedProperties: *768 + userSingleValuedProperties: *768 + disableUser: *768 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '409': *763 - '429': *757 - '500': *758 + '409': *762 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -113647,17 +116331,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/enterprise-admin/scim#delete-a-scim-user-from-an-enterprise parameters: - - *770 + - *769 - *39 responses: '204': description: User was deleted, no content - '400': *755 - '401': *753 - '403': *756 + '400': *754 + '401': *752 + '403': *755 '404': *6 - '429': *757 - '500': *758 + '429': *756 + '500': *757 x-github: enabledForGitHubApps: true githubCloudOnly: true @@ -113748,7 +116432,7 @@ paths: - 1 Resources: type: array - items: &774 + items: &773 title: SCIM /Users description: SCIM /Users provisioning endpoints type: object @@ -113995,22 +116679,22 @@ paths: lastModified: '2017-03-09T16:11:13-05:00' location: https://api.github.com/scim/v2/organizations/octo-org/Users/77563764-eb6-24-0598234-958243 '304': *35 - '404': &775 + '404': &774 description: Resource not found content: application/json: - schema: *752 + schema: *751 application/scim+json: - schema: *752 - '403': &776 + schema: *751 + '403': &775 description: Forbidden content: application/json: - schema: *752 + schema: *751 application/scim+json: - schema: *752 - '400': *755 - '429': *757 + schema: *751 + '400': *754 + '429': *756 x-github: githubCloudOnly: true enabledForGitHubApps: true @@ -114036,9 +116720,9 @@ paths: description: Response content: application/scim+json: - schema: *774 + schema: *773 examples: - default: &777 + default: &776 value: schemas: - urn:ietf:params:scim:schemas:core:2.0:User @@ -114061,17 +116745,17 @@ paths: lastModified: '2017-03-09T16:11:13-05:00' location: https://api.github.com/scim/v2/organizations/octo-org/Users/edefdfedf-050c-11e7-8d32 '304': *35 - '404': *775 - '403': *776 - '500': *758 + '404': *774 + '403': *775 + '500': *757 '409': description: Conflict content: application/json: - schema: *752 + schema: *751 application/scim+json: - schema: *752 - '400': *755 + schema: *751 + '400': *754 requestBody: required: true content: @@ -114171,17 +116855,17 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#get-scim-provisioning-information-for-a-user parameters: - *87 - - *770 + - *769 responses: '200': description: Response content: application/scim+json: - schema: *774 + schema: *773 examples: - default: *777 - '404': *775 - '403': *776 + default: *776 + '404': *774 + '403': *775 '304': *35 x-github: githubCloudOnly: true @@ -114205,18 +116889,18 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#update-a-provisioned-organization-membership parameters: - *87 - - *770 + - *769 responses: '200': description: Response content: application/scim+json: - schema: *774 + schema: *773 examples: - default: *777 + default: *776 '304': *35 - '404': *775 - '403': *776 + '404': *774 + '403': *775 requestBody: required: true content: @@ -114331,19 +117015,19 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#update-an-attribute-for-a-scim-user parameters: - *87 - - *770 + - *769 responses: '200': description: Response content: application/scim+json: - schema: *774 + schema: *773 examples: - default: *777 + default: *776 '304': *35 - '404': *775 - '403': *776 - '400': *755 + '404': *774 + '403': *775 + '400': *754 '429': description: Response content: @@ -114439,12 +117123,12 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/scim/scim#delete-a-scim-user-from-an-organization parameters: - *87 - - *770 + - *769 responses: '204': description: Response - '404': *775 - '403': *776 + '404': *774 + '403': *775 '304': *35 x-github: githubCloudOnly: true @@ -114559,7 +117243,7 @@ paths: html_url: type: string format: uri - repository: *279 + repository: *278 score: type: number file_size: @@ -114578,7 +117262,7 @@ paths: examples: - 73..77 - 77..78 - text_matches: &778 + text_matches: &777 title: Search Result Text Matches type: array items: @@ -114742,7 +117426,7 @@ paths: enum: - author-date - committer-date - - &779 + - &778 name: order description: Determines whether the first search result returned is the highest number of matches (`desc`) or lowest number of matches (`asc`). This parameter @@ -114811,7 +117495,7 @@ paths: committer: anyOf: - type: 'null' - - *505 + - *504 comment_count: type: integer message: @@ -114830,7 +117514,7 @@ paths: url: type: string format: uri - verification: *628 + verification: *627 required: - author - committer @@ -114845,7 +117529,7 @@ paths: committer: anyOf: - type: 'null' - - *505 + - *504 parents: type: array items: @@ -114857,12 +117541,12 @@ paths: type: string sha: type: string - repository: *279 + repository: *278 score: type: number node_id: type: string - text_matches: *778 + text_matches: *777 required: - sha - node_id @@ -115055,7 +117739,7 @@ paths: - interactions - created - updated - - *779 + - *778 - *17 - *19 - name: advanced_search @@ -115169,11 +117853,11 @@ paths: type: - string - 'null' - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: type: string state_reason: @@ -115187,7 +117871,7 @@ paths: milestone: anyOf: - type: 'null' - - *406 + - *405 comments: type: integer created_at: @@ -115201,7 +117885,7 @@ paths: - string - 'null' format: date-time - text_matches: *778 + text_matches: *777 pull_request: type: object properties: @@ -115250,7 +117934,7 @@ paths: timeline_url: type: string format: uri - type: *372 + type: *371 performed_via_github_app: anyOf: - type: 'null' @@ -115467,7 +118151,7 @@ paths: enum: - created - updated - - *779 + - *778 - *17 - *19 responses: @@ -115512,7 +118196,7 @@ paths: - 'null' score: type: number - text_matches: *778 + text_matches: *777 required: - id - node_id @@ -115598,7 +118282,7 @@ paths: - forks - help-wanted-issues - updated - - *779 + - *778 - *17 - *19 responses: @@ -115844,7 +118528,7 @@ paths: - admin - pull - push - text_matches: *778 + text_matches: *777 temp_clone_token: type: string allow_merge_commit: @@ -116153,7 +118837,7 @@ paths: - string - 'null' format: uri - text_matches: *778 + text_matches: *777 related: type: - array @@ -116348,7 +119032,7 @@ paths: - followers - repositories - joined - - *779 + - *778 - *17 - *19 responses: @@ -116458,7 +119142,7 @@ paths: type: - boolean - 'null' - text_matches: *778 + text_matches: *777 blog: type: - string @@ -116540,7 +119224,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#get-a-team-legacy parameters: - - &782 + - &781 name: team_id description: The unique identifier of the team. in: path @@ -116552,9 +119236,9 @@ paths: description: Response content: application/json: - schema: *446 + schema: *445 examples: - default: *447 + default: *446 '404': *6 x-github: githubCloudOnly: false @@ -116581,7 +119265,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#update-a-team-legacy parameters: - - *782 + - *781 requestBody: required: true content: @@ -116645,16 +119329,16 @@ paths: description: Response when the updated information already exists content: application/json: - schema: *446 + schema: *445 examples: - default: *447 + default: *446 '201': description: Response content: application/json: - schema: *446 + schema: *445 examples: - default: *447 + default: *446 '404': *6 '422': *15 '403': *27 @@ -116682,7 +119366,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#delete-a-team-legacy parameters: - - *782 + - *781 responses: '204': description: Response @@ -116711,7 +119395,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-pending-team-invitations-legacy parameters: - - *782 + - *781 - *17 - *19 responses: @@ -116721,9 +119405,9 @@ paths: application/json: schema: type: array - items: *366 + items: *365 examples: - default: *367 + default: *366 headers: Link: *45 x-github: @@ -116749,7 +119433,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#list-team-members-legacy parameters: - - *782 + - *781 - name: role description: Filters members returned by their role in the team. in: query @@ -116800,7 +119484,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-member-legacy parameters: - - *782 + - *781 - *139 responses: '204': @@ -116837,7 +119521,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-team-member-legacy parameters: - - *782 + - *781 - *139 responses: '204': @@ -116877,7 +119561,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-member-legacy parameters: - - *782 + - *781 - *139 responses: '204': @@ -116914,16 +119598,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#get-team-membership-for-a-user-legacy parameters: - - *782 + - *781 - *139 responses: '200': description: Response content: application/json: - schema: *453 + schema: *452 examples: - response-if-user-is-a-team-maintainer: *783 + response-if-user-is-a-team-maintainer: *782 '404': *6 x-github: githubCloudOnly: false @@ -116956,7 +119640,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#add-or-update-team-membership-for-a-user-legacy parameters: - - *782 + - *781 - *139 requestBody: required: false @@ -116982,9 +119666,9 @@ paths: description: Response content: application/json: - schema: *453 + schema: *452 examples: - response-if-users-membership-with-team-is-now-pending: *784 + response-if-users-membership-with-team-is-now-pending: *783 '403': description: Forbidden if team synchronization is set up '422': @@ -117018,7 +119702,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/members#remove-team-membership-for-a-user-legacy parameters: - - *782 + - *781 - *139 responses: '204': @@ -117046,7 +119730,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-team-repositories-legacy parameters: - - *782 + - *781 - *17 - *19 responses: @@ -117056,9 +119740,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 '404': *6 @@ -117088,15 +119772,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#check-team-permissions-for-a-repository-legacy parameters: - - *782 + - *781 + - *453 - *454 - - *455 responses: '200': description: Alternative response with extra repository information content: application/json: - schema: *785 + schema: *784 examples: alternative-response-with-extra-repository-information: value: @@ -117247,9 +119931,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#add-or-update-team-repository-permissions-legacy parameters: - - *782 + - *781 + - *453 - *454 - - *455 requestBody: required: false content: @@ -117299,9 +119983,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#remove-a-repository-from-a-team-legacy parameters: - - *782 + - *781 + - *453 - *454 - - *455 responses: '204': description: Response @@ -117330,15 +120014,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#list-idp-groups-for-a-team-legacy parameters: - - *782 + - *781 responses: '200': description: Response content: application/json: - schema: *456 + schema: *455 examples: - default: *457 + default: *456 '403': *27 '404': *6 x-github: @@ -117365,7 +120049,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/team-sync#create-or-update-idp-group-connections-legacy parameters: - - *782 + - *781 requestBody: required: true content: @@ -117426,7 +120110,7 @@ paths: description: Response content: application/json: - schema: *456 + schema: *455 examples: default: value: @@ -117457,7 +120141,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/teams/teams#list-child-teams-legacy parameters: - - *782 + - *781 - *17 - *19 responses: @@ -117467,9 +120151,9 @@ paths: application/json: schema: type: array - items: *308 + items: *307 examples: - response-if-child-teams-exist: *786 + response-if-child-teams-exist: *785 headers: Link: *45 '404': *6 @@ -117502,7 +120186,7 @@ paths: application/json: schema: oneOf: - - &788 + - &787 title: Private User description: Private User type: object @@ -117752,7 +120436,7 @@ paths: - private_gists - total_private_repos - two_factor_authentication - - *787 + - *786 examples: response-with-public-and-private-profile-information: summary: Response with public and private profile information @@ -117912,7 +120596,7 @@ paths: description: Response content: application/json: - schema: *788 + schema: *787 examples: default: value: @@ -118115,9 +120799,9 @@ paths: type: integer codespaces: type: array - items: *377 + items: *376 examples: - default: *378 + default: *377 '304': *35 '500': *38 '401': *23 @@ -118256,17 +120940,17 @@ paths: description: Response when the codespace was successfully created content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '202': description: Response when the codespace creation partially failed but is being retried in the background content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '401': *23 '403': *27 '404': *6 @@ -118310,7 +120994,7 @@ paths: type: integer secrets: type: array - items: &789 + items: &788 title: Codespaces Secret description: Secrets for a GitHub Codespace. type: object @@ -118352,7 +121036,7 @@ paths: - visibility - selected_repositories_url examples: - default: *559 + default: *558 headers: Link: *45 x-github: @@ -118424,13 +121108,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#get-a-secret-for-the-authenticated-user parameters: - - *289 + - *288 responses: '200': description: Response content: application/json: - schema: *789 + schema: *788 examples: default: value: @@ -118460,7 +121144,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#create-or-update-a-secret-for-the-authenticated-user parameters: - - *289 + - *288 requestBody: required: true content: @@ -118505,7 +121189,7 @@ paths: description: Response after successfully creating a secret content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -118533,7 +121217,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#delete-a-secret-for-the-authenticated-user parameters: - - *289 + - *288 responses: '204': description: Response @@ -118558,7 +121242,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#list-selected-repositories-for-a-user-secret parameters: - - *289 + - *288 responses: '200': description: Response @@ -118574,9 +121258,9 @@ paths: type: integer repositories: type: array - items: *279 + items: *278 examples: - default: *323 + default: *322 '401': *23 '403': *27 '404': *6 @@ -118601,7 +121285,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#set-selected-repositories-for-a-user-secret parameters: - - *289 + - *288 requestBody: required: true content: @@ -118655,7 +121339,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#add-a-selected-repository-to-a-user-secret parameters: - - *289 + - *288 - name: repository_id in: path required: true @@ -118688,7 +121372,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/secrets#remove-a-selected-repository-from-a-user-secret parameters: - - *289 + - *288 - name: repository_id in: path required: true @@ -118720,15 +121404,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-a-codespace-for-the-authenticated-user parameters: - - *379 + - *378 responses: '200': description: Response content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '304': *35 '500': *38 '401': *23 @@ -118754,7 +121438,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#update-a-codespace-for-the-authenticated-user parameters: - - *379 + - *378 requestBody: required: false content: @@ -118784,9 +121468,9 @@ paths: description: Response content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '401': *23 '403': *27 '404': *6 @@ -118808,7 +121492,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#delete-a-codespace-for-the-authenticated-user parameters: - - *379 + - *378 responses: '202': *37 '304': *35 @@ -118837,13 +121521,13 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#export-a-codespace-for-the-authenticated-user parameters: - - *379 + - *378 responses: '202': description: Response content: application/json: - schema: &790 + schema: &789 type: object title: Fetches information about an export of a codespace. description: An export of a codespace. Also, latest export details @@ -118896,7 +121580,7 @@ paths: examples: - https://github.com/octocat/hello-world/tree/:branch examples: - default: &791 + default: &790 value: state: succeeded completed_at: '2022-01-01T14:59:22Z' @@ -118928,7 +121612,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#get-details-about-a-codespace-export parameters: - - *379 + - *378 - name: export_id in: path required: true @@ -118941,9 +121625,9 @@ paths: description: Response content: application/json: - schema: *790 + schema: *789 examples: - default: *791 + default: *790 '404': *6 x-github: githubCloudOnly: false @@ -118964,7 +121648,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/machines#list-machine-types-for-a-codespace parameters: - - *379 + - *378 responses: '200': description: Response @@ -118980,9 +121664,9 @@ paths: type: integer machines: type: array - items: *558 + items: *557 examples: - default: *792 + default: *791 '304': *35 '500': *38 '401': *23 @@ -119011,7 +121695,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#create-a-repository-from-an-unpublished-codespace parameters: - - *379 + - *378 requestBody: required: true content: @@ -119067,11 +121751,11 @@ paths: - 26a7c758-7299-4a73-b978-5a92a7ae98a0 owner: *4 billable_owner: *4 - repository: *459 + repository: *458 machine: anyOf: - type: 'null' - - *558 + - *557 devcontainer_path: description: Path to devcontainer.json from repo root used to create Codespace. @@ -119868,15 +122552,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#start-a-codespace-for-the-authenticated-user parameters: - - *379 + - *378 responses: '200': description: Response content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '304': *35 '500': *38 '400': *14 @@ -119908,15 +122592,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/codespaces/codespaces#stop-a-codespace-for-the-authenticated-user parameters: - - *379 + - *378 responses: '200': description: Response content: application/json: - schema: *377 + schema: *376 examples: - default: *557 + default: *556 '500': *38 '401': *23 '403': *27 @@ -119946,9 +122630,9 @@ paths: application/json: schema: type: array - items: *387 + items: *386 examples: - default: &803 + default: &802 value: - id: 197 name: hello_docker @@ -120049,7 +122733,7 @@ paths: application/json: schema: type: array - items: &793 + items: &792 title: Email description: Email type: object @@ -120119,9 +122803,9 @@ paths: application/json: schema: type: array - items: *793 + items: *792 examples: - default: &805 + default: &804 value: - email: octocat@github.com verified: true @@ -120198,7 +122882,7 @@ paths: application/json: schema: type: array - items: *793 + items: *792 examples: default: value: @@ -120456,7 +123140,7 @@ paths: application/json: schema: type: array - items: &794 + items: &793 title: GPG Key description: A unique encryption key type: object @@ -120601,7 +123285,7 @@ paths: - subkeys - revoked examples: - default: &821 + default: &820 value: - id: 3 name: Octocat's GPG Key @@ -120686,9 +123370,9 @@ paths: description: Response content: application/json: - schema: *794 + schema: *793 examples: - default: &795 + default: &794 value: id: 3 name: Octocat's GPG Key @@ -120745,7 +123429,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#get-a-gpg-key-for-the-authenticated-user parameters: - - &796 + - &795 name: gpg_key_id description: The unique identifier of the GPG key. in: path @@ -120757,9 +123441,9 @@ paths: description: Response content: application/json: - schema: *794 + schema: *793 examples: - default: *795 + default: *794 '404': *6 '304': *35 '403': *27 @@ -120782,7 +123466,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/gpg-keys#delete-a-gpg-key-for-the-authenticated-user parameters: - - *796 + - *795 responses: '204': description: Response @@ -120975,7 +123659,7 @@ paths: allOf: - *78 examples: - default: *274 + default: *273 headers: Link: *45 '404': *6 @@ -121001,7 +123685,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/apps/installations#add-a-repository-to-an-app-installation parameters: - *21 - - *273 + - *272 responses: '204': description: Response @@ -121027,7 +123711,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/apps/installations#remove-a-repository-from-an-app-installation parameters: - *21 - - *273 + - *272 responses: '204': description: Response @@ -121061,12 +123745,12 @@ paths: application/json: schema: anyOf: - - *364 + - *363 - type: object properties: {} additionalProperties: false examples: - default: *365 + default: *364 '204': description: Response when there are no restrictions x-github: @@ -121090,7 +123774,7 @@ paths: required: true content: application/json: - schema: *638 + schema: *637 examples: default: value: @@ -121101,7 +123785,7 @@ paths: description: Response content: application/json: - schema: *364 + schema: *363 examples: default: value: @@ -121182,7 +123866,7 @@ paths: - closed - all default: open - - *375 + - *374 - name: sort description: What to sort results by. in: query @@ -121207,7 +123891,7 @@ paths: type: array items: *219 examples: - default: *376 + default: *375 headers: Link: *45 '404': *6 @@ -121240,7 +123924,7 @@ paths: application/json: schema: type: array - items: &797 + items: &796 title: Key description: Key type: object @@ -121343,9 +124027,9 @@ paths: description: Response content: application/json: - schema: *797 + schema: *796 examples: - default: &798 + default: &797 value: key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 id: 2 @@ -121378,15 +124062,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#get-a-public-ssh-key-for-the-authenticated-user parameters: - - *668 + - *667 responses: '200': description: Response content: application/json: - schema: *797 + schema: *796 examples: - default: *798 + default: *797 '404': *6 '304': *35 '403': *27 @@ -121409,7 +124093,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/keys#delete-a-public-ssh-key-for-the-authenticated-user parameters: - - *668 + - *667 responses: '204': description: Response @@ -121442,7 +124126,7 @@ paths: application/json: schema: type: array - items: &799 + items: &798 title: User Marketplace Purchase description: User Marketplace Purchase type: object @@ -121521,7 +124205,7 @@ paths: - account - plan examples: - default: &800 + default: &799 value: - billing_cycle: monthly next_billing_date: '2017-11-11T00:00:00Z' @@ -121583,9 +124267,9 @@ paths: application/json: schema: type: array - items: *799 + items: *798 examples: - default: *800 + default: *799 headers: Link: *45 '304': *35 @@ -121625,7 +124309,7 @@ paths: application/json: schema: type: array - items: *380 + items: *379 examples: default: value: @@ -121739,7 +124423,7 @@ paths: description: Response content: application/json: - schema: *380 + schema: *379 examples: default: value: @@ -121826,7 +124510,7 @@ paths: description: Response content: application/json: - schema: *380 + schema: *379 examples: default: value: @@ -121898,7 +124582,7 @@ paths: application/json: schema: type: array - items: *382 + items: *381 examples: default: value: @@ -122160,7 +124844,7 @@ paths: description: Response content: application/json: - schema: *382 + schema: *381 examples: default: value: @@ -122340,7 +125024,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#get-a-user-migration-status parameters: - - *383 + - *382 - name: exclude in: query required: false @@ -122353,7 +125037,7 @@ paths: description: Response content: application/json: - schema: *382 + schema: *381 examples: default: value: @@ -122547,7 +125231,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#download-a-user-migration-archive parameters: - - *383 + - *382 responses: '302': description: Response @@ -122573,7 +125257,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#delete-a-user-migration-archive parameters: - - *383 + - *382 responses: '204': description: Response @@ -122602,8 +125286,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#unlock-a-user-repository parameters: - - *383 - - *801 + - *382 + - *800 responses: '204': description: Response @@ -122627,7 +125311,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/migrations/users#list-repositories-for-a-user-migration parameters: - - *383 + - *382 - *17 - *19 responses: @@ -122637,9 +125321,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 '404': *6 @@ -122718,7 +125402,7 @@ paths: - docker - nuget - container - - *802 + - *801 - *19 - *17 responses: @@ -122728,10 +125412,10 @@ paths: application/json: schema: type: array - items: *387 + items: *386 examples: - default: *803 - '400': *804 + default: *802 + '400': *803 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -122751,16 +125435,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-the-authenticated-user parameters: + - *388 - *389 - - *390 responses: '200': description: Response content: application/json: - schema: *387 + schema: *386 examples: - default: &822 + default: &821 value: id: 40201 name: octo-name @@ -122873,8 +125557,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-the-authenticated-user parameters: + - *388 - *389 - - *390 responses: '204': description: Response @@ -122904,8 +125588,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-the-authenticated-user parameters: + - *388 - *389 - - *390 - name: token description: package token schema: @@ -122937,8 +125621,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-the-authenticated-user parameters: + - *388 - *389 - - *390 - *19 - *17 - name: state @@ -122958,7 +125642,7 @@ paths: application/json: schema: type: array - items: *391 + items: *390 examples: default: value: @@ -123007,15 +125691,15 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-the-authenticated-user parameters: + - *388 - *389 - - *390 - - *392 + - *391 responses: '200': description: Response content: application/json: - schema: *391 + schema: *390 examples: default: value: @@ -123051,9 +125735,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-version-for-the-authenticated-user parameters: + - *388 - *389 - - *390 - - *392 + - *391 responses: '204': description: Response @@ -123083,9 +125767,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-version-for-the-authenticated-user parameters: + - *388 - *389 - - *390 - - *392 + - *391 responses: '204': description: Response @@ -123122,9 +125806,9 @@ paths: application/json: schema: type: array - items: *793 + items: *792 examples: - default: *805 + default: *804 headers: Link: *45 '304': *35 @@ -123237,7 +125921,7 @@ paths: type: array items: *78 examples: - default: &812 + default: &811 summary: Default response value: - id: 1296269 @@ -123555,9 +126239,9 @@ paths: description: Response content: application/json: - schema: *459 + schema: *458 examples: - default: *461 + default: *460 headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -123595,9 +126279,9 @@ paths: application/json: schema: type: array - items: *640 + items: *639 examples: - default: *806 + default: *805 headers: Link: *45 '304': *35 @@ -123620,7 +126304,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#accept-a-repository-invitation parameters: - - *368 + - *367 responses: '204': description: Response @@ -123643,7 +126327,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/collaborators/invitations#decline-a-repository-invitation parameters: - - *368 + - *367 responses: '204': description: Response @@ -123676,7 +126360,7 @@ paths: application/json: schema: type: array - items: &807 + items: &806 title: Social account description: Social media account type: object @@ -123693,7 +126377,7 @@ paths: - provider - url examples: - default: &808 + default: &807 value: - provider: twitter url: https://twitter.com/github @@ -123756,9 +126440,9 @@ paths: application/json: schema: type: array - items: *807 + items: *806 examples: - default: *808 + default: *807 '422': *15 '304': *35 '404': *6 @@ -123846,7 +126530,7 @@ paths: application/json: schema: type: array - items: &809 + items: &808 title: SSH Signing Key description: A public SSH key used to sign Git commits type: object @@ -123866,7 +126550,7 @@ paths: - title - created_at examples: - default: &836 + default: &835 value: - id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -123931,9 +126615,9 @@ paths: description: Response content: application/json: - schema: *809 + schema: *808 examples: - default: &810 + default: &809 value: id: 2 key: 2Sg8iYjAxxmI2LvUXpJjkYrMxURPc8r+dB7TJyvv1234 @@ -123963,7 +126647,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#get-an-ssh-signing-key-for-the-authenticated-user parameters: - - &811 + - &810 name: ssh_signing_key_id description: The unique identifier of the SSH signing key. in: path @@ -123975,9 +126659,9 @@ paths: description: Response content: application/json: - schema: *809 + schema: *808 examples: - default: *810 + default: *809 '404': *6 '304': *35 '403': *27 @@ -124000,7 +126684,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/ssh-signing-keys#delete-an-ssh-signing-key-for-the-authenticated-user parameters: - - *811 + - *810 responses: '204': description: Response @@ -124029,7 +126713,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-repositories-starred-by-the-authenticated-user parameters: - - &837 + - &836 name: sort description: The property to sort the results by. `created` means when the repository was starred. `updated` means when the repository was last pushed @@ -124054,11 +126738,11 @@ paths: type: array items: *78 examples: - default-response: *812 + default-response: *811 application/vnd.github.v3.star+json: schema: type: array - items: &838 + items: &837 title: Starred Repository description: Starred Repository type: object @@ -124214,8 +126898,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#check-if-a-repository-is-starred-by-the-authenticated-user parameters: + - *453 - *454 - - *455 responses: '204': description: Response if this repository is starred by you @@ -124243,8 +126927,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#star-a-repository-for-the-authenticated-user parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -124268,8 +126952,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#unstar-a-repository-for-the-authenticated-user parameters: + - *453 - *454 - - *455 responses: '204': description: Response @@ -124302,9 +126986,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 '304': *35 @@ -124341,7 +127025,7 @@ paths: application/json: schema: type: array - items: *446 + items: *445 examples: default: value: @@ -124427,10 +127111,10 @@ paths: application/json: schema: oneOf: - - *788 - *787 + - *786 examples: - default-response: &816 + default-response: &815 summary: Default response value: login: octocat @@ -124465,7 +127149,7 @@ paths: following: 0 created_at: '2008-01-14T04:33:35Z' updated_at: '2008-01-14T04:33:35Z' - response-with-git-hub-plan-information: &817 + response-with-git-hub-plan-information: &816 summary: Response with GitHub plan information value: login: octocat @@ -124522,14 +127206,14 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/drafts#create-draft-item-for-user-owned-project parameters: - - &814 + - &813 name: user_id description: The unique identifier of the user. in: path required: true schema: type: string - - *405 + - *404 requestBody: required: true description: Details of the draft item to create in the project. @@ -124563,9 +127247,9 @@ paths: description: Response content: application/json: - schema: *410 + schema: *409 examples: - draft_issue: *411 + draft_issue: *410 '304': *35 '403': *27 '401': *23 @@ -124588,7 +127272,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/users/users#list-users parameters: - - *813 + - *812 - *17 responses: '200': @@ -124623,8 +127307,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/views#create-a-view-for-a-user-owned-project parameters: - - *814 - - *405 + - *813 + - *404 requestBody: required: true content: @@ -124698,17 +127382,17 @@ paths: description: Response for creating a view in a user-owned project. content: application/json: - schema: *815 + schema: *814 examples: table_view: summary: Response for creating a table view - value: *415 + value: *414 board_view: summary: Response for creating a board view with filter - value: *415 + value: *414 roadmap_view: summary: Response for creating a roadmap view - value: *415 + value: *414 '304': *35 '403': *27 '401': *23 @@ -124750,11 +127434,11 @@ paths: application/json: schema: oneOf: - - *788 - *787 + - *786 examples: - default-response: *816 - response-with-git-hub-plan-information: *817 + default-response: *815 + response-with-git-hub-plan-information: *816 '404': *6 x-github: githubCloudOnly: false @@ -124804,8 +127488,8 @@ paths: required: - subject_digests examples: - default: *818 - withPredicateType: *819 + default: *817 + withPredicateType: *818 responses: '200': description: Response @@ -124859,7 +127543,7 @@ paths: description: The cursor to the previous page. description: Information about the current page. examples: - default: *820 + default: *819 x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -125064,12 +127748,12 @@ paths: initiator: type: string examples: - default: *501 + default: *500 '201': description: Response content: application/json: - schema: *290 + schema: *289 examples: default: value: @@ -125103,9 +127787,9 @@ paths: application/json: schema: type: array - items: *387 + items: *386 examples: - default: *803 + default: *802 '403': *27 '401': *23 x-github: @@ -125489,9 +128173,9 @@ paths: application/json: schema: type: array - items: *794 + items: *793 examples: - default: *821 + default: *820 headers: Link: *45 x-github: @@ -125595,7 +128279,7 @@ paths: application/json: schema: *20 examples: - default: *362 + default: *361 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -125720,7 +128404,7 @@ paths: - docker - nuget - container - - *802 + - *801 - *139 - *19 - *17 @@ -125731,12 +128415,12 @@ paths: application/json: schema: type: array - items: *387 + items: *386 examples: - default: *803 + default: *802 '403': *27 '401': *23 - '400': *804 + '400': *803 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -125756,17 +128440,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-for-a-user parameters: + - *388 - *389 - - *390 - *139 responses: '200': description: Response content: application/json: - schema: *387 + schema: *386 examples: - default: *822 + default: *821 x-github: githubCloudOnly: false enabledForGitHubApps: false @@ -125787,8 +128471,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-a-package-for-a-user parameters: + - *388 - *389 - - *390 - *139 responses: '204': @@ -125821,8 +128505,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-a-package-for-a-user parameters: + - *388 - *389 - - *390 - *139 - name: token description: package token @@ -125855,8 +128539,8 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#list-package-versions-for-a-package-owned-by-a-user parameters: + - *388 - *389 - - *390 - *139 responses: '200': @@ -125865,7 +128549,7 @@ paths: application/json: schema: type: array - items: *391 + items: *390 examples: default: value: @@ -125923,16 +128607,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#get-a-package-version-for-a-user parameters: + - *388 - *389 - - *390 - - *392 + - *391 - *139 responses: '200': description: Response content: application/json: - schema: *391 + schema: *390 examples: default: value: @@ -125967,10 +128651,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#delete-package-version-for-a-user parameters: + - *388 - *389 - - *390 - *139 - - *392 + - *391 responses: '204': description: Response @@ -126002,10 +128686,10 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/packages/packages#restore-package-version-for-a-user parameters: + - *388 - *389 - - *390 - *139 - - *392 + - *391 responses: '204': description: Response @@ -126046,9 +128730,9 @@ paths: application/json: schema: type: array - items: *403 + items: *402 examples: - default: *404 + default: *403 headers: Link: *45 '304': *35 @@ -126070,16 +128754,16 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/projects#get-project-for-user parameters: - - *405 + - *404 - *139 responses: '200': description: Response content: application/json: - schema: *403 + schema: *402 examples: - default: *404 + default: *403 headers: Link: *45 '304': *35 @@ -126101,7 +128785,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/fields#list-project-fields-for-user parameters: - - *405 + - *404 - *139 - *17 - *108 @@ -126113,9 +128797,9 @@ paths: application/json: schema: type: array - items: *408 + items: *407 examples: - default: *823 + default: *822 headers: Link: *45 '304': *35 @@ -126137,7 +128821,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/projects/fields#add-field-to-user-owned-project parameters: - *139 - - *405 + - *404 requestBody: required: true content: @@ -126175,7 +128859,7 @@ paths: description: The options available for single select fields. At least one option must be provided when creating a single select field. - items: *824 + items: *823 required: - name - data_type @@ -126191,7 +128875,7 @@ paths: description: The field's data type. enum: - iteration - iteration_configuration: *825 + iteration_configuration: *824 required: - name - data_type @@ -126213,20 +128897,20 @@ paths: value: name: Due date data_type: date - single_select_field: *826 - iteration_field: *827 + single_select_field: *825 + iteration_field: *826 responses: '201': description: Response content: application/json: - schema: *408 + schema: *407 examples: - text_field: *828 - number_field: *829 - date_field: *830 - single_select_field: *831 - iteration_field: *832 + text_field: *827 + number_field: *828 + date_field: *829 + single_select_field: *830 + iteration_field: *831 '304': *35 '403': *27 '401': *23 @@ -126247,17 +128931,17 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/fields#get-project-field-for-user parameters: - - *405 - - *833 + - *404 + - *832 - *139 responses: '200': description: Response content: application/json: - schema: *408 + schema: *407 examples: - default: *834 + default: *833 headers: Link: *45 '304': *35 @@ -126280,7 +128964,7 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#list-items-for-a-user-owned-project parameters: - - *405 + - *404 - *139 - *108 - *109 @@ -126313,9 +128997,9 @@ paths: application/json: schema: type: array - items: *412 + items: *411 examples: - default: *413 + default: *412 headers: Link: *45 '304': *35 @@ -126337,7 +129021,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#add-item-to-user-owned-project parameters: - *139 - - *405 + - *404 requestBody: required: true description: Details of the item to add to the project. You can specify either @@ -126407,22 +129091,22 @@ paths: description: Response content: application/json: - schema: *410 + schema: *409 examples: issue_with_id: summary: Response for adding an issue using its unique ID - value: *411 + value: *410 pull_request_with_id: summary: Response for adding a pull request using its unique ID - value: *411 + value: *410 issue_with_nwo: summary: Response for adding an issue using repository owner, name, and issue number - value: *411 + value: *410 pull_request_with_nwo: summary: Response for adding a pull request using repository owner, name, and PR number - value: *411 + value: *410 '304': *35 '403': *27 '401': *23 @@ -126442,9 +129126,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#get-an-item-for-a-user-owned-project parameters: - - *405 + - *404 - *139 - - *414 + - *413 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the title field will be returned. @@ -126464,9 +129148,9 @@ paths: description: Response content: application/json: - schema: *412 + schema: *411 examples: - default: *413 + default: *412 headers: Link: *45 '304': *35 @@ -126487,9 +129171,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#update-project-item-for-user parameters: - - *405 + - *404 - *139 - - *414 + - *413 requestBody: required: true description: Field updates to apply to the project item. Only text, number, @@ -126562,13 +129246,13 @@ paths: description: Response content: application/json: - schema: *412 + schema: *411 examples: - text_field: *413 - number_field: *413 - date_field: *413 - single_select_field: *413 - iteration_field: *413 + text_field: *412 + number_field: *412 + date_field: *412 + single_select_field: *412 + iteration_field: *412 '401': *23 '403': *27 '404': *6 @@ -126588,9 +129272,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#delete-project-item-for-user parameters: - - *405 + - *404 - *139 - - *414 + - *413 responses: '204': description: Response @@ -126612,9 +129296,9 @@ paths: description: API method documentation url: https://docs.github.com/enterprise-cloud@latest//rest/projects/items#list-items-for-a-user-project-view parameters: - - *405 + - *404 - *139 - - *835 + - *834 - name: fields description: |- Limit results to specific fields, by their IDs. If not specified, the @@ -126640,9 +129324,9 @@ paths: application/json: schema: type: array - items: *412 + items: *411 examples: - default: *413 + default: *412 headers: Link: *45 '304': *35 @@ -126861,9 +129545,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 x-github: @@ -126893,9 +129577,9 @@ paths: application/json: schema: type: array - items: *807 + items: *806 examples: - default: *808 + default: *807 headers: Link: *45 x-github: @@ -126925,9 +129609,9 @@ paths: application/json: schema: type: array - items: *809 + items: *808 examples: - default: *836 + default: *835 headers: Link: *45 x-github: @@ -126952,7 +129636,7 @@ paths: url: https://docs.github.com/enterprise-cloud@latest//rest/activity/starring#list-repositories-starred-by-a-user parameters: - *139 - - *837 + - *836 - *110 - *17 - *19 @@ -126964,11 +129648,11 @@ paths: schema: anyOf: - type: array - items: *838 + items: *837 - type: array items: *78 examples: - default-response: *812 + default-response: *811 headers: Link: *45 x-github: @@ -126997,9 +129681,9 @@ paths: application/json: schema: type: array - items: *279 + items: *278 examples: - default: *393 + default: *392 headers: Link: *45 x-github: @@ -127128,7 +129812,7 @@ webhooks: type: string enum: - disabled - enterprise: &839 + enterprise: &838 title: Enterprise description: |- An enterprise on GitHub. Webhook payloads contain the `enterprise` property when the webhook is configured @@ -127197,7 +129881,7 @@ webhooks: - created_at - updated_at - avatar_url - installation: &840 + installation: &839 title: Simple Installation description: |- The GitHub App installation. Webhook payloads contain the `installation` property when the event is configured @@ -127218,7 +129902,7 @@ webhooks: required: - id - node_id - organization: &841 + organization: &840 title: Organization Simple description: |- A GitHub organization. Webhook payloads contain the `organization` property when the webhook is configured for an @@ -127291,7 +129975,7 @@ webhooks: - public_members_url - avatar_url - description - repository: &842 + repository: &841 title: Repository description: |- The repository on GitHub where the event occurred. Webhook payloads contain the `repository` property @@ -128217,10 +130901,10 @@ webhooks: type: string enum: - enabled - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -128296,11 +130980,11 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - rule: &843 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + rule: &842 title: branch protection rule description: The branch protection rule. Includes a `name` and all the [branch protection settings](https://docs.github.com/enterprise-cloud@latest//github/administering-a-repository/defining-the-mergeability-of-pull-requests/about-protected-branches#about-branch-protection-settings) @@ -128523,11 +131207,11 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - rule: *843 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + rule: *842 sender: *4 required: - action @@ -128715,11 +131399,11 @@ webhooks: - everyone required: - from - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - rule: *843 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + rule: *842 sender: *4 required: - action @@ -128792,7 +131476,7 @@ webhooks: required: true content: application/json: - schema: &863 + schema: &862 title: Exemption request cancellation event type: object properties: @@ -128800,11 +131484,11 @@ webhooks: type: string enum: - cancelled - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - exemption_request: &844 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + exemption_request: &843 title: Exemption Request description: A request from a user to be exempted from a set of rules. @@ -128838,6 +131522,7 @@ webhooks: - secret_scanning_closure - code_scanning_alert_dismissal - dependabot_alert_dismissal + - license_compliance_alert_dismissal exemption_request_data: oneOf: - title: Push ruleset bypass exemption request data @@ -128977,6 +131662,25 @@ webhooks: alert_number: type: string description: The number of the alert to be dismissed + - title: License compliance alert closure request data + description: License compliance alerts that have closure requests. + type: object + properties: + type: + type: string + description: The type of request + enum: + - license_compliance_alert_dismissal + data: + type: array + description: The data related to the License compliance + alerts that have closure requests. + items: + type: object + properties: + alert_number: + type: string + description: The number of the alert to be closed resource_identifier: type: string description: The unique identifier for the request type of the @@ -129065,6 +131769,21 @@ webhooks: - no_bandwidth - not_used - tolerable_risk + - title: License compliance alert closure request metadata + description: Metadata for a License compliance alert closure + request. + type: object + properties: + alert_title: + type: string + description: The title of the License compliance alert + reason: + type: string + description: The reason for the closure request + enum: + - amendment + - private package + - inaccurate license expires_at: type: string format: date-time @@ -129078,7 +131797,7 @@ webhooks: - array - 'null' description: The responses to the exemption request. - items: &845 + items: &844 title: Exemption response description: A response to an exemption request by a delegated bypasser. @@ -129190,7 +131909,7 @@ webhooks: required: true content: application/json: - schema: &864 + schema: &863 title: Exemption request completed event type: object properties: @@ -129198,11 +131917,11 @@ webhooks: type: string enum: - completed - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - exemption_request: *844 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + exemption_request: *843 sender: *4 required: - action @@ -129274,7 +131993,7 @@ webhooks: required: true content: application/json: - schema: &861 + schema: &860 title: Exemption request created event type: object properties: @@ -129282,11 +132001,11 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - exemption_request: *844 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + exemption_request: *843 sender: *4 required: - action @@ -129358,7 +132077,7 @@ webhooks: required: true content: application/json: - schema: &865 + schema: &864 title: Exemption response dismissed event type: object properties: @@ -129366,12 +132085,12 @@ webhooks: type: string enum: - response_dismissed - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - exemption_request: *844 - exemption_response: *845 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + exemption_request: *843 + exemption_response: *844 sender: *4 required: - action @@ -129445,7 +132164,7 @@ webhooks: required: true content: application/json: - schema: &862 + schema: &861 title: Exemption response submitted event type: object properties: @@ -129453,12 +132172,12 @@ webhooks: type: string enum: - response_submitted - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - exemption_request: *844 - exemption_response: *845 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + exemption_request: *843 + exemption_response: *844 sender: *4 required: - action @@ -129542,7 +132261,7 @@ webhooks: type: string enum: - completed - check_run: &847 + check_run: &846 title: CheckRun description: A check performed on the code of a given code change type: object @@ -129608,7 +132327,7 @@ webhooks: pull_requests: type: array items: *222 - repository: *279 + repository: *278 status: type: string enum: @@ -129652,7 +132371,7 @@ webhooks: - examples: - neutral - deployment: *846 + deployment: *845 details_url: type: string examples: @@ -129750,10 +132469,10 @@ webhooks: - output - app - pull_requests - installation: *840 - enterprise: *839 - organization: *841 - repository: *842 + installation: *839 + enterprise: *838 + organization: *840 + repository: *841 sender: *4 required: - check_run @@ -130144,11 +132863,11 @@ webhooks: type: string enum: - created - check_run: *847 - installation: *840 - enterprise: *839 - organization: *841 - repository: *842 + check_run: *846 + installation: *839 + enterprise: *838 + organization: *840 + repository: *841 sender: *4 required: - check_run @@ -130542,11 +133261,11 @@ webhooks: type: string enum: - requested_action - check_run: *847 - installation: *840 - enterprise: *839 - organization: *841 - repository: *842 + check_run: *846 + installation: *839 + enterprise: *838 + organization: *840 + repository: *841 requested_action: description: The action requested by the user. type: object @@ -130949,11 +133668,11 @@ webhooks: type: string enum: - rerequested - check_run: *847 - installation: *840 - enterprise: *839 - organization: *841 - repository: *842 + check_run: *846 + installation: *839 + enterprise: *838 + organization: *840 + repository: *841 sender: *4 required: - check_run @@ -131938,10 +134657,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -132645,10 +135364,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -133346,10 +136065,10 @@ webhooks: - latest_check_runs_count - check_runs_url - head_commit - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -133518,7 +136237,7 @@ webhooks: required: - login - id - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -133670,20 +136389,20 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: &848 + commit_oid: &847 description: The commit SHA of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - enterprise: *839 - installation: *840 - organization: *841 - ref: &849 + enterprise: *838 + installation: *839 + organization: *840 + ref: &848 description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event was triggered by the `sender` and this value will be empty. type: string - repository: *842 + repository: *841 sender: *4 required: - action @@ -133850,7 +136569,7 @@ webhooks: required: - login - id - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -134091,12 +136810,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *848 - enterprise: *839 - installation: *840 - organization: *841 - ref: *849 - repository: *842 + commit_oid: *847 + enterprise: *838 + installation: *839 + organization: *840 + ref: *848 + repository: *841 sender: *4 required: - action @@ -134194,7 +136913,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -134379,12 +137098,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *848 - enterprise: *839 - installation: *840 - organization: *841 - ref: *849 - repository: *842 + commit_oid: *847 + enterprise: *838 + installation: *839 + organization: *840 + ref: *848 + repository: *841 sender: *4 required: - action @@ -134553,7 +137272,7 @@ webhooks: required: - login - id - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -134730,12 +137449,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *848 - enterprise: *839 - installation: *840 - organization: *841 - ref: *849 - repository: *842 + commit_oid: *847 + enterprise: *838 + installation: *839 + organization: *840 + ref: *848 + repository: *841 sender: *4 required: - action @@ -134836,7 +137555,7 @@ webhooks: type: - object - 'null' - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -135025,9 +137744,9 @@ webhooks: type: - string - 'null' - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 ref: description: The Git reference of the code scanning alert. When the action is `reopened_by_user` or `closed_by_user`, the event @@ -135035,7 +137754,7 @@ webhooks: type: - string - 'null' - repository: *842 + repository: *841 sender: *4 required: - action @@ -135134,7 +137853,7 @@ webhooks: dismissed_by: type: - 'null' - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: 'The reason for dismissing or closing the alert. Can be one of: `false positive`, `won''t fix`, and `used in @@ -135281,12 +138000,12 @@ webhooks: - dismissed_reason - rule - tool - commit_oid: *848 - enterprise: *839 - installation: *840 - organization: *841 - ref: *849 - repository: *842 + commit_oid: *847 + enterprise: *838 + installation: *839 + organization: *840 + ref: *848 + repository: *841 sender: *4 required: - action @@ -135455,7 +138174,7 @@ webhooks: required: - login - id - dismissed_comment: *529 + dismissed_comment: *528 dismissed_reason: description: The reason for dismissing or closing the alert. type: @@ -135607,10 +138326,10 @@ webhooks: - dismissed_reason - rule - tool - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -135870,10 +138589,10 @@ webhooks: - updated_at - author_association - body - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -135954,18 +138673,18 @@ webhooks: type: - string - 'null' - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 master_branch: description: The name of the repository's default branch (usually `main`). type: string - organization: *841 - pusher_type: &850 + organization: *840 + pusher_type: &849 description: The pusher type for the event. Can be either `user` or a deploy key. type: string - ref: &851 + ref: &850 description: The [`git ref`](https://docs.github.com/enterprise-cloud@latest//rest/git/refs#get-a-reference) resource. type: string @@ -135975,7 +138694,7 @@ webhooks: enum: - tag - branch - repository: *842 + repository: *841 sender: *4 required: - ref @@ -136058,9 +138777,9 @@ webhooks: enum: - created definition: *153 - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 sender: *4 required: - action @@ -136145,9 +138864,9 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 sender: *4 required: - action @@ -136225,9 +138944,9 @@ webhooks: enum: - promote_to_enterprise definition: *153 - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 sender: *4 required: - action @@ -136305,9 +139024,9 @@ webhooks: enum: - updated definition: *153 - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 sender: *4 required: - action @@ -136384,10 +139103,10 @@ webhooks: type: string enum: - updated - enterprise: *839 - installation: *840 - repository: *842 - organization: *841 + enterprise: *838 + installation: *839 + repository: *841 + organization: *840 sender: *4 new_property_values: type: array @@ -136472,18 +139191,18 @@ webhooks: title: delete event type: object properties: - enterprise: *839 - installation: *840 - organization: *841 - pusher_type: *850 - ref: *851 + enterprise: *838 + installation: *839 + organization: *840 + pusher_type: *849 + ref: *850 ref_type: description: The type of Git ref object deleted in the repository. type: string enum: - tag - branch - repository: *842 + repository: *841 sender: *4 required: - ref @@ -136563,11 +139282,11 @@ webhooks: type: string enum: - assignees_changed - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -136647,11 +139366,11 @@ webhooks: type: string enum: - auto_dismissed - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -136732,11 +139451,11 @@ webhooks: type: string enum: - auto_reopened - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -136817,11 +139536,11 @@ webhooks: type: string enum: - created - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -136900,11 +139619,11 @@ webhooks: type: string enum: - dismissed - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -136983,11 +139702,11 @@ webhooks: type: string enum: - fixed - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -137067,11 +139786,11 @@ webhooks: type: string enum: - reintroduced - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -137150,11 +139869,11 @@ webhooks: type: string enum: - reopened - alert: *587 - installation: *840 - organization: *841 - enterprise: *839 - repository: *842 + alert: *586 + installation: *839 + organization: *840 + enterprise: *838 + repository: *841 sender: *4 required: - action @@ -137231,9 +139950,9 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - key: &852 + enterprise: *838 + installation: *839 + key: &851 description: The [`deploy key`](https://docs.github.com/enterprise-cloud@latest//rest/deploy-keys/deploy-keys#get-a-deploy-key) resource. type: object @@ -137271,8 +139990,8 @@ webhooks: - verified - created_at - read_only - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -137349,11 +140068,11 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - key: *852 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + key: *851 + organization: *840 + repository: *841 sender: *4 required: - action @@ -137920,12 +140639,12 @@ webhooks: - updated_at - statuses_url - repository_url - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - workflow: &856 + workflow: &855 title: Workflow type: - object @@ -138676,13 +141395,13 @@ webhooks: deployment: anyOf: - type: 'null' - - *593 + - *592 pull_requests: type: array - items: *688 - repository: *842 - organization: *841 - installation: *840 + items: *687 + repository: *841 + organization: *840 + installation: *839 sender: *4 responses: '200': @@ -138753,7 +141472,7 @@ webhooks: type: string enum: - approved - approver: &853 + approver: &852 type: object properties: avatar_url: @@ -138796,11 +141515,11 @@ webhooks: type: string comment: type: string - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - reviewers: &854 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + reviewers: &853 type: array items: type: object @@ -138881,7 +141600,7 @@ webhooks: sender: *4 since: type: string - workflow_job_run: &855 + workflow_job_run: &854 type: object properties: conclusion: @@ -139627,18 +142346,18 @@ webhooks: type: string enum: - rejected - approver: *853 + approver: *852 comment: type: string - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - reviewers: *854 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + reviewers: *853 sender: *4 since: type: string - workflow_job_run: *855 + workflow_job_run: *854 workflow_job_runs: type: array items: @@ -140355,13 +143074,13 @@ webhooks: type: string enum: - requested - enterprise: *839 + enterprise: *838 environment: type: string - installation: *840 - organization: *841 - repository: *842 - requestor: &866 + installation: *839 + organization: *840 + repository: *841 + requestor: &865 title: User type: - object @@ -142294,12 +145013,12 @@ webhooks: - updated_at - deployment_url - repository_url - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - workflow: *856 + workflow: *855 workflow_run: title: Deployment Workflow Run type: @@ -142990,7 +145709,7 @@ webhooks: type: string enum: - answered - answer: &859 + answer: &858 type: object properties: author_association: @@ -143150,11 +145869,11 @@ webhooks: - created_at - updated_at - body - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143281,11 +146000,11 @@ webhooks: - from required: - category - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143368,11 +146087,11 @@ webhooks: type: string enum: - closed - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143454,7 +146173,7 @@ webhooks: type: string enum: - created - comment: &858 + comment: &857 type: object properties: author_association: @@ -143614,11 +146333,11 @@ webhooks: - updated_at - body - reactions - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143701,12 +146420,12 @@ webhooks: type: string enum: - deleted - comment: *858 - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + comment: *857 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143801,12 +146520,12 @@ webhooks: - from required: - body - comment: *858 - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + comment: *857 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143890,11 +146609,11 @@ webhooks: type: string enum: - created - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -143976,11 +146695,11 @@ webhooks: type: string enum: - deleted - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144080,11 +146799,11 @@ webhooks: type: string required: - from - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144166,10 +146885,10 @@ webhooks: type: string enum: - labeled - discussion: *857 - enterprise: *839 - installation: *840 - label: &860 + discussion: *856 + enterprise: *838 + installation: *839 + label: &859 title: Label type: object properties: @@ -144202,8 +146921,8 @@ webhooks: - color - default - description - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144286,11 +147005,11 @@ webhooks: type: string enum: - locked - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144372,11 +147091,11 @@ webhooks: type: string enum: - pinned - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144458,11 +147177,11 @@ webhooks: type: string enum: - reopened - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144547,16 +147266,16 @@ webhooks: changes: type: object properties: - new_discussion: *857 - new_repository: *842 + new_discussion: *856 + new_repository: *841 required: - new_discussion - new_repository - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144639,10 +147358,10 @@ webhooks: type: string enum: - unanswered - discussion: *857 - old_answer: *859 - organization: *841 - repository: *842 + discussion: *856 + old_answer: *858 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144724,12 +147443,12 @@ webhooks: type: string enum: - unlabeled - discussion: *857 - enterprise: *839 - installation: *840 - label: *860 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144812,11 +147531,11 @@ webhooks: type: string enum: - unlocked - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144898,11 +147617,11 @@ webhooks: type: string enum: - unpinned - discussion: *857 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + discussion: *856 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -144971,7 +147690,7 @@ webhooks: required: true content: application/json: - schema: *861 + schema: *860 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145034,7 +147753,7 @@ webhooks: required: true content: application/json: - schema: *862 + schema: *861 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145097,7 +147816,7 @@ webhooks: required: true content: application/json: - schema: *863 + schema: *862 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145160,7 +147879,7 @@ webhooks: required: true content: application/json: - schema: *861 + schema: *860 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145223,7 +147942,7 @@ webhooks: required: true content: application/json: - schema: *862 + schema: *861 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145289,7 +148008,7 @@ webhooks: required: true content: application/json: - schema: *863 + schema: *862 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145355,7 +148074,7 @@ webhooks: required: true content: application/json: - schema: *864 + schema: *863 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145421,7 +148140,7 @@ webhooks: required: true content: application/json: - schema: *861 + schema: *860 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145487,7 +148206,7 @@ webhooks: required: true content: application/json: - schema: *865 + schema: *864 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145553,7 +148272,7 @@ webhooks: required: true content: application/json: - schema: *862 + schema: *861 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145618,7 +148337,7 @@ webhooks: required: true content: application/json: - schema: *863 + schema: *862 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145683,7 +148402,7 @@ webhooks: required: true content: application/json: - schema: *864 + schema: *863 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145748,7 +148467,7 @@ webhooks: required: true content: application/json: - schema: *861 + schema: *860 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145813,7 +148532,7 @@ webhooks: required: true content: application/json: - schema: *865 + schema: *864 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145879,7 +148598,7 @@ webhooks: required: true content: application/json: - schema: *862 + schema: *861 responses: '200': description: Return a 200 status to indicate that the data was received @@ -145946,7 +148665,7 @@ webhooks: description: A user forks a repository. type: object properties: - enterprise: *839 + enterprise: *838 forkee: description: The created [`repository`](https://docs.github.com/enterprise-cloud@latest//rest/repos/repos#get-a-repository) resource. @@ -146624,9 +149343,9 @@ webhooks: type: integer watchers_count: type: integer - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - forkee @@ -146772,9 +149491,9 @@ webhooks: title: gollum event type: object properties: - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pages: description: The pages that were updated. type: array @@ -146812,7 +149531,7 @@ webhooks: - action - sha - html_url - repository: *842 + repository: *841 sender: *4 required: - pages @@ -146888,10 +149607,10 @@ webhooks: type: string enum: - created - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories: &867 + organization: *840 + repositories: &866 description: An array of repository objects that the installation can access. type: array @@ -146917,8 +149636,8 @@ webhooks: - name - full_name - private - repository: *842 - requester: *866 + repository: *841 + requester: *865 sender: *4 required: - action @@ -146993,11 +149712,11 @@ webhooks: type: string enum: - deleted - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories: *867 - repository: *842 + organization: *840 + repositories: *866 + repository: *841 requester: type: - 'null' @@ -147074,11 +149793,11 @@ webhooks: type: string enum: - new_permissions_accepted - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories: *867 - repository: *842 + organization: *840 + repositories: *866 + repository: *841 requester: type: - 'null' @@ -147155,10 +149874,10 @@ webhooks: type: string enum: - added - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories_added: &868 + organization: *840 + repositories_added: &867 description: An array of repository objects, which were added to the installation. type: array @@ -147204,15 +149923,15 @@ webhooks: private: description: Whether the repository is private or public. type: boolean - repository: *842 - repository_selection: &869 + repository: *841 + repository_selection: &868 description: Describe whether all repositories have been selected or there's a selection involved type: string enum: - all - selected - requester: *866 + requester: *865 sender: *4 required: - action @@ -147291,10 +150010,10 @@ webhooks: type: string enum: - removed - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories_added: *868 + organization: *840 + repositories_added: *867 repositories_removed: description: An array of repository objects, which were removed from the installation. @@ -147321,9 +150040,9 @@ webhooks: - name - full_name - private - repository: *842 - repository_selection: *869 - requester: *866 + repository: *841 + repository_selection: *868 + requester: *865 sender: *4 required: - action @@ -147402,11 +150121,11 @@ webhooks: type: string enum: - suspend - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories: *867 - repository: *842 + organization: *840 + repositories: *866 + repository: *841 requester: type: - 'null' @@ -147589,10 +150308,10 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 target_type: type: string @@ -147671,11 +150390,11 @@ webhooks: type: string enum: - unsuspend - enterprise: *839 + enterprise: *838 installation: *20 - organization: *841 - repositories: *867 - repository: *842 + organization: *840 + repositories: *866 + repository: *841 requester: type: - 'null' @@ -147841,7 +150560,7 @@ webhooks: pin: anyOf: - type: 'null' - - *665 + - *664 user: title: User type: @@ -147927,8 +150646,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -148740,8 +151459,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 state: description: State of the issue; either 'open' or 'closed' type: string @@ -148758,7 +151477,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -149102,8 +151821,8 @@ webhooks: - state - locked - assignee - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -149183,7 +151902,7 @@ webhooks: type: string enum: - deleted - comment: &870 + comment: &869 title: issue comment description: The [comment](https://docs.github.com/enterprise-cloud@latest//rest/issues/comments#get-an-issue-comment) itself. @@ -149340,7 +152059,7 @@ webhooks: pin: anyOf: - type: 'null' - - *665 + - *664 required: - url - html_url @@ -149354,8 +152073,8 @@ webhooks: - performed_via_github_app - body - reactions - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -150163,8 +152882,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 state: description: State of the issue; either 'open' or 'closed' type: string @@ -150181,7 +152900,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -150527,8 +153246,8 @@ webhooks: - state - locked - assignee - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -150608,7 +153327,7 @@ webhooks: type: string enum: - edited - changes: &894 + changes: &893 description: The changes to the comment. type: object properties: @@ -150620,9 +153339,9 @@ webhooks: type: string required: - from - comment: *870 - enterprise: *839 - installation: *840 + comment: *869 + enterprise: *838 + installation: *839 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -151433,8 +154152,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 state: description: State of the issue; either 'open' or 'closed' type: string @@ -151451,7 +154170,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -151795,8 +154514,8 @@ webhooks: - state - locked - assignee - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -151877,9 +154596,9 @@ webhooks: type: string enum: - pinned - comment: *870 - enterprise: *839 - installation: *840 + comment: *869 + enterprise: *838 + installation: *839 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -152692,8 +155411,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 state: description: State of the issue; either 'open' or 'closed' type: string @@ -152710,7 +155429,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -153056,8 +155775,8 @@ webhooks: - state - locked - assignee - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -153137,9 +155856,9 @@ webhooks: type: string enum: - unpinned - comment: *870 - enterprise: *839 - installation: *840 + comment: *869 + enterprise: *838 + installation: *839 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) the comment belongs to. @@ -153952,8 +156671,8 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 state: description: State of the issue; either 'open' or 'closed' type: string @@ -153970,7 +156689,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -154316,8 +157035,8 @@ webhooks: - state - locked - assignee - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -154406,9 +157125,9 @@ webhooks: type: number blocking_issue: *219 blocking_issue_repo: *78 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -154497,9 +157216,9 @@ webhooks: type: number blocking_issue: *219 blocking_issue_repo: *78 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -154587,9 +157306,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *219 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -154678,9 +157397,9 @@ webhooks: description: The ID of the blocking issue. type: number blocking_issue: *219 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -154760,10 +157479,10 @@ webhooks: type: string enum: - assigned - assignee: *866 - enterprise: *839 - installation: *840 - issue: &873 + assignee: *865 + enterprise: *838 + installation: *839 + issue: &872 title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -155574,11 +158293,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -155595,7 +158314,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -155698,8 +158417,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -155779,8 +158498,8 @@ webhooks: type: string enum: - closed - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -156596,11 +159315,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -156617,7 +159336,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -156863,8 +159582,8 @@ webhooks: required: - state - closed_at - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -156943,8 +159662,8 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -157751,11 +160470,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -157772,7 +160491,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -157874,8 +160593,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -157954,8 +160673,8 @@ webhooks: type: string enum: - demilestoned - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -158785,11 +161504,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -158806,7 +161525,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -158887,7 +161606,7 @@ webhooks: format: uri user_view_type: type: string - milestone: &871 + milestone: &870 title: Milestone description: A collection of related issues and pull requests. type: object @@ -159030,8 +161749,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -159130,8 +161849,8 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -159942,11 +162661,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -159960,7 +162679,7 @@ webhooks: timeline_url: type: string format: uri - type: *372 + type: *371 title: description: Title of the issue type: string @@ -160066,9 +162785,9 @@ webhooks: - active_lock_reason - body - reactions - label: *860 - organization: *841 - repository: *842 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -160148,8 +162867,8 @@ webhooks: type: string enum: - labeled - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -160959,11 +163678,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -160977,7 +163696,7 @@ webhooks: timeline_url: type: string format: uri - type: *372 + type: *371 title: description: Title of the issue type: string @@ -161083,9 +163802,9 @@ webhooks: - active_lock_reason - body - reactions - label: *860 - organization: *841 - repository: *842 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -161165,8 +163884,8 @@ webhooks: type: string enum: - locked - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -162001,11 +164720,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -162019,7 +164738,7 @@ webhooks: timeline_url: type: string format: uri - type: *372 + type: *371 title: description: Title of the issue type: string @@ -162102,8 +164821,8 @@ webhooks: format: uri user_view_type: type: string - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -162182,8 +164901,8 @@ webhooks: type: string enum: - milestoned - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -163012,11 +165731,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -163033,7 +165752,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -163113,9 +165832,9 @@ webhooks: format: uri user_view_type: type: string - milestone: *871 - organization: *841 - repository: *842 + milestone: *870 + organization: *840 + repository: *841 sender: *4 required: - action @@ -164002,11 +166721,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -164106,7 +166825,7 @@ webhooks: required: - login - id - type: *372 + type: *371 required: - id - number @@ -164598,8 +167317,8 @@ webhooks: required: - old_issue - old_repository - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -165406,11 +168125,11 @@ webhooks: repository_url: type: string format: uri - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -165427,7 +168146,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -165533,8 +168252,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -165614,9 +168333,9 @@ webhooks: type: string enum: - pinned - enterprise: *839 - installation: *840 - issue: &872 + enterprise: *838 + installation: *839 + issue: &871 title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) itself. @@ -166421,11 +169140,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -166442,7 +169161,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -166544,8 +169263,8 @@ webhooks: - active_lock_reason - body - reactions - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -166624,8 +169343,8 @@ webhooks: type: string enum: - reopened - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -167458,11 +170177,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -167559,9 +170278,9 @@ webhooks: format: uri user_view_type: type: string - type: *372 - organization: *841 - repository: *842 + type: *371 + organization: *840 + repository: *841 sender: *4 required: - action @@ -168449,11 +171168,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -168470,7 +171189,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -169063,11 +171782,11 @@ webhooks: required: - new_issue - new_repository - enterprise: *839 - installation: *840 - issue: *872 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + issue: *871 + organization: *840 + repository: *841 sender: *4 required: - action @@ -169147,12 +171866,12 @@ webhooks: type: string enum: - typed - enterprise: *839 - installation: *840 - issue: *873 - type: *372 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + issue: *872 + type: *371 + organization: *840 + repository: *841 sender: *4 required: - action @@ -169233,7 +171952,7 @@ webhooks: type: string enum: - unassigned - assignee: &897 + assignee: &896 title: User type: - object @@ -169305,11 +172024,11 @@ webhooks: required: - login - id - enterprise: *839 - installation: *840 - issue: *873 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + issue: *872 + organization: *840 + repository: *841 sender: *4 required: - action @@ -169388,12 +172107,12 @@ webhooks: type: string enum: - unlabeled - enterprise: *839 - installation: *840 - issue: *873 - label: *860 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + issue: *872 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -169473,8 +172192,8 @@ webhooks: type: string enum: - unlocked - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 issue: title: Issue description: The [issue](https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#get-an-issue) @@ -170307,11 +173026,11 @@ webhooks: anyOf: - type: 'null' - *220 - sub_issues_summary: *780 - issue_dependencies_summary: *781 + sub_issues_summary: *779 + issue_dependencies_summary: *780 issue_field_values: type: array - items: *650 + items: *649 state: description: State of the issue; either 'open' or 'closed' type: string @@ -170328,7 +173047,7 @@ webhooks: title: description: Title of the issue type: string - type: *372 + type: *371 updated_at: type: string format: date-time @@ -170408,8 +173127,8 @@ webhooks: format: uri user_view_type: type: string - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -170489,11 +173208,11 @@ webhooks: type: string enum: - unpinned - enterprise: *839 - installation: *840 - issue: *872 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + issue: *871 + organization: *840 + repository: *841 sender: *4 required: - action @@ -170572,12 +173291,12 @@ webhooks: type: string enum: - untyped - enterprise: *839 - installation: *840 - issue: *873 - type: *372 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + issue: *872 + type: *371 + organization: *840 + repository: *841 sender: *4 required: - action @@ -170657,11 +173376,11 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - label: *860 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -170739,11 +173458,11 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - label: *860 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -170853,11 +173572,11 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - label: *860 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + label: *859 + organization: *840 + repository: *841 sender: *4 required: - action @@ -170939,9 +173658,9 @@ webhooks: - cancelled effective_date: type: string - enterprise: *839 - installation: *840 - marketplace_purchase: &874 + enterprise: *838 + installation: *839 + marketplace_purchase: &873 title: Marketplace Purchase type: object required: @@ -171029,8 +173748,8 @@ webhooks: type: integer unit_count: type: integer - organization: *841 - previous_marketplace_purchase: &875 + organization: *840 + previous_marketplace_purchase: &874 title: Marketplace Purchase type: object properties: @@ -171114,7 +173833,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *842 + repository: *841 sender: *4 required: - action @@ -171194,10 +173913,10 @@ webhooks: - changed effective_date: type: string - enterprise: *839 - installation: *840 - marketplace_purchase: *874 - organization: *841 + enterprise: *838 + installation: *839 + marketplace_purchase: *873 + organization: *840 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -171285,7 +174004,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *842 + repository: *841 sender: *4 required: - action @@ -171367,10 +174086,10 @@ webhooks: - pending_change effective_date: type: string - enterprise: *839 - installation: *840 - marketplace_purchase: *874 - organization: *841 + enterprise: *838 + installation: *839 + marketplace_purchase: *873 + organization: *840 previous_marketplace_purchase: title: Marketplace Purchase type: object @@ -171456,7 +174175,7 @@ webhooks: - on_free_trial - free_trial_ends_on - plan - repository: *842 + repository: *841 sender: *4 required: - action @@ -171537,8 +174256,8 @@ webhooks: - pending_change_cancelled effective_date: type: string - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 marketplace_purchase: title: Marketplace Purchase type: object @@ -171624,9 +174343,9 @@ webhooks: type: integer unit_count: type: integer - organization: *841 - previous_marketplace_purchase: *875 - repository: *842 + organization: *840 + previous_marketplace_purchase: *874 + repository: *841 sender: *4 required: - action @@ -171706,12 +174425,12 @@ webhooks: - purchased effective_date: type: string - enterprise: *839 - installation: *840 - marketplace_purchase: *874 - organization: *841 - previous_marketplace_purchase: *875 - repository: *842 + enterprise: *838 + installation: *839 + marketplace_purchase: *873 + organization: *840 + previous_marketplace_purchase: *874 + repository: *841 sender: *4 required: - action @@ -171813,11 +174532,11 @@ webhooks: type: string required: - to - enterprise: *839 - installation: *840 - member: *866 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + member: *865 + organization: *840 + repository: *841 sender: *4 required: - action @@ -171919,11 +174638,11 @@ webhooks: type: - string - 'null' - enterprise: *839 - installation: *840 - member: *866 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + member: *865 + organization: *840 + repository: *841 sender: *4 required: - action @@ -172002,11 +174721,11 @@ webhooks: type: string enum: - removed - enterprise: *839 - installation: *840 - member: *866 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + member: *865 + organization: *840 + repository: *841 sender: *4 required: - action @@ -172084,11 +174803,11 @@ webhooks: type: string enum: - added - enterprise: *839 - installation: *840 - member: *866 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + member: *865 + organization: *840 + repository: *841 scope: description: The scope of the membership. Currently, can only be `team`. @@ -172166,7 +174885,7 @@ webhooks: required: - login - id - team: &876 + team: &875 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -172396,11 +175115,11 @@ webhooks: type: string enum: - removed - enterprise: *839 - installation: *840 - member: *866 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + member: *865 + organization: *840 + repository: *841 scope: description: The scope of the membership. Currently, can only be `team`. @@ -172479,7 +175198,7 @@ webhooks: required: - login - id - team: *876 + team: *875 required: - action - scope @@ -172561,8 +175280,8 @@ webhooks: type: string enum: - checks_requested - installation: *840 - merge_group: &877 + installation: *839 + merge_group: &876 type: object title: Merge Group description: A group of pull requests that the merge queue has grouped @@ -172581,15 +175300,15 @@ webhooks: description: The full ref of the branch the merge group will be merged into. type: string - head_commit: *521 + head_commit: *520 required: - head_sha - head_ref - base_sha - base_ref - head_commit - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -172675,10 +175394,10 @@ webhooks: - merged - invalidated - dequeued - installation: *840 - merge_group: *877 - organization: *841 - repository: *842 + installation: *839 + merge_group: *876 + organization: *840 + repository: *841 sender: *4 required: - action @@ -172751,7 +175470,7 @@ webhooks: type: string enum: - deleted - enterprise: *839 + enterprise: *838 hook: description: 'The deleted webhook. This will contain different keys based on the type of webhook it is: repository, organization, @@ -172860,12 +175579,12 @@ webhooks: hook_id: description: The id of the modified webhook. type: integer - installation: *840 - organization: *841 + installation: *839 + organization: *840 repository: anyOf: - type: 'null' - - *842 + - *841 sender: *4 required: - action @@ -172945,11 +175664,11 @@ webhooks: type: string enum: - closed - enterprise: *839 - installation: *840 - milestone: *871 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + milestone: *870 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173028,9 +175747,9 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - milestone: &878 + enterprise: *838 + installation: *839 + milestone: &877 title: Milestone description: A collection of related issues and pull requests. type: object @@ -173172,8 +175891,8 @@ webhooks: - updated_at - due_on - closed_at - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173252,11 +175971,11 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - milestone: *871 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + milestone: *870 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173366,11 +176085,11 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - milestone: *871 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + milestone: *870 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173450,11 +176169,11 @@ webhooks: type: string enum: - opened - enterprise: *839 - installation: *840 - milestone: *878 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + milestone: *877 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173533,11 +176252,11 @@ webhooks: type: string enum: - blocked - blocked_user: *866 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + blocked_user: *865 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173616,11 +176335,11 @@ webhooks: type: string enum: - unblocked - blocked_user: *866 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + blocked_user: *865 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -173696,7 +176415,7 @@ webhooks: enum: - created definition: *147 - enterprise: *839 + enterprise: *838 sender: *4 required: - action @@ -173776,8 +176495,8 @@ webhooks: description: The name of the property that was deleted. required: - property_name - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 sender: *4 required: - action @@ -173850,8 +176569,8 @@ webhooks: enum: - updated definition: *147 - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 sender: *4 required: - action @@ -173923,9 +176642,9 @@ webhooks: type: string enum: - updated - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 sender: *4 new_property_values: type: array @@ -174013,9 +176732,9 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - membership: &879 + enterprise: *838 + installation: *839 + membership: &878 title: Membership description: The membership between the user and the organization. Not present when the action is `member_invited`. @@ -174125,8 +176844,8 @@ webhooks: - role - organization_url - user - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 required: - action @@ -174204,11 +176923,11 @@ webhooks: type: string enum: - member_added - enterprise: *839 - installation: *840 - membership: *879 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + membership: *878 + organization: *840 + repository: *841 sender: *4 required: - action @@ -174287,8 +177006,8 @@ webhooks: type: string enum: - member_invited - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 invitation: description: The invitation for the user or email if the action is `member_invited`. @@ -174410,10 +177129,10 @@ webhooks: - inviter - team_count - invitation_teams_url - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 - user: *866 + user: *865 required: - action - invitation @@ -174491,11 +177210,11 @@ webhooks: type: string enum: - member_removed - enterprise: *839 - installation: *840 - membership: *879 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + membership: *878 + organization: *840 + repository: *841 sender: *4 required: - action @@ -174582,11 +177301,11 @@ webhooks: properties: from: type: string - enterprise: *839 - installation: *840 - membership: *879 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + membership: *878 + organization: *840 + repository: *841 sender: *4 required: - action @@ -174664,9 +177383,9 @@ webhooks: type: string enum: - published - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 package: description: Information about the package. type: object @@ -175189,7 +177908,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: &880 + items: &879 title: Ruby Gems metadata type: object properties: @@ -175286,7 +178005,7 @@ webhooks: - owner - package_version - registry - repository: *842 + repository: *841 sender: *4 required: - action @@ -175363,9 +178082,9 @@ webhooks: type: string enum: - updated - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 package: description: Information about the package. type: object @@ -175727,7 +178446,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *880 + items: *879 source_url: type: string format: uri @@ -175798,7 +178517,7 @@ webhooks: - owner - package_version - registry - repository: *842 + repository: *841 sender: *4 required: - action @@ -175978,12 +178697,12 @@ webhooks: - duration - created_at - updated_at - enterprise: *839 + enterprise: *838 id: type: integer - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - id @@ -176060,7 +178779,7 @@ webhooks: type: string enum: - approved - personal_access_token_request: &881 + personal_access_token_request: &880 title: Personal Access Token Request description: Details of a Personal Access Token Request. type: object @@ -176210,10 +178929,10 @@ webhooks: - token_expired - token_expires_at - token_last_used_at - enterprise: *839 - organization: *841 + enterprise: *838 + organization: *840 sender: *4 - installation: *840 + installation: *839 required: - action - personal_access_token_request @@ -176290,11 +179009,11 @@ webhooks: type: string enum: - cancelled - personal_access_token_request: *881 - enterprise: *839 - organization: *841 + personal_access_token_request: *880 + enterprise: *838 + organization: *840 sender: *4 - installation: *840 + installation: *839 required: - action - personal_access_token_request @@ -176370,11 +179089,11 @@ webhooks: type: string enum: - created - personal_access_token_request: *881 - enterprise: *839 - organization: *841 + personal_access_token_request: *880 + enterprise: *838 + organization: *840 sender: *4 - installation: *840 + installation: *839 required: - action - personal_access_token_request @@ -176449,11 +179168,11 @@ webhooks: type: string enum: - denied - personal_access_token_request: *881 - organization: *841 - enterprise: *839 + personal_access_token_request: *880 + organization: *840 + enterprise: *838 sender: *4 - installation: *840 + installation: *839 required: - action - personal_access_token_request @@ -176558,7 +179277,7 @@ webhooks: id: description: Unique identifier of the webhook. type: integer - last_response: *882 + last_response: *881 name: description: The type of webhook. The only valid value is 'web'. type: string @@ -176590,8 +179309,8 @@ webhooks: hook_id: description: The ID of the webhook that triggered the ping. type: integer - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 zen: description: Random string of GitHub zen. @@ -176836,10 +179555,10 @@ webhooks: - from required: - note - enterprise: *839 - installation: *840 - organization: *841 - project_card: &883 + enterprise: *838 + installation: *839 + organization: *840 + project_card: &882 title: Project Card type: object properties: @@ -176962,7 +179681,7 @@ webhooks: - creator - created_at - updated_at - repository: *842 + repository: *841 sender: *4 required: - action @@ -177043,11 +179762,11 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - project_card: *883 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project_card: *882 + repository: *841 sender: *4 required: - action @@ -177127,9 +179846,9 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 project_card: title: Project Card type: object @@ -177259,7 +179978,7 @@ webhooks: repository: anyOf: - type: 'null' - - *842 + - *841 sender: *4 required: - action @@ -177353,11 +180072,11 @@ webhooks: - from required: - note - enterprise: *839 - installation: *840 - organization: *841 - project_card: *883 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project_card: *882 + repository: *841 sender: *4 required: - action @@ -177451,9 +180170,9 @@ webhooks: - from required: - column_id - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 project_card: allOf: - title: Project Card @@ -177650,7 +180369,7 @@ webhooks: type: string required: - after_id - repository: *842 + repository: *841 sender: *4 required: - action @@ -177730,10 +180449,10 @@ webhooks: type: string enum: - closed - enterprise: *839 - installation: *840 - organization: *841 - project: &885 + enterprise: *838 + installation: *839 + organization: *840 + project: &884 title: Project type: object properties: @@ -177860,7 +180579,7 @@ webhooks: - creator - created_at - updated_at - repository: *842 + repository: *841 sender: *4 required: - action @@ -177940,10 +180659,10 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - project_column: &884 + enterprise: *838 + installation: *839 + organization: *840 + project_column: &883 title: Project Column type: object properties: @@ -177983,7 +180702,7 @@ webhooks: - name - created_at - updated_at - repository: *842 + repository: *841 sender: *4 required: - action @@ -178062,14 +180781,14 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - project_column: *884 + enterprise: *838 + installation: *839 + organization: *840 + project_column: *883 repository: anyOf: - type: 'null' - - *842 + - *841 sender: *4 required: - action @@ -178158,11 +180877,11 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - organization: *841 - project_column: *884 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project_column: *883 + repository: *841 sender: *4 required: - action @@ -178242,11 +180961,11 @@ webhooks: type: string enum: - moved - enterprise: *839 - installation: *840 - organization: *841 - project_column: *884 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project_column: *883 + repository: *841 sender: *4 required: - action @@ -178326,11 +181045,11 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - project: *885 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project: *884 + repository: *841 sender: *4 required: - action @@ -178410,14 +181129,14 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - project: *885 + enterprise: *838 + installation: *839 + organization: *840 + project: *884 repository: anyOf: - type: 'null' - - *842 + - *841 sender: *4 required: - action @@ -178518,11 +181237,11 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - organization: *841 - project: *885 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project: *884 + repository: *841 sender: *4 required: - action @@ -178601,11 +181320,11 @@ webhooks: type: string enum: - reopened - enterprise: *839 - installation: *840 - organization: *841 - project: *885 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + project: *884 + repository: *841 sender: *4 required: - action @@ -178686,9 +181405,9 @@ webhooks: type: string enum: - closed - installation: *840 - organization: *841 - projects_v2: *403 + installation: *839 + organization: *840 + projects_v2: *402 sender: *4 required: - action @@ -178769,9 +181488,9 @@ webhooks: type: string enum: - created - installation: *840 - organization: *841 - projects_v2: *403 + installation: *839 + organization: *840 + projects_v2: *402 sender: *4 required: - action @@ -178852,9 +181571,9 @@ webhooks: type: string enum: - deleted - installation: *840 - organization: *841 - projects_v2: *403 + installation: *839 + organization: *840 + projects_v2: *402 sender: *4 required: - action @@ -178975,9 +181694,9 @@ webhooks: type: string to: type: string - installation: *840 - organization: *841 - projects_v2: *403 + installation: *839 + organization: *840 + projects_v2: *402 sender: *4 required: - action @@ -179060,7 +181779,7 @@ webhooks: type: string enum: - archived - changes: &889 + changes: &888 type: object properties: archived_at: @@ -179076,9 +181795,9 @@ webhooks: - string - 'null' format: date-time - installation: *840 - organization: *841 - projects_v2_item: &886 + installation: *839 + organization: *840 + projects_v2_item: &885 title: Projects v2 Item description: An item belonging to a project type: object @@ -179096,7 +181815,7 @@ webhooks: type: string description: The node ID of the content represented by this item. - content_type: *409 + content_type: *408 creator: *4 created_at: type: string @@ -179218,9 +181937,9 @@ webhooks: - 'null' to: type: string - installation: *840 - organization: *841 - projects_v2_item: *886 + installation: *839 + organization: *840 + projects_v2_item: *885 sender: *4 required: - action @@ -179302,9 +182021,9 @@ webhooks: type: string enum: - created - installation: *840 - organization: *841 - projects_v2_item: *886 + installation: *839 + organization: *840 + projects_v2_item: *885 sender: *4 required: - action @@ -179385,9 +182104,9 @@ webhooks: type: string enum: - deleted - installation: *840 - organization: *841 - projects_v2_item: *886 + installation: *839 + organization: *840 + projects_v2_item: *885 sender: *4 required: - action @@ -179492,7 +182211,7 @@ webhooks: oneOf: - type: string - type: integer - - &887 + - &886 title: Projects v2 Single Select Option description: An option for a single select field type: object @@ -179516,7 +182235,7 @@ webhooks: required: - id - name - - &888 + - &887 title: Projects v2 Iteration Setting description: An iteration setting for an iteration field type: object @@ -179556,8 +182275,8 @@ webhooks: oneOf: - type: string - type: integer + - *886 - *887 - - *888 type: - 'null' - string @@ -179580,9 +182299,9 @@ webhooks: - 'null' required: - body - installation: *840 - organization: *841 - projects_v2_item: *886 + installation: *839 + organization: *840 + projects_v2_item: *885 sender: *4 required: - action @@ -179679,9 +182398,9 @@ webhooks: type: - string - 'null' - installation: *840 - organization: *841 - projects_v2_item: *886 + installation: *839 + organization: *840 + projects_v2_item: *885 sender: *4 required: - action @@ -179764,10 +182483,10 @@ webhooks: type: string enum: - restored - changes: *889 - installation: *840 - organization: *841 - projects_v2_item: *886 + changes: *888 + installation: *839 + organization: *840 + projects_v2_item: *885 sender: *4 required: - action @@ -179849,9 +182568,9 @@ webhooks: type: string enum: - reopened - installation: *840 - organization: *841 - projects_v2: *403 + installation: *839 + organization: *840 + projects_v2: *402 sender: *4 required: - action @@ -179932,9 +182651,9 @@ webhooks: type: string enum: - created - installation: *840 - organization: *841 - projects_v2_status_update: *890 + installation: *839 + organization: *840 + projects_v2_status_update: *889 sender: *4 required: - action @@ -180015,9 +182734,9 @@ webhooks: type: string enum: - deleted - installation: *840 - organization: *841 - projects_v2_status_update: *890 + installation: *839 + organization: *840 + projects_v2_status_update: *889 sender: *4 required: - action @@ -180163,9 +182882,9 @@ webhooks: - string - 'null' format: date - installation: *840 - organization: *841 - projects_v2_status_update: *890 + installation: *839 + organization: *840 + projects_v2_status_update: *889 sender: *4 required: - action @@ -180236,10 +182955,10 @@ webhooks: title: public event type: object properties: - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - repository @@ -180316,13 +183035,13 @@ webhooks: type: string enum: - assigned - assignee: *866 - enterprise: *839 - installation: *840 - number: &891 + assignee: *865 + enterprise: *838 + installation: *839 + number: &890 description: The pull request number. type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -182693,7 +185412,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -182775,11 +185494,11 @@ webhooks: type: string enum: - auto_merge_disabled - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -185143,7 +187862,7 @@ webhooks: - draft reason: type: string - repository: *842 + repository: *841 sender: *4 required: - action @@ -185225,11 +187944,11 @@ webhooks: type: string enum: - auto_merge_enabled - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -187593,7 +190312,7 @@ webhooks: - draft reason: type: string - repository: *842 + repository: *841 sender: *4 required: - action @@ -187675,13 +190394,13 @@ webhooks: type: string enum: - closed - enterprise: *839 - installation: *840 - number: *891 - organization: *841 - pull_request: &892 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 + pull_request: &891 allOf: - - *688 + - *687 - type: object properties: allow_auto_merge: @@ -187743,7 +190462,7 @@ webhooks: Please use `squash_merge_commit_title` instead.** type: boolean default: false - repository: *842 + repository: *841 sender: *4 required: - action @@ -187824,12 +190543,12 @@ webhooks: type: string enum: - converted_to_draft - enterprise: *839 - installation: *840 - number: *891 - organization: *841 - pull_request: *892 - repository: *842 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 + pull_request: *891 + repository: *841 sender: *4 required: - action @@ -187909,11 +190628,11 @@ webhooks: type: string enum: - demilestoned - enterprise: *839 - milestone: *406 - number: *891 - organization: *841 - pull_request: &893 + enterprise: *838 + milestone: *405 + number: *890 + organization: *840 + pull_request: &892 title: Pull Request type: object properties: @@ -190262,7 +192981,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -190341,11 +193060,11 @@ webhooks: type: string enum: - dequeued - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -192713,7 +195432,7 @@ webhooks: - BRANCH_PROTECTIONS - GIT_TREE_INVALID - INVALID_MERGE_COMMIT - repository: *842 + repository: *841 sender: *4 required: - action @@ -192837,12 +195556,12 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - number: *891 - organization: *841 - pull_request: *892 - repository: *842 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 + pull_request: *891 + repository: *841 sender: *4 required: - action @@ -192922,11 +195641,11 @@ webhooks: type: string enum: - enqueued - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -195279,7 +197998,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -195359,11 +198078,11 @@ webhooks: type: string enum: - labeled - enterprise: *839 - installation: *840 - label: *860 - number: *891 - organization: *841 + enterprise: *838 + installation: *839 + label: *859 + number: *890 + organization: *840 pull_request: title: Pull Request type: object @@ -197733,7 +200452,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -197814,10 +200533,10 @@ webhooks: type: string enum: - locked - enterprise: *839 - installation: *840 - number: *891 - organization: *841 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 pull_request: title: Pull Request type: object @@ -200185,7 +202904,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -200265,12 +202984,12 @@ webhooks: type: string enum: - milestoned - enterprise: *839 - milestone: *406 - number: *891 - organization: *841 - pull_request: *893 - repository: *842 + enterprise: *838 + milestone: *405 + number: *890 + organization: *840 + pull_request: *892 + repository: *841 sender: *4 required: - action @@ -200349,12 +203068,12 @@ webhooks: type: string enum: - opened - enterprise: *839 - installation: *840 - number: *891 - organization: *841 - pull_request: *892 - repository: *842 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 + pull_request: *891 + repository: *841 sender: *4 required: - action @@ -200435,12 +203154,12 @@ webhooks: type: string enum: - ready_for_review - enterprise: *839 - installation: *840 - number: *891 - organization: *841 - pull_request: *892 - repository: *842 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 + pull_request: *891 + repository: *841 sender: *4 required: - action @@ -200520,12 +203239,12 @@ webhooks: type: string enum: - reopened - enterprise: *839 - installation: *840 - number: *891 - organization: *841 - pull_request: *892 - repository: *842 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 + pull_request: *891 + repository: *841 sender: *4 required: - action @@ -200900,9 +203619,9 @@ webhooks: - start_side - side - reactions - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: type: object properties: @@ -203154,7 +205873,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *842 + repository: *841 sender: *4 required: - action @@ -203234,7 +205953,7 @@ webhooks: type: string enum: - deleted - comment: &895 + comment: &894 title: Pull Request Review Comment description: The [comment](https://docs.github.com/enterprise-cloud@latest//rest/pulls/comments#get-a-review-comment-for-a-pull-request) itself. @@ -203527,9 +206246,9 @@ webhooks: - start_side - side - reactions - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: type: object properties: @@ -205769,7 +208488,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *842 + repository: *841 sender: *4 required: - action @@ -205849,11 +208568,11 @@ webhooks: type: string enum: - edited - changes: *894 - comment: *895 - enterprise: *839 - installation: *840 - organization: *841 + changes: *893 + comment: *894 + enterprise: *838 + installation: *839 + organization: *840 pull_request: type: object properties: @@ -208096,7 +210815,7 @@ webhooks: - _links - author_association - active_lock_reason - repository: *842 + repository: *841 sender: *4 required: - action @@ -208177,9 +210896,9 @@ webhooks: type: string enum: - dismissed - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: title: Simple Pull Request type: object @@ -210434,7 +213153,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *842 + repository: *841 review: description: The review that was affected. type: object @@ -210685,9 +213404,9 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: title: Simple Pull Request type: object @@ -212801,8 +215520,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *842 - review: &896 + repository: *841 + review: &895 description: The review that was affected. type: object properties: @@ -213040,12 +215759,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: description: The pull request number. type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -215414,7 +218133,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 requested_reviewer: title: User type: @@ -215500,12 +218219,12 @@ webhooks: type: string enum: - review_request_removed - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: description: The pull request number. type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -217881,7 +220600,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 requested_team: title: Team description: Groups of organization members that gives permissions @@ -218076,12 +220795,12 @@ webhooks: type: string enum: - review_requested - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: description: The pull request number. type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -220452,7 +223171,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 requested_reviewer: title: User type: @@ -220539,12 +223258,12 @@ webhooks: type: string enum: - review_requested - enterprise: *839 - installation: *840 + enterprise: *838 + installation: *839 number: description: The pull request number. type: integer - organization: *841 + organization: *840 pull_request: title: Pull Request type: object @@ -222906,7 +225625,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 requested_team: title: Team description: Groups of organization members that gives permissions @@ -223090,9 +225809,9 @@ webhooks: type: string enum: - submitted - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: title: Simple Pull Request type: object @@ -225350,8 +228069,8 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *842 - review: *896 + repository: *841 + review: *895 sender: *4 required: - action @@ -225431,9 +228150,9 @@ webhooks: type: string enum: - resolved - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: title: Simple Pull Request type: object @@ -227586,7 +230305,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *842 + repository: *841 sender: *4 thread: type: object @@ -227983,9 +230702,9 @@ webhooks: type: string enum: - unresolved - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 pull_request: title: Simple Pull Request type: object @@ -230121,7 +232840,7 @@ webhooks: - author_association - auto_merge - active_lock_reason - repository: *842 + repository: *841 sender: *4 thread: type: object @@ -230520,10 +233239,10 @@ webhooks: type: string before: type: string - enterprise: *839 - installation: *840 - number: *891 - organization: *841 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 pull_request: title: Pull Request type: object @@ -232880,7 +235599,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -232962,11 +235681,11 @@ webhooks: type: string enum: - unassigned - assignee: *897 - enterprise: *839 - installation: *840 - number: *891 - organization: *841 + assignee: *896 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 pull_request: title: Pull Request type: object @@ -235338,7 +238057,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -235417,11 +238136,11 @@ webhooks: type: string enum: - unlabeled - enterprise: *839 - installation: *840 - label: *860 - number: *891 - organization: *841 + enterprise: *838 + installation: *839 + label: *859 + number: *890 + organization: *840 pull_request: title: Pull Request type: object @@ -237782,7 +240501,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -237863,10 +240582,10 @@ webhooks: type: string enum: - unlocked - enterprise: *839 - installation: *840 - number: *891 - organization: *841 + enterprise: *838 + installation: *839 + number: *890 + organization: *840 pull_request: title: Pull Request type: object @@ -240217,7 +242936,7 @@ webhooks: - auto_merge - active_lock_reason - draft - repository: *842 + repository: *841 sender: *4 required: - action @@ -240420,7 +243139,7 @@ webhooks: deleted: description: Whether this push deleted the `ref`. type: boolean - enterprise: *839 + enterprise: *838 forced: description: Whether this push was a force push of the `ref`. type: boolean @@ -240515,8 +243234,8 @@ webhooks: - url - author - committer - installation: *840 - organization: *841 + installation: *839 + organization: *840 pusher: title: Committer description: Metaproperties for Git author/committer information. @@ -241115,9 +243834,9 @@ webhooks: type: string enum: - published - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 registry_package: type: object properties: @@ -241594,7 +244313,7 @@ webhooks: type: string rubygems_metadata: type: array - items: *880 + items: *879 summary: type: string tag_name: @@ -241650,7 +244369,7 @@ webhooks: - owner - package_version - registry - repository: *842 + repository: *841 sender: *4 required: - action @@ -241728,9 +244447,9 @@ webhooks: type: string enum: - updated - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 registry_package: type: object properties: @@ -242042,7 +244761,7 @@ webhooks: - published_at rubygems_metadata: type: array - items: *880 + items: *879 summary: type: string tag_name: @@ -242092,7 +244811,7 @@ webhooks: - owner - package_version - registry - repository: *842 + repository: *841 sender: *4 required: - action @@ -242169,10 +244888,10 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - release: &898 + enterprise: *838 + installation: *839 + organization: *840 + release: &897 title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) object. @@ -242503,7 +245222,7 @@ webhooks: - updated_at - zipball_url - body - repository: *842 + repository: *841 sender: *4 required: - action @@ -242580,11 +245299,11 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - release: *898 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + release: *897 + repository: *841 sender: *4 required: - action @@ -242701,11 +245420,11 @@ webhooks: type: boolean required: - to - enterprise: *839 - installation: *840 - organization: *841 - release: *898 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + release: *897 + repository: *841 sender: *4 required: - action @@ -242783,9 +245502,9 @@ webhooks: type: string enum: - prereleased - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 release: title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) @@ -243121,7 +245840,7 @@ webhooks: - string - 'null' format: uri - repository: *842 + repository: *841 sender: *4 required: - action @@ -243197,10 +245916,10 @@ webhooks: type: string enum: - published - enterprise: *839 - installation: *840 - organization: *841 - release: &899 + enterprise: *838 + installation: *839 + organization: *840 + release: &898 title: Release description: The [release](https://docs.github.com/enterprise-cloud@latest//rest/releases/releases/#get-a-release) object. @@ -243533,7 +246252,7 @@ webhooks: - string - 'null' format: uri - repository: *842 + repository: *841 sender: *4 required: - action @@ -243609,11 +246328,11 @@ webhooks: type: string enum: - released - enterprise: *839 - installation: *840 - organization: *841 - release: *898 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + release: *897 + repository: *841 sender: *4 required: - action @@ -243689,11 +246408,11 @@ webhooks: type: string enum: - unpublished - enterprise: *839 - installation: *840 - organization: *841 - release: *899 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + release: *898 + repository: *841 sender: *4 required: - action @@ -243769,11 +246488,11 @@ webhooks: type: string enum: - published - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - repository_advisory: *740 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + repository_advisory: *739 sender: *4 required: - action @@ -243849,11 +246568,11 @@ webhooks: type: string enum: - reported - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - repository_advisory: *740 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + repository_advisory: *739 sender: *4 required: - action @@ -243929,10 +246648,10 @@ webhooks: type: string enum: - archived - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244009,10 +246728,10 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244090,10 +246809,10 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244178,10 +246897,10 @@ webhooks: additionalProperties: true description: The `client_payload` that was specified in the `POST /repos/{owner}/{repo}/dispatches` request body. - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244296,10 +247015,10 @@ webhooks: - 'null' items: type: string - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244371,10 +247090,10 @@ webhooks: title: repository_import event type: object properties: - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 status: type: string @@ -244455,10 +247174,10 @@ webhooks: type: string enum: - privatized - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244535,10 +247254,10 @@ webhooks: type: string enum: - publicized - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244632,10 +247351,10 @@ webhooks: - name required: - repository - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -244715,10 +247434,10 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 repository_ruleset: *187 sender: *4 required: @@ -244797,10 +247516,10 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 repository_ruleset: *187 sender: *4 required: @@ -244879,10 +247598,10 @@ webhooks: type: string enum: - edited - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 repository_ruleset: *187 changes: type: object @@ -244944,16 +247663,16 @@ webhooks: properties: added: type: array - items: *708 + items: *707 deleted: type: array - items: *708 + items: *707 updated: type: array items: type: object properties: - rule: *708 + rule: *707 changes: type: object properties: @@ -245190,10 +247909,10 @@ webhooks: - from required: - owner - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -245271,10 +247990,10 @@ webhooks: type: string enum: - unarchived - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -245352,7 +248071,7 @@ webhooks: type: string enum: - create - alert: &900 + alert: &899 title: Repository Vulnerability Alert Alert description: The security alert of the vulnerable dependency. type: object @@ -245477,10 +248196,10 @@ webhooks: enum: - auto_dismissed - open - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -245690,10 +248409,10 @@ webhooks: type: string enum: - dismissed - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -245771,11 +248490,11 @@ webhooks: type: string enum: - reopen - alert: *900 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + alert: *899 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -245977,10 +248696,10 @@ webhooks: enum: - fixed - open - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246058,7 +248777,7 @@ webhooks: type: string enum: - assigned - alert: &901 + alert: &900 type: object properties: number: *126 @@ -246173,10 +248892,10 @@ webhooks: - type: 'null' - *4 assignee: *4 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246254,11 +248973,11 @@ webhooks: type: string enum: - created - alert: *901 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + alert: *900 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246339,11 +249058,11 @@ webhooks: type: string enum: - created - alert: *901 - installation: *840 - location: *902 - organization: *841 - repository: *842 + alert: *900 + installation: *839 + location: *901 + organization: *840 + repository: *841 sender: *4 required: - location @@ -246581,11 +249300,11 @@ webhooks: type: string enum: - publicly_leaked - alert: *901 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + alert: *900 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246663,11 +249382,11 @@ webhooks: type: string enum: - reopened - alert: *901 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + alert: *900 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246745,11 +249464,11 @@ webhooks: type: string enum: - resolved - alert: *901 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + alert: *900 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246827,12 +249546,12 @@ webhooks: type: string enum: - unassigned - alert: *901 + alert: *900 assignee: *4 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -246910,11 +249629,11 @@ webhooks: type: string enum: - validated - alert: *901 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + alert: *900 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -247044,10 +249763,10 @@ webhooks: - organization - enterprise - - repository: *842 - enterprise: *839 - installation: *840 - organization: *841 + repository: *841 + enterprise: *838 + installation: *839 + organization: *840 sender: *4 required: - action @@ -247125,11 +249844,11 @@ webhooks: type: string enum: - published - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - security_advisory: &903 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + security_advisory: &902 description: The details of the security advisory, including summary, description, and severity. type: object @@ -247315,11 +250034,11 @@ webhooks: type: string enum: - updated - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 - security_advisory: *903 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 + security_advisory: *902 sender: *4 required: - action @@ -247392,10 +250111,10 @@ webhooks: type: string enum: - withdrawn - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 security_advisory: description: The details of the security advisory, including summary, description, and severity. @@ -247581,11 +250300,11 @@ webhooks: from: type: object properties: - security_and_analysis: *417 - enterprise: *839 - installation: *840 - organization: *841 - repository: *459 + security_and_analysis: *416 + enterprise: *838 + installation: *839 + organization: *840 + repository: *458 sender: *4 required: - changes @@ -247663,12 +250382,12 @@ webhooks: type: string enum: - cancelled - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - sponsorship: &904 + sponsorship: &903 type: object properties: created_at: @@ -247973,12 +250692,12 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - sponsorship: *904 + sponsorship: *903 required: - action - sponsorship @@ -248066,12 +250785,12 @@ webhooks: type: string required: - from - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - sponsorship: *904 + sponsorship: *903 required: - action - changes @@ -248148,17 +250867,17 @@ webhooks: type: string enum: - pending_cancellation - effective_date: &905 + effective_date: &904 description: The `pending_cancellation` and `pending_tier_change` event types will include the date the cancellation or tier change will take effect. type: string - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - sponsorship: *904 + sponsorship: *903 required: - action - sponsorship @@ -248232,7 +250951,7 @@ webhooks: type: string enum: - pending_tier_change - changes: &906 + changes: &905 type: object properties: tier: @@ -248276,13 +250995,13 @@ webhooks: - from required: - tier - effective_date: *905 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + effective_date: *904 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - sponsorship: *904 + sponsorship: *903 required: - action - changes @@ -248359,13 +251078,13 @@ webhooks: type: string enum: - tier_changed - changes: *906 - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + changes: *905 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - sponsorship: *904 + sponsorship: *903 required: - action - changes @@ -248439,10 +251158,10 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -248526,10 +251245,10 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 starred_at: description: 'The time the star was created. This is a timestamp @@ -248963,15 +251682,15 @@ webhooks: type: - string - 'null' - enterprise: *839 + enterprise: *838 id: description: The unique identifier of the status. type: integer - installation: *840 + installation: *839 name: type: string - organization: *841 - repository: *842 + organization: *840 + repository: *841 sender: *4 sha: description: The Commit SHA. @@ -249087,9 +251806,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *219 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -249179,9 +251898,9 @@ webhooks: description: The ID of the sub-issue. type: number sub_issue: *219 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -249271,9 +251990,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *219 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -249363,9 +252082,9 @@ webhooks: description: The ID of the parent issue. type: number parent_issue: *219 - installation: *840 - organization: *841 - repository: *842 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -249442,12 +252161,12 @@ webhooks: title: team_add event type: object properties: - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - team: &907 + team: &906 title: Team description: Groups of organization members that gives permissions on specified repositories. @@ -249677,9 +252396,9 @@ webhooks: type: string enum: - added_to_repository - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 repository: title: Repository description: A git repository @@ -250149,7 +252868,7 @@ webhooks: - topics - visibility sender: *4 - team: *907 + team: *906 required: - action - team @@ -250225,9 +252944,9 @@ webhooks: type: string enum: - created - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 repository: title: Repository description: A git repository @@ -250697,7 +253416,7 @@ webhooks: - topics - visibility sender: *4 - team: *907 + team: *906 required: - action - team @@ -250774,9 +253493,9 @@ webhooks: type: string enum: - deleted - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 repository: title: Repository description: A git repository @@ -251246,7 +253965,7 @@ webhooks: - topics - visibility sender: *4 - team: *907 + team: *906 required: - action - team @@ -251390,9 +254109,9 @@ webhooks: - from required: - permissions - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 repository: title: Repository description: A git repository @@ -251862,7 +254581,7 @@ webhooks: - topics - visibility sender: *4 - team: *907 + team: *906 required: - action - changes @@ -251940,9 +254659,9 @@ webhooks: type: string enum: - removed_from_repository - enterprise: *839 - installation: *840 - organization: *841 + enterprise: *838 + installation: *839 + organization: *840 repository: title: Repository description: A git repository @@ -252412,7 +255131,7 @@ webhooks: - topics - visibility sender: *4 - team: *907 + team: *906 required: - action - team @@ -252488,10 +255207,10 @@ webhooks: type: string enum: - started - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 required: - action @@ -252564,17 +255283,17 @@ webhooks: title: workflow_dispatch event type: object properties: - enterprise: *839 + enterprise: *838 inputs: type: - object - 'null' additionalProperties: true - installation: *840 - organization: *841 + installation: *839 + organization: *840 ref: type: string - repository: *842 + repository: *841 sender: *4 workflow: type: string @@ -252656,10 +255375,10 @@ webhooks: type: string enum: - completed - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 workflow_job: allOf: @@ -252915,7 +255634,7 @@ webhooks: type: string required: - conclusion - deployment: *593 + deployment: *592 required: - action - repository @@ -252994,10 +255713,10 @@ webhooks: type: string enum: - in_progress - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 workflow_job: allOf: @@ -253279,7 +255998,7 @@ webhooks: required: - status - steps - deployment: *593 + deployment: *592 required: - action - repository @@ -253358,10 +256077,10 @@ webhooks: type: string enum: - queued - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 workflow_job: type: object @@ -253507,7 +256226,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *593 + deployment: *592 required: - action - repository @@ -253586,10 +256305,10 @@ webhooks: type: string enum: - waiting - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 workflow_job: type: object @@ -253736,7 +256455,7 @@ webhooks: - workflow_name - head_branch - created_at - deployment: *593 + deployment: *592 required: - action - repository @@ -253816,12 +256535,12 @@ webhooks: type: string enum: - completed - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - workflow: *856 + workflow: *855 workflow_run: title: Workflow Run type: object @@ -254840,12 +257559,12 @@ webhooks: type: string enum: - in_progress - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - workflow: *856 + workflow: *855 workflow_run: title: Workflow Run type: object @@ -255849,12 +258568,12 @@ webhooks: type: string enum: - requested - enterprise: *839 - installation: *840 - organization: *841 - repository: *842 + enterprise: *838 + installation: *839 + organization: *840 + repository: *841 sender: *4 - workflow: *856 + {"code":"deadline_exceeded","msg":"operation timed out"}