diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.json b/descriptions/api.github.com/api.github.com.2022-11-28.json index 5883af1ae..12a3ed65a 100644 --- a/descriptions/api.github.com/api.github.com.2022-11-28.json +++ b/descriptions/api.github.com/api.github.com.2022-11-28.json @@ -522,3163 +522,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -17744,7 +14587,27 @@ } }, "404": { - "$ref": "#/components/responses/not_found" + "description": "Resource not found", + "content": { + "application/json": { + "schema": { + "$ref": "#/components/schemas/basic-error" + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } + } + } + } } }, "x-github": { diff --git a/descriptions/api.github.com/api.github.com.2022-11-28.yaml b/descriptions/api.github.com/api.github.com.2022-11-28.yaml index 7ccde271a..6e56c1c7b 100644 --- a/descriptions/api.github.com/api.github.com.2022-11-28.yaml +++ b/descriptions/api.github.com/api.github.com.2022-11-28.yaml @@ -338,2456 +338,6 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 @@ -13012,7 +10562,19 @@ paths: - 123 - 345 '404': - "$ref": "#/components/responses/not_found" + description: Resource not found + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true diff --git a/descriptions/api.github.com/api.github.com.2026-03-10.json b/descriptions/api.github.com/api.github.com.2026-03-10.json index d155a3fd2..be8caa2cb 100644 --- a/descriptions/api.github.com/api.github.com.2026-03-10.json +++ b/descriptions/api.github.com/api.github.com.2026-03-10.json @@ -522,3163 +522,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -17514,226 +14357,249 @@ } }, "403": { - "$ref": "#/components/responses/forbidden" - }, - "404": { - "$ref": "#/components/responses/not_found" - } - }, - "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": [ - { - "$ref": "#/components/parameters/org" - }, - { - "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, - "example": "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.\\-_]+$", - "example": "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", + "$ref": "#/components/responses/forbidden" + }, + "404": { + "$ref": "#/components/responses/not_found" + } + }, + "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": [ + { + "$ref": "#/components/parameters/org" + }, + { + "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, + "example": "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.\\-_]+$", + "example": "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": { + "$ref": "#/components/schemas/artifact-deployment-record" + } + } + }, + "required": [ + "total_count" + ] + }, + "examples": { + "default": { + "$ref": "#/components/examples/artifact-deployment-record-list" + } + } + } + } + }, + "403": { + "description": "Forbidden", "content": { "application/json": { "schema": { - "type": "object", - "properties": { - "total_count": { - "description": "The number of deployment records created", - "type": "integer" - }, - "deployment_records": { - "type": "array", - "items": { - "$ref": "#/components/schemas/artifact-deployment-record" - } - } - }, - "required": [ - "total_count" - ] + "$ref": "#/components/schemas/basic-error" }, "examples": { - "default": { - "$ref": "#/components/examples/artifact-deployment-record-list" + "insufficient_repo_permissions": { + "value": { + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } + } } } } } }, - "403": { - "description": "Forbidden", + "404": { + "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/basic-error" }, "examples": { - "insufficient_repo_permissions": { + "not_found": { "value": { "message": { - "cause": "artifact metadata write permission required on one or more repositories", + "cause": "One or more repositories do not exist", "repositories": [ - 123, - 345 + "repoA", + "repoB" ] } } @@ -17741,9 +14607,6 @@ } } } - }, - "404": { - "$ref": "#/components/responses/not_found" } }, "x-github": { @@ -287228,10 +284091,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H", - "score": 7.6 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H", @@ -291343,7 +288202,6 @@ "updated_at": "2011-06-20T11:34:15Z", "description": "Hello World Examples", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/", "owner": { "login": "octocat", @@ -298504,7 +295362,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -300059,7 +296916,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -300196,12 +297052,6 @@ "remaining": 10, "reset": 1691591091 } - }, - "rate": { - "limit": 5000, - "used": 1, - "remaining": 4999, - "reset": 1372700873 } } }, @@ -300299,7 +297149,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "has_discussions": false, "archived": false, "disabled": false, @@ -309188,26 +306037,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -309908,26 +306737,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -310770,27 +307579,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -312169,27 +308957,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -313786,10 +310553,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -314011,7 +310774,6 @@ ] } ], - "cvss": null, "cvss_severities": { "cvss_v3": null, "cvss_v4": null @@ -314767,7 +311529,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -315239,7 +312000,6 @@ } ], "state": "open", - "assignee": null, "milestone": { "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1", "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0", @@ -315657,7 +312417,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", diff --git a/descriptions/api.github.com/api.github.com.2026-03-10.yaml b/descriptions/api.github.com/api.github.com.2026-03-10.yaml index 1fbccbb1f..a47421e3b 100644 --- a/descriptions/api.github.com/api.github.com.2026-03-10.yaml +++ b/descriptions/api.github.com/api.github.com.2026-03-10.yaml @@ -338,2456 +338,6 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 @@ -13010,7 +10560,19 @@ paths: - 123 - 345 '404': - "$ref": "#/components/responses/not_found" + description: Resource not found + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -214196,9 +211758,6 @@ components: vulnerable_version_range: "<=1.0.2" vulnerable_functions: - a_function - cvss: - vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H - score: 7.6 cvss_severities: cvss_v3: vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H @@ -218034,7 +215593,6 @@ components: updated_at: '2011-06-20T11:34:15Z' description: Hello World Examples comments: 0 - user: comments_url: https://api.github.com/gists/aa5a315d61ae9438b18d/comments/ owner: login: octocat @@ -224105,7 +221663,6 @@ components: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -225434,7 +222991,6 @@ components: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -225551,11 +223107,6 @@ components: used: 0 remaining: 10 reset: 1691591091 - rate: - limit: 5000 - used: 1 - remaining: 4999 - reset: 1372700873 full-repository-default-response: summary: Default response value: @@ -225648,7 +223199,6 @@ components: has_projects: true has_wiki: true has_pages: false - has_downloads: true has_discussions: false archived: false disabled: false @@ -233190,25 +230740,6 @@ components: description: Something isn't working color: f29513 default: true - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -233843,25 +231374,6 @@ components: description: Something isn't working color: f29513 default: true - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -234600,26 +232112,6 @@ components: updated_at: '2011-01-26T19:01:12Z' closed_at: '2011-01-26T19:01:12Z' merged_at: '2011-01-26T19:01:12Z' - merge_commit_sha: e5bd3914e2e596debea16f433f57875b5b90bcd6 - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -235408,520 +232900,500 @@ components: type: User site_admin: true requested_reviewers: - - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - - login: hubot - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/hubot_happy.gif - gravatar_id: '' - url: https://api.github.com/users/hubot - html_url: https://github.com/hubot - followers_url: https://api.github.com/users/hubot/followers - following_url: https://api.github.com/users/hubot/following{/other_user} - gists_url: https://api.github.com/users/hubot/gists{/gist_id} - starred_url: https://api.github.com/users/hubot/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/hubot/subscriptions - organizations_url: https://api.github.com/users/hubot/orgs - repos_url: https://api.github.com/users/hubot/repos - events_url: https://api.github.com/users/hubot/events{/privacy} - received_events_url: https://api.github.com/users/hubot/received_events - type: User - site_admin: true - - login: other_user - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/other_user_happy.gif - gravatar_id: '' - url: https://api.github.com/users/other_user - html_url: https://github.com/other_user - followers_url: https://api.github.com/users/other_user/followers - following_url: https://api.github.com/users/other_user/following{/other_user} - gists_url: https://api.github.com/users/other_user/gists{/gist_id} - starred_url: https://api.github.com/users/other_user/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/other_user/subscriptions - organizations_url: https://api.github.com/users/other_user/orgs - repos_url: https://api.github.com/users/other_user/repos - events_url: https://api.github.com/users/other_user/events{/privacy} - received_events_url: https://api.github.com/users/other_user/received_events - type: User - site_admin: false - requested_teams: - - id: 1 - node_id: MDQ6VGVhbTE= - url: https://api.github.com/teams/1 - html_url: https://github.com/orgs/github/teams/justice-league - name: Justice League - slug: justice-league - description: A great team. - privacy: closed - notification_setting: notifications_enabled - permission: admin - members_url: https://api.github.com/teams/1/members{/member} - repositories_url: https://api.github.com/teams/1/repos - parent: - head: - label: octocat:new-topic - ref: new-topic - sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - repo: - id: 1296269 - node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 - name: Hello-World - full_name: octocat/Hello-World - owner: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - private: false - html_url: https://github.com/octocat/Hello-World - description: This your first repo! - fork: false - url: https://api.github.com/repos/octocat/Hello-World - archive_url: https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref} - assignees_url: https://api.github.com/repos/octocat/Hello-World/assignees{/user} - blobs_url: https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha} - branches_url: https://api.github.com/repos/octocat/Hello-World/branches{/branch} - collaborators_url: https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator} - comments_url: https://api.github.com/repos/octocat/Hello-World/comments{/number} - commits_url: https://api.github.com/repos/octocat/Hello-World/commits{/sha} - compare_url: https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head} - contents_url: https://api.github.com/repos/octocat/Hello-World/contents/{+path} - contributors_url: https://api.github.com/repos/octocat/Hello-World/contributors - deployments_url: https://api.github.com/repos/octocat/Hello-World/deployments - downloads_url: https://api.github.com/repos/octocat/Hello-World/downloads - events_url: https://api.github.com/repos/octocat/Hello-World/events - forks_url: https://api.github.com/repos/octocat/Hello-World/forks - git_commits_url: https://api.github.com/repos/octocat/Hello-World/git/commits{/sha} - git_refs_url: https://api.github.com/repos/octocat/Hello-World/git/refs{/sha} - git_tags_url: https://api.github.com/repos/octocat/Hello-World/git/tags{/sha} - git_url: git:github.com/octocat/Hello-World.git - issue_comment_url: https://api.github.com/repos/octocat/Hello-World/issues/comments{/number} - issue_events_url: https://api.github.com/repos/octocat/Hello-World/issues/events{/number} - issues_url: https://api.github.com/repos/octocat/Hello-World/issues{/number} - keys_url: https://api.github.com/repos/octocat/Hello-World/keys{/key_id} - labels_url: https://api.github.com/repos/octocat/Hello-World/labels{/name} - languages_url: https://api.github.com/repos/octocat/Hello-World/languages - merges_url: https://api.github.com/repos/octocat/Hello-World/merges - milestones_url: https://api.github.com/repos/octocat/Hello-World/milestones{/number} - notifications_url: https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating} - pulls_url: https://api.github.com/repos/octocat/Hello-World/pulls{/number} - releases_url: https://api.github.com/repos/octocat/Hello-World/releases{/id} - ssh_url: git@github.com:octocat/Hello-World.git - stargazers_url: https://api.github.com/repos/octocat/Hello-World/stargazers - statuses_url: https://api.github.com/repos/octocat/Hello-World/statuses/{sha} - subscribers_url: https://api.github.com/repos/octocat/Hello-World/subscribers - subscription_url: https://api.github.com/repos/octocat/Hello-World/subscription - tags_url: https://api.github.com/repos/octocat/Hello-World/tags - teams_url: https://api.github.com/repos/octocat/Hello-World/teams - trees_url: https://api.github.com/repos/octocat/Hello-World/git/trees{/sha} - clone_url: https://github.com/octocat/Hello-World.git - mirror_url: git:git.example.com/octocat/Hello-World - hooks_url: https://api.github.com/repos/octocat/Hello-World/hooks - svn_url: https://svn.github.com/octocat/Hello-World - homepage: https://github.com - language: - forks_count: 9 - stargazers_count: 80 - watchers_count: 80 - size: 108 - default_branch: master - open_issues_count: 0 - is_template: true - topics: - - octocat - - atom - - electron - - api - has_issues: true - has_projects: true - has_wiki: true - has_pages: false - has_downloads: true - archived: false - disabled: false - visibility: public - pushed_at: '2011-01-26T19:06:43Z' - created_at: '2011-01-26T19:01:12Z' - updated_at: '2011-01-26T19:14:43Z' - permissions: - admin: false - push: false - pull: true - allow_rebase_merge: true - template_repository: - temp_clone_token: ABTLWHOULUVAXGTRYU7OC2876QJ2O - allow_squash_merge: true - allow_auto_merge: false - delete_branch_on_merge: true - allow_merge_commit: true - subscribers_count: 42 - network_count: 0 - license: - key: mit - name: MIT License - url: https://api.github.com/licenses/mit - spdx_id: MIT - node_id: MDc6TGljZW5zZW1pdA== - html_url: https://github.com/licenses/mit - forks: 1 - open_issues: 1 - watchers: 1 - base: - label: octocat:master - ref: master - sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - repo: - id: 1296269 - node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 - name: Hello-World - full_name: octocat/Hello-World - owner: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - private: false - html_url: https://github.com/octocat/Hello-World - description: This your first repo! - fork: false - url: https://api.github.com/repos/octocat/Hello-World - archive_url: https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref} - assignees_url: https://api.github.com/repos/octocat/Hello-World/assignees{/user} - blobs_url: https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha} - branches_url: https://api.github.com/repos/octocat/Hello-World/branches{/branch} - collaborators_url: https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator} - comments_url: https://api.github.com/repos/octocat/Hello-World/comments{/number} - commits_url: https://api.github.com/repos/octocat/Hello-World/commits{/sha} - compare_url: https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head} - contents_url: https://api.github.com/repos/octocat/Hello-World/contents/{+path} - contributors_url: https://api.github.com/repos/octocat/Hello-World/contributors - deployments_url: https://api.github.com/repos/octocat/Hello-World/deployments - downloads_url: https://api.github.com/repos/octocat/Hello-World/downloads - events_url: https://api.github.com/repos/octocat/Hello-World/events - forks_url: https://api.github.com/repos/octocat/Hello-World/forks - git_commits_url: https://api.github.com/repos/octocat/Hello-World/git/commits{/sha} - git_refs_url: https://api.github.com/repos/octocat/Hello-World/git/refs{/sha} - git_tags_url: https://api.github.com/repos/octocat/Hello-World/git/tags{/sha} - git_url: git:github.com/octocat/Hello-World.git - issue_comment_url: https://api.github.com/repos/octocat/Hello-World/issues/comments{/number} - issue_events_url: https://api.github.com/repos/octocat/Hello-World/issues/events{/number} - issues_url: https://api.github.com/repos/octocat/Hello-World/issues{/number} - keys_url: https://api.github.com/repos/octocat/Hello-World/keys{/key_id} - labels_url: https://api.github.com/repos/octocat/Hello-World/labels{/name} - languages_url: https://api.github.com/repos/octocat/Hello-World/languages - merges_url: https://api.github.com/repos/octocat/Hello-World/merges - milestones_url: https://api.github.com/repos/octocat/Hello-World/milestones{/number} - notifications_url: https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating} - pulls_url: https://api.github.com/repos/octocat/Hello-World/pulls{/number} - releases_url: https://api.github.com/repos/octocat/Hello-World/releases{/id} - ssh_url: git@github.com:octocat/Hello-World.git - stargazers_url: https://api.github.com/repos/octocat/Hello-World/stargazers - statuses_url: https://api.github.com/repos/octocat/Hello-World/statuses/{sha} - subscribers_url: https://api.github.com/repos/octocat/Hello-World/subscribers - subscription_url: https://api.github.com/repos/octocat/Hello-World/subscription - tags_url: https://api.github.com/repos/octocat/Hello-World/tags - teams_url: https://api.github.com/repos/octocat/Hello-World/teams - trees_url: https://api.github.com/repos/octocat/Hello-World/git/trees{/sha} - clone_url: https://github.com/octocat/Hello-World.git - mirror_url: git:git.example.com/octocat/Hello-World - hooks_url: https://api.github.com/repos/octocat/Hello-World/hooks - svn_url: https://svn.github.com/octocat/Hello-World - homepage: https://github.com - language: - forks_count: 9 - stargazers_count: 80 - watchers_count: 80 - size: 108 - default_branch: master - open_issues_count: 0 - is_template: true - topics: - - octocat - - atom - - electron - - api - has_issues: true - has_projects: true - has_wiki: true - has_pages: false - has_downloads: true - archived: false - disabled: false - visibility: public - pushed_at: '2011-01-26T19:06:43Z' - created_at: '2011-01-26T19:01:12Z' - updated_at: '2011-01-26T19:14:43Z' - permissions: - admin: false - push: false - pull: true - allow_rebase_merge: true - template_repository: - temp_clone_token: ABTLWHOULUVAXGTRYU7OC2876QJ2O - allow_squash_merge: true - allow_auto_merge: false - delete_branch_on_merge: true - allow_merge_commit: true - subscribers_count: 42 - network_count: 0 - license: - key: mit - name: MIT License - url: https://api.github.com/licenses/mit - spdx_id: MIT - node_id: MDc6TGljZW5zZW1pdA== - html_url: https://api.github.com/licenses/mit - forks: 1 - open_issues: 1 - watchers: 1 - _links: - self: - href: https://api.github.com/repos/octocat/Hello-World/pulls/1347 - html: - href: https://github.com/octocat/Hello-World/pull/1347 - issue: - href: https://api.github.com/repos/octocat/Hello-World/issues/1347 - comments: - href: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments - review_comments: - href: https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments - review_comment: - href: https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number} - commits: - href: https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits - statuses: - href: https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e - author_association: OWNER - auto_merge: - draft: false - pull-request-simple: - value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 - id: 1 - node_id: MDExOlB1bGxSZXF1ZXN0MQ== - html_url: https://github.com/octocat/Hello-World/pull/1347 - diff_url: https://github.com/octocat/Hello-World/pull/1347.diff - patch_url: https://github.com/octocat/Hello-World/pull/1347.patch - issue_url: https://api.github.com/repos/octocat/Hello-World/issues/1347 - commits_url: https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits - review_comments_url: https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments - review_comment_url: https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number} - comments_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments - statuses_url: https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e - number: 1347 - state: open - locked: true - title: Amazing new feature - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - body: Please pull these awesome changes in! - labels: - - id: 208045946 - node_id: MDU6TGFiZWwyMDgwNDU5NDY= - url: https://api.github.com/repos/octocat/Hello-World/labels/bug - name: bug - description: Something isn't working - color: f29513 - default: true - milestone: - url: https://api.github.com/repos/octocat/Hello-World/milestones/1 - html_url: https://github.com/octocat/Hello-World/milestones/v1.0 - labels_url: https://api.github.com/repos/octocat/Hello-World/milestones/1/labels - id: 1002604 - node_id: MDk6TWlsZXN0b25lMTAwMjYwNA== - number: 1 - state: open - title: v1.0 - description: Tracking milestone for version 1.0 - creator: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - open_issues: 4 - closed_issues: 8 - created_at: '2011-04-10T20:09:31Z' - updated_at: '2014-03-03T18:58:10Z' - closed_at: '2013-02-12T13:22:01Z' - due_on: '2012-10-09T23:39:01Z' - active_lock_reason: too heated - created_at: '2011-01-26T19:01:12Z' - updated_at: '2011-01-26T19:01:12Z' - closed_at: '2011-01-26T19:01:12Z' - merged_at: '2011-01-26T19:01:12Z' - merge_commit_sha: e5bd3914e2e596debea16f433f57875b5b90bcd6 - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - assignees: - - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - - login: hubot - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/hubot_happy.gif - gravatar_id: '' - url: https://api.github.com/users/hubot - html_url: https://github.com/hubot - followers_url: https://api.github.com/users/hubot/followers - following_url: https://api.github.com/users/hubot/following{/other_user} - gists_url: https://api.github.com/users/hubot/gists{/gist_id} - starred_url: https://api.github.com/users/hubot/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/hubot/subscriptions - organizations_url: https://api.github.com/users/hubot/orgs - repos_url: https://api.github.com/users/hubot/repos - events_url: https://api.github.com/users/hubot/events{/privacy} - received_events_url: https://api.github.com/users/hubot/received_events - type: User - site_admin: true - requested_reviewers: + - login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + - login: hubot + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/hubot_happy.gif + gravatar_id: '' + url: https://api.github.com/users/hubot + html_url: https://github.com/hubot + followers_url: https://api.github.com/users/hubot/followers + following_url: https://api.github.com/users/hubot/following{/other_user} + gists_url: https://api.github.com/users/hubot/gists{/gist_id} + starred_url: https://api.github.com/users/hubot/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/hubot/subscriptions + organizations_url: https://api.github.com/users/hubot/orgs + repos_url: https://api.github.com/users/hubot/repos + events_url: https://api.github.com/users/hubot/events{/privacy} + received_events_url: https://api.github.com/users/hubot/received_events + type: User + site_admin: true + - login: other_user + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/other_user_happy.gif + gravatar_id: '' + url: https://api.github.com/users/other_user + html_url: https://github.com/other_user + followers_url: https://api.github.com/users/other_user/followers + following_url: https://api.github.com/users/other_user/following{/other_user} + gists_url: https://api.github.com/users/other_user/gists{/gist_id} + starred_url: https://api.github.com/users/other_user/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/other_user/subscriptions + organizations_url: https://api.github.com/users/other_user/orgs + repos_url: https://api.github.com/users/other_user/repos + events_url: https://api.github.com/users/other_user/events{/privacy} + received_events_url: https://api.github.com/users/other_user/received_events + type: User + site_admin: false + requested_teams: + - id: 1 + node_id: MDQ6VGVhbTE= + url: https://api.github.com/teams/1 + html_url: https://github.com/orgs/github/teams/justice-league + name: Justice League + slug: justice-league + description: A great team. + privacy: closed + notification_setting: notifications_enabled + permission: admin + members_url: https://api.github.com/teams/1/members{/member} + repositories_url: https://api.github.com/teams/1/repos + parent: + head: + label: octocat:new-topic + ref: new-topic + sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e + user: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + repo: + id: 1296269 + node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 + name: Hello-World + full_name: octocat/Hello-World + owner: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + private: false + html_url: https://github.com/octocat/Hello-World + description: This your first repo! + fork: false + url: https://api.github.com/repos/octocat/Hello-World + archive_url: https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref} + assignees_url: https://api.github.com/repos/octocat/Hello-World/assignees{/user} + blobs_url: https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha} + branches_url: https://api.github.com/repos/octocat/Hello-World/branches{/branch} + collaborators_url: https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator} + comments_url: https://api.github.com/repos/octocat/Hello-World/comments{/number} + commits_url: https://api.github.com/repos/octocat/Hello-World/commits{/sha} + compare_url: https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head} + contents_url: https://api.github.com/repos/octocat/Hello-World/contents/{+path} + contributors_url: https://api.github.com/repos/octocat/Hello-World/contributors + deployments_url: https://api.github.com/repos/octocat/Hello-World/deployments + downloads_url: https://api.github.com/repos/octocat/Hello-World/downloads + events_url: https://api.github.com/repos/octocat/Hello-World/events + forks_url: https://api.github.com/repos/octocat/Hello-World/forks + git_commits_url: https://api.github.com/repos/octocat/Hello-World/git/commits{/sha} + git_refs_url: https://api.github.com/repos/octocat/Hello-World/git/refs{/sha} + git_tags_url: https://api.github.com/repos/octocat/Hello-World/git/tags{/sha} + git_url: git:github.com/octocat/Hello-World.git + issue_comment_url: https://api.github.com/repos/octocat/Hello-World/issues/comments{/number} + issue_events_url: https://api.github.com/repos/octocat/Hello-World/issues/events{/number} + issues_url: https://api.github.com/repos/octocat/Hello-World/issues{/number} + keys_url: https://api.github.com/repos/octocat/Hello-World/keys{/key_id} + labels_url: https://api.github.com/repos/octocat/Hello-World/labels{/name} + languages_url: https://api.github.com/repos/octocat/Hello-World/languages + merges_url: https://api.github.com/repos/octocat/Hello-World/merges + milestones_url: https://api.github.com/repos/octocat/Hello-World/milestones{/number} + notifications_url: https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating} + pulls_url: https://api.github.com/repos/octocat/Hello-World/pulls{/number} + releases_url: https://api.github.com/repos/octocat/Hello-World/releases{/id} + ssh_url: git@github.com:octocat/Hello-World.git + stargazers_url: https://api.github.com/repos/octocat/Hello-World/stargazers + statuses_url: https://api.github.com/repos/octocat/Hello-World/statuses/{sha} + subscribers_url: https://api.github.com/repos/octocat/Hello-World/subscribers + subscription_url: https://api.github.com/repos/octocat/Hello-World/subscription + tags_url: https://api.github.com/repos/octocat/Hello-World/tags + teams_url: https://api.github.com/repos/octocat/Hello-World/teams + trees_url: https://api.github.com/repos/octocat/Hello-World/git/trees{/sha} + clone_url: https://github.com/octocat/Hello-World.git + mirror_url: git:git.example.com/octocat/Hello-World + hooks_url: https://api.github.com/repos/octocat/Hello-World/hooks + svn_url: https://svn.github.com/octocat/Hello-World + homepage: https://github.com + language: + forks_count: 9 + stargazers_count: 80 + watchers_count: 80 + size: 108 + default_branch: master + open_issues_count: 0 + is_template: true + topics: + - octocat + - atom + - electron + - api + has_issues: true + has_projects: true + has_wiki: true + has_pages: false + has_downloads: true + archived: false + disabled: false + visibility: public + pushed_at: '2011-01-26T19:06:43Z' + created_at: '2011-01-26T19:01:12Z' + updated_at: '2011-01-26T19:14:43Z' + permissions: + admin: false + push: false + pull: true + allow_rebase_merge: true + template_repository: + temp_clone_token: ABTLWHOULUVAXGTRYU7OC2876QJ2O + allow_squash_merge: true + allow_auto_merge: false + delete_branch_on_merge: true + allow_merge_commit: true + subscribers_count: 42 + network_count: 0 + license: + key: mit + name: MIT License + url: https://api.github.com/licenses/mit + spdx_id: MIT + node_id: MDc6TGljZW5zZW1pdA== + html_url: https://github.com/licenses/mit + forks: 1 + open_issues: 1 + watchers: 1 + base: + label: octocat:master + ref: master + sha: 6dcb09b5b57875f334f61aebed695e2e4193db5e + user: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + repo: + id: 1296269 + node_id: MDEwOlJlcG9zaXRvcnkxMjk2MjY5 + name: Hello-World + full_name: octocat/Hello-World + owner: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + private: false + html_url: https://github.com/octocat/Hello-World + description: This your first repo! + fork: false + url: https://api.github.com/repos/octocat/Hello-World + archive_url: https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref} + assignees_url: https://api.github.com/repos/octocat/Hello-World/assignees{/user} + blobs_url: https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha} + branches_url: https://api.github.com/repos/octocat/Hello-World/branches{/branch} + collaborators_url: https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator} + comments_url: https://api.github.com/repos/octocat/Hello-World/comments{/number} + commits_url: https://api.github.com/repos/octocat/Hello-World/commits{/sha} + compare_url: https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head} + contents_url: https://api.github.com/repos/octocat/Hello-World/contents/{+path} + contributors_url: https://api.github.com/repos/octocat/Hello-World/contributors + deployments_url: https://api.github.com/repos/octocat/Hello-World/deployments + downloads_url: https://api.github.com/repos/octocat/Hello-World/downloads + events_url: https://api.github.com/repos/octocat/Hello-World/events + forks_url: https://api.github.com/repos/octocat/Hello-World/forks + git_commits_url: https://api.github.com/repos/octocat/Hello-World/git/commits{/sha} + git_refs_url: https://api.github.com/repos/octocat/Hello-World/git/refs{/sha} + git_tags_url: https://api.github.com/repos/octocat/Hello-World/git/tags{/sha} + git_url: git:github.com/octocat/Hello-World.git + issue_comment_url: https://api.github.com/repos/octocat/Hello-World/issues/comments{/number} + issue_events_url: https://api.github.com/repos/octocat/Hello-World/issues/events{/number} + issues_url: https://api.github.com/repos/octocat/Hello-World/issues{/number} + keys_url: https://api.github.com/repos/octocat/Hello-World/keys{/key_id} + labels_url: https://api.github.com/repos/octocat/Hello-World/labels{/name} + languages_url: https://api.github.com/repos/octocat/Hello-World/languages + merges_url: https://api.github.com/repos/octocat/Hello-World/merges + milestones_url: https://api.github.com/repos/octocat/Hello-World/milestones{/number} + notifications_url: https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating} + pulls_url: https://api.github.com/repos/octocat/Hello-World/pulls{/number} + releases_url: https://api.github.com/repos/octocat/Hello-World/releases{/id} + ssh_url: git@github.com:octocat/Hello-World.git + stargazers_url: https://api.github.com/repos/octocat/Hello-World/stargazers + statuses_url: https://api.github.com/repos/octocat/Hello-World/statuses/{sha} + subscribers_url: https://api.github.com/repos/octocat/Hello-World/subscribers + subscription_url: https://api.github.com/repos/octocat/Hello-World/subscription + tags_url: https://api.github.com/repos/octocat/Hello-World/tags + teams_url: https://api.github.com/repos/octocat/Hello-World/teams + trees_url: https://api.github.com/repos/octocat/Hello-World/git/trees{/sha} + clone_url: https://github.com/octocat/Hello-World.git + mirror_url: git:git.example.com/octocat/Hello-World + hooks_url: https://api.github.com/repos/octocat/Hello-World/hooks + svn_url: https://svn.github.com/octocat/Hello-World + homepage: https://github.com + language: + forks_count: 9 + stargazers_count: 80 + watchers_count: 80 + size: 108 + default_branch: master + open_issues_count: 0 + is_template: true + topics: + - octocat + - atom + - electron + - api + has_issues: true + has_projects: true + has_wiki: true + has_pages: false + has_downloads: true + archived: false + disabled: false + visibility: public + pushed_at: '2011-01-26T19:06:43Z' + created_at: '2011-01-26T19:01:12Z' + updated_at: '2011-01-26T19:14:43Z' + permissions: + admin: false + push: false + pull: true + allow_rebase_merge: true + template_repository: + temp_clone_token: ABTLWHOULUVAXGTRYU7OC2876QJ2O + allow_squash_merge: true + allow_auto_merge: false + delete_branch_on_merge: true + allow_merge_commit: true + subscribers_count: 42 + network_count: 0 + license: + key: mit + name: MIT License + url: https://api.github.com/licenses/mit + spdx_id: MIT + node_id: MDc6TGljZW5zZW1pdA== + html_url: https://api.github.com/licenses/mit + forks: 1 + open_issues: 1 + watchers: 1 + _links: + self: + href: https://api.github.com/repos/octocat/Hello-World/pulls/1347 + html: + href: https://github.com/octocat/Hello-World/pull/1347 + issue: + href: https://api.github.com/repos/octocat/Hello-World/issues/1347 + comments: + href: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments + review_comments: + href: https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments + review_comment: + href: https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number} + commits: + href: https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits + statuses: + href: https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e + author_association: OWNER + auto_merge: + draft: false + pull-request-simple: + value: + url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 + id: 1 + node_id: MDExOlB1bGxSZXF1ZXN0MQ== + html_url: https://github.com/octocat/Hello-World/pull/1347 + diff_url: https://github.com/octocat/Hello-World/pull/1347.diff + patch_url: https://github.com/octocat/Hello-World/pull/1347.patch + issue_url: https://api.github.com/repos/octocat/Hello-World/issues/1347 + commits_url: https://api.github.com/repos/octocat/Hello-World/pulls/1347/commits + review_comments_url: https://api.github.com/repos/octocat/Hello-World/pulls/1347/comments + review_comment_url: https://api.github.com/repos/octocat/Hello-World/pulls/comments{/number} + comments_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments + statuses_url: https://api.github.com/repos/octocat/Hello-World/statuses/6dcb09b5b57875f334f61aebed695e2e4193db5e + number: 1347 + state: open + locked: true + title: Amazing new feature + user: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + body: Please pull these awesome changes in! + labels: + - id: 208045946 + node_id: MDU6TGFiZWwyMDgwNDU5NDY= + url: https://api.github.com/repos/octocat/Hello-World/labels/bug + name: bug + description: Something isn't working + color: f29513 + default: true + milestone: + url: https://api.github.com/repos/octocat/Hello-World/milestones/1 + html_url: https://github.com/octocat/Hello-World/milestones/v1.0 + labels_url: https://api.github.com/repos/octocat/Hello-World/milestones/1/labels + id: 1002604 + node_id: MDk6TWlsZXN0b25lMTAwMjYwNA== + number: 1 + state: open + title: v1.0 + description: Tracking milestone for version 1.0 + creator: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + open_issues: 4 + closed_issues: 8 + created_at: '2011-04-10T20:09:31Z' + updated_at: '2014-03-03T18:58:10Z' + closed_at: '2013-02-12T13:22:01Z' + due_on: '2012-10-09T23:39:01Z' + active_lock_reason: too heated + created_at: '2011-01-26T19:01:12Z' + updated_at: '2011-01-26T19:01:12Z' + closed_at: '2011-01-26T19:01:12Z' + merged_at: '2011-01-26T19:01:12Z' + assignees: + - login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + - login: hubot + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/hubot_happy.gif + gravatar_id: '' + url: https://api.github.com/users/hubot + html_url: https://github.com/hubot + followers_url: https://api.github.com/users/hubot/followers + following_url: https://api.github.com/users/hubot/following{/other_user} + gists_url: https://api.github.com/users/hubot/gists{/gist_id} + starred_url: https://api.github.com/users/hubot/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/hubot/subscriptions + organizations_url: https://api.github.com/users/hubot/orgs + repos_url: https://api.github.com/users/hubot/repos + events_url: https://api.github.com/users/hubot/events{/privacy} + received_events_url: https://api.github.com/users/hubot/received_events + type: User + site_admin: true + requested_reviewers: - login: other_user id: 1 node_id: MDQ6VXNlcjE= @@ -237224,9 +234696,6 @@ components: patched_versions: 1.0.2 vulnerable_functions: - function2 - cvss: - vector_string: CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H - score: 9.8 cvss_severities: cvss_v3: vector_string: CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H @@ -237412,7 +234881,6 @@ components: patched_versions: 1.0.0 vulnerable_functions: - important_function - cvss: cvss_severities: cvss_v3: cvss_v4: @@ -237995,7 +235463,6 @@ components: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -238427,7 +235894,6 @@ components: name: bug color: ff0000 state: open - assignee: milestone: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -238817,7 +236283,6 @@ components: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public diff --git a/descriptions/api.github.com/api.github.com.json b/descriptions/api.github.com/api.github.com.json index 428e99851..831835272 100644 --- a/descriptions/api.github.com/api.github.com.json +++ b/descriptions/api.github.com/api.github.com.json @@ -522,3163 +522,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -17561,226 +14404,249 @@ } }, "403": { - "$ref": "#/components/responses/forbidden" - }, - "404": { - "$ref": "#/components/responses/not_found" - } - }, - "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": [ - { - "$ref": "#/components/parameters/org" - }, - { - "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, - "example": "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.\\-_]+$", - "example": "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", + "$ref": "#/components/responses/forbidden" + }, + "404": { + "$ref": "#/components/responses/not_found" + } + }, + "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": [ + { + "$ref": "#/components/parameters/org" + }, + { + "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, + "example": "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.\\-_]+$", + "example": "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": { + "$ref": "#/components/schemas/artifact-deployment-record" + } + } + }, + "required": [ + "total_count" + ] + }, + "examples": { + "default": { + "$ref": "#/components/examples/artifact-deployment-record-list" + } + } + } + } + }, + "403": { + "description": "Forbidden", "content": { "application/json": { "schema": { - "type": "object", - "properties": { - "total_count": { - "description": "The number of deployment records created", - "type": "integer" - }, - "deployment_records": { - "type": "array", - "items": { - "$ref": "#/components/schemas/artifact-deployment-record" - } - } - }, - "required": [ - "total_count" - ] + "$ref": "#/components/schemas/basic-error" }, "examples": { - "default": { - "$ref": "#/components/examples/artifact-deployment-record-list" + "insufficient_repo_permissions": { + "value": { + "message": { + "cause": "artifact metadata write permission required on one or more repositories", + "repositories": [ + 123, + 345 + ] + } + } } } } } }, - "403": { - "description": "Forbidden", + "404": { + "description": "Resource not found", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/basic-error" }, "examples": { - "insufficient_repo_permissions": { + "not_found": { "value": { "message": { - "cause": "artifact metadata write permission required on one or more repositories", + "cause": "One or more repositories do not exist", "repositories": [ - 123, - 345 + "repoA", + "repoB" ] } } @@ -17788,9 +14654,6 @@ } } } - }, - "404": { - "$ref": "#/components/responses/not_found" } }, "x-github": { @@ -290118,7 +286981,19 @@ "type": "analyst" } ] - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] }, "integration": { "value": { @@ -294211,7 +291086,18 @@ "site_admin": false }, "truncated": false - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_beta_media_type", + "patch": { + "value": { + "user": null + } + }, + "version": "2026-03-10" + } + ] }, "gitignore-template": { "value": { @@ -301647,130 +298533,142 @@ "forks": 1, "open_issues": 1, "watchers": 1 - }, - "source": { - "id": 1296269, - "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", - "name": "Hello-World", - "full_name": "octocat/Hello-World", - "owner": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, - "private": false, - "html_url": "https://github.com/octocat/Hello-World", - "description": "This your first repo!", - "fork": false, - "url": "https://api.github.com/repos/octocat/Hello-World", - "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", - "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", - "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", - "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", - "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", - "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", - "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", - "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", - "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", - "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", - "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", - "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", - "events_url": "https://api.github.com/repos/octocat/Hello-World/events", - "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", - "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", - "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", - "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", - "git_url": "git:github.com/octocat/Hello-World.git", - "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", - "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", - "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", - "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", - "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", - "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", - "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", - "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", - "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", - "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", - "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", - "ssh_url": "git@github.com:octocat/Hello-World.git", - "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", - "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", - "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", - "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", - "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", - "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", - "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", - "clone_url": "https://github.com/octocat/Hello-World.git", - "mirror_url": "git:git.example.com/octocat/Hello-World", - "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", - "svn_url": "https://svn.github.com/octocat/Hello-World", - "homepage": "https://github.com", - "language": null, - "forks_count": 9, - "stargazers_count": 80, - "watchers_count": 80, - "size": 108, - "default_branch": "master", - "open_issues_count": 0, - "is_template": true, - "topics": [ - "octocat", - "atom", - "electron", - "api" + }, + "source": { + "id": 1296269, + "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", + "name": "Hello-World", + "full_name": "octocat/Hello-World", + "owner": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "private": false, + "html_url": "https://github.com/octocat/Hello-World", + "description": "This your first repo!", + "fork": false, + "url": "https://api.github.com/repos/octocat/Hello-World", + "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", + "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", + "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", + "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", + "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", + "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", + "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", + "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", + "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", + "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", + "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", + "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", + "events_url": "https://api.github.com/repos/octocat/Hello-World/events", + "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", + "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", + "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", + "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", + "git_url": "git:github.com/octocat/Hello-World.git", + "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", + "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", + "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", + "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", + "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", + "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", + "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", + "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", + "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", + "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", + "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", + "ssh_url": "git@github.com:octocat/Hello-World.git", + "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", + "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", + "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", + "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", + "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", + "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", + "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", + "clone_url": "https://github.com/octocat/Hello-World.git", + "mirror_url": "git:git.example.com/octocat/Hello-World", + "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", + "svn_url": "https://svn.github.com/octocat/Hello-World", + "homepage": "https://github.com", + "language": null, + "forks_count": 9, + "stargazers_count": 80, + "watchers_count": 80, + "size": 108, + "default_branch": "master", + "open_issues_count": 0, + "is_template": true, + "topics": [ + "octocat", + "atom", + "electron", + "api" + ], + "has_issues": true, + "has_projects": true, + "has_wiki": true, + "has_pages": false, + "has_downloads": true, + "archived": false, + "disabled": false, + "visibility": "public", + "pushed_at": "2011-01-26T19:06:43Z", + "created_at": "2011-01-26T19:01:12Z", + "updated_at": "2011-01-26T19:14:43Z", + "permissions": { + "admin": false, + "push": false, + "pull": true + }, + "allow_rebase_merge": true, + "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", + "allow_squash_merge": true, + "allow_auto_merge": false, + "delete_branch_on_merge": true, + "allow_merge_commit": true, + "subscribers_count": 42, + "network_count": 0, + "license": { + "key": "mit", + "name": "MIT License", + "url": "https://api.github.com/licenses/mit", + "spdx_id": "MIT", + "node_id": "MDc6TGljZW5zZW1pdA==", + "html_url": "https://api.github.com/licenses/mit" + }, + "forks": 1, + "open_issues": 1, + "watchers": 1 + } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } ], - "has_issues": true, - "has_projects": true, - "has_wiki": true, - "has_pages": false, - "has_downloads": true, - "archived": false, - "disabled": false, - "visibility": "public", - "pushed_at": "2011-01-26T19:06:43Z", - "created_at": "2011-01-26T19:01:12Z", - "updated_at": "2011-01-26T19:14:43Z", - "permissions": { - "admin": false, - "push": false, - "pull": true - }, - "allow_rebase_merge": true, - "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", - "allow_squash_merge": true, - "allow_auto_merge": false, - "delete_branch_on_merge": true, - "allow_merge_commit": true, - "subscribers_count": 42, - "network_count": 0, - "license": { - "key": "mit", - "name": "MIT License", - "url": "https://api.github.com/licenses/mit", - "spdx_id": "MIT", - "node_id": "MDc6TGljZW5zZW1pdA==", - "html_url": "https://api.github.com/licenses/mit" - }, - "forks": 1, - "open_issues": 1, - "watchers": 1 + "version": "2026-03-10" } - } + ] }, "org-ruleset-items": { "value": [ @@ -302951,7 +299849,19 @@ "forks": 1, "open_issues": 1, "watchers": 1 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] }, "team-items-response-if-child-teams-exist": { "value": [ @@ -303061,7 +299971,19 @@ "remaining": 4999, "reset": 1372700873 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_rate_limit_rate", + "patch": [ + { + "op": "remove", + "path": "/value/rate" + } + ], + "version": "2026-03-10" + } + ] }, "full-repository-default-response": { "summary": "Default response", @@ -303591,7 +300513,19 @@ } } } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] }, "artifact-paginated": { "value": { @@ -312159,7 +309093,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "issue-comment-items": { "value": [ @@ -312879,7 +309825,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "issue-event-for-issue-items": { "value": [ @@ -314072,7 +311030,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "pull-request-review-comment-items": { "value": [ @@ -315454,7 +312434,29 @@ "author_association": "OWNER", "auto_merge": null, "draft": false - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "pull-request-review-items": { "value": [ @@ -316805,7 +313807,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] }, "repository-advisory-pvr": { "value": { @@ -316955,7 +313969,19 @@ } ], "private_fork": null - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] }, "simple-user-items-default-response": { "summary": "Default response", @@ -317760,7 +314786,19 @@ "subscribers_count": 42, "network_count": 0 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] }, "public-repository-items": { "value": [ @@ -318152,7 +315190,19 @@ "state_reason": "completed" } ] - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/items/0/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "issue-search-result-item-paginated-lexical-fallback": { "summary": "Hybrid search with lexical fallback", @@ -318549,7 +315599,19 @@ "forks": 1, "open_issues": 1, "watchers": 1 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] }, "private-user-response-with-public-and-private-profile-information": { "summary": "Response with public and private profile information", diff --git a/descriptions/api.github.com/api.github.com.yaml b/descriptions/api.github.com/api.github.com.yaml index 395b24880..e6cc892d7 100644 --- a/descriptions/api.github.com/api.github.com.yaml +++ b/descriptions/api.github.com/api.github.com.yaml @@ -338,2456 +338,6 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 @@ -13037,7 +10587,19 @@ paths: - 123 - 345 '404': - "$ref": "#/components/responses/not_found" + description: Resource not found + content: + application/json: + schema: + "$ref": "#/components/schemas/basic-error" + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -216284,6 +213846,12 @@ components: type: User site_admin: false type: analyst + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' integration: value: id: 1 @@ -220110,6 +217678,12 @@ components: type: User site_admin: false truncated: false + x-github-breaking-changes: + - changeset: deprecate_beta_media_type + patch: + value: + user: + version: '2026-03-10' gitignore-template: value: name: C @@ -226557,6 +224131,12 @@ components: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' org-ruleset-items: value: - id: 21 @@ -227527,6 +225107,12 @@ components: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' team-items-response-if-child-teams-exist: value: - id: 2 @@ -227617,6 +225203,12 @@ components: used: 1 remaining: 4999 reset: 1372700873 + x-github-breaking-changes: + - changeset: remove_rate_limit_rate + patch: + - op: remove + path: "/value/rate" + version: '2026-03-10' full-repository-default-response: summary: Default response value: @@ -228118,6 +225710,12 @@ components: status: disabled secret_scanning_delegated_alert_dismissal: status: disabled + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' artifact-paginated: value: total_count: 2 @@ -235356,6 +232954,12 @@ components: site_admin: false author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' issue-comment-items: value: - id: 1 @@ -236009,6 +233613,12 @@ components: site_admin: false author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' issue-event-for-issue-items: value: - id: 1 @@ -237069,6 +234679,17 @@ components: additions: 100 deletions: 3 changed_files: 5 + x-github-breaking-changes: + - changeset: remove_pull_request_merge_commit_sha + patch: + - op: remove + path: "/value/merge_commit_sha" + version: '2026-03-10' + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' pull-request-review-comment-items: value: - url: https://api.github.com/repos/octocat/Hello-World/pulls/comments/1 @@ -238317,6 +235938,17 @@ components: author_association: OWNER auto_merge: draft: false + x-github-breaking-changes: + - changeset: remove_pull_request_merge_commit_sha + patch: + - op: remove + path: "/value/merge_commit_sha" + version: '2026-03-10' + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' pull-request-review-items: value: - id: 80 @@ -239423,6 +237055,12 @@ components: tags_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/tags teams_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams trees_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha} + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' repository-advisory-pvr: value: ghsa_id: GHSA-abcd-1234-efgh @@ -239541,6 +237179,12 @@ components: permission: admin parent: private_fork: + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' simple-user-items-default-response: summary: Default response value: @@ -240185,6 +237829,12 @@ components: allow_forking: true subscribers_count: 42 network_count: 0 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' public-repository-items: value: - id: 1296269 @@ -240538,6 +238188,12 @@ components: locked: true author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/items/0/assignee" + version: '2026-03-10' issue-search-result-item-paginated-lexical-fallback: summary: Hybrid search with lexical fallback description: When a hybrid or semantic search falls back to lexical, the response @@ -240910,6 +238566,12 @@ components: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' private-user-response-with-public-and-private-profile-information: summary: Response with public and private profile information value: diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json index c01d00785..2f292db72 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.json @@ -2020,3163 +2020,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -95798,6 +92641,19 @@ "type": "string" } } + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } } } } diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml index 6b326f384..5e46913c7 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.2022-11-28.deref.yaml @@ -1113,2456 +1113,6 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 @@ -27863,7 +25413,19 @@ paths: repositories: - 123 - 345 - '404': *6 + '404': + description: Resource not found + content: + application/json: + schema: *3 + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json index 81618ca21..3180df118 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.json @@ -1874,10 +1874,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H", - "score": 7.6 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H", @@ -1960,3163 +1956,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -47633,7 +44472,6 @@ "updated_at": "2011-06-20T11:34:15Z", "description": "Hello World Examples", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/", "owner": { "login": "octocat", @@ -92417,6 +89255,19 @@ "type": "string" } } + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } } } } @@ -192870,7 +189721,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -216383,7 +213233,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -217399,12 +214248,6 @@ "remaining": 10, "reset": 1691591091 } - }, - "rate": { - "limit": 5000, - "used": 1, - "remaining": 4999, - "reset": 1372700873 } } } @@ -220805,7 +217648,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "has_discussions": false, "archived": false, "disabled": false, @@ -224958,7 +221800,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -352129,7 +348970,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -371411,26 +368251,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -388467,26 +385287,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -388684,26 +385484,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -391947,26 +388727,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -395204,26 +391964,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -398264,26 +395004,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -406417,26 +403137,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -409642,26 +406342,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -426829,26 +423509,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -430949,26 +427609,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -437223,26 +433863,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -440447,26 +437067,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -471171,27 +467771,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -477717,27 +474296,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -481585,27 +478143,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -495978,27 +492515,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -527467,10 +523983,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -529554,7 +526066,6 @@ ] } ], - "cvss": null, "cvss_severities": { "cvss_v3": null, "cvss_v4": null @@ -531457,10 +527968,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -533599,10 +530106,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -533852,10 +530355,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -537759,7 +534258,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -542971,7 +539469,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -546707,7 +543204,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -554581,7 +551077,6 @@ } ], "state": "open", - "assignee": null, "milestone": { "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1", "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0", @@ -561768,7 +558263,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -608507,7 +605001,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", diff --git a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml index 0503ce1b1..573feb33e 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.2026-03-10.deref.yaml @@ -1040,2500 +1040,47 @@ paths: vulnerable_version_range: "<=1.0.2" vulnerable_functions: - a_function - cvss: - vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H - score: 7.6 - cvss_severities: - cvss_v3: - vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H - score: 7.6 - cvss_v4: - vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N - score: 9.3 - cwes: - - cwe_id: CWE-400 - name: Uncontrolled Resource Consumption - credits: - - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - type: analyst - '404': &6 - description: Resource not found - content: - application/json: - schema: *3 - x-github: - githubCloudOnly: false - enabledForGitHubApps: true - category: security-advisories - subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: + cvss_severities: + cvss_v3: + vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H + score: 7.6 + cvss_v4: + vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N + score: 9.3 + cwes: + - cwe_id: CWE-400 + name: Uncontrolled Resource Consumption + credits: + - user: + login: octocat id: 1 - repository: - id: 1296269 - state: completed - session_count: 1 - artifacts: - - provider: github - type: pull - data: - id: 42 - 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 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + type: analyst + '404': &6 + 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 - "/agents/tasks/{task_id}": - get: - summary: Get a task by ID - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 + schema: *3 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 + category: security-advisories + subcategory: global-advisories "/app": get: summary: Get the authenticated app @@ -16830,7 +14377,6 @@ paths: updated_at: '2011-06-20T11:34:15Z' description: Hello World Examples comments: 0 - user: comments_url: https://api.github.com/gists/aa5a315d61ae9438b18d/comments/ owner: login: octocat @@ -27552,7 +25098,19 @@ paths: repositories: - 123 - 345 - '404': *6 + '404': + description: Resource not found + content: + application/json: + schema: *3 + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -45872,7 +43430,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -52236,7 +49793,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -52629,11 +50185,6 @@ paths: used: 0 remaining: 10 reset: 1691591091 - rate: - limit: 5000 - used: 1 - remaining: 4999 - reset: 1372700873 headers: X-RateLimit-Limit: example: 5000 @@ -52772,7 +50323,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true has_discussions: false archived: false disabled: false @@ -80999,262 +78549,243 @@ paths: author_association: COLLABORATOR state_reason: completed headers: - Link: *67 - '301': *346 - '422': *15 - '404': *6 - x-github: - githubCloudOnly: false - enabledForGitHubApps: true - category: issues - subcategory: issues - post: - summary: Create an issue - description: |- - Any user with pull access to a repository can create an issue. If [issues are disabled in the repository](https://docs.github.com/articles/disabling-issues/), the API returns a `410 Gone` status. - - This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" - and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." - - This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)." - - - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type. - - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`. - - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`. - - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`. - tags: - - issues - operationId: issues/create - externalDocs: - description: API method documentation - url: https://docs.github.com/rest/issues/issues#create-an-issue - parameters: - - *342 - - *343 - requestBody: - required: true - content: - application/json: - schema: - type: object - properties: - title: - oneOf: - - type: string - - type: integer - description: The title of the issue. - body: - type: string - description: The contents of the issue. - milestone: - oneOf: - - type: string - - type: integer - description: 'The `number` of the milestone to associate this - issue with. _NOTE: Only users with push access can set the milestone - for new issues. The milestone is silently dropped otherwise._' - nullable: true - labels: - type: array - description: 'Labels to associate with this issue. _NOTE: Only users - with push access can set labels for new issues. Labels are silently - dropped otherwise._' - items: - oneOf: - - type: string - - type: object - properties: - id: - type: integer - name: - type: string - description: - type: string - nullable: true - color: - type: string - nullable: true - assignees: - type: array - description: 'Logins for Users to assign to this issue. _NOTE: Only - users with push access can set assignees for new issues. Assignees - are silently dropped otherwise._' - items: - type: string - type: - type: string - description: 'The name of the issue type to associate with this - issue. _NOTE: Only users with push access can set the type for - new issues. The type is silently dropped otherwise._' - nullable: true - example: Epic - required: - - title - examples: - default: - value: - title: Found a bug - body: I'm having a problem with this. - assignees: - - octocat - milestone: 1 - labels: - - bug - responses: - '201': - description: Response - content: - application/json: - schema: *85 - examples: - default: &552 - value: - id: 1 - node_id: MDU6SXNzdWUx - url: https://api.github.com/repos/octocat/Hello-World/issues/1347 - repository_url: https://api.github.com/repos/octocat/Hello-World - labels_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name} - comments_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments - events_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/events - html_url: https://github.com/octocat/Hello-World/issues/1347 - number: 1347 - state: open - title: Found a bug - body: I'm having a problem with this. - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - pinned_comment: - labels: - - id: 208045946 - node_id: MDU6TGFiZWwyMDgwNDU5NDY= - url: https://api.github.com/repos/octocat/Hello-World/labels/bug - name: bug - description: Something isn't working - color: f29513 - default: true - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - assignees: - - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - milestone: - url: https://api.github.com/repos/octocat/Hello-World/milestones/1 - html_url: https://github.com/octocat/Hello-World/milestones/v1.0 - labels_url: https://api.github.com/repos/octocat/Hello-World/milestones/1/labels - id: 1002604 - node_id: MDk6TWlsZXN0b25lMTAwMjYwNA== - number: 1 - state: open - title: v1.0 - description: Tracking milestone for version 1.0 - creator: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - open_issues: 4 - closed_issues: 8 - created_at: '2011-04-10T20:09:31Z' - updated_at: '2014-03-03T18:58:10Z' - closed_at: '2013-02-12T13:22:01Z' - due_on: '2012-10-09T23:39:01Z' - locked: true - active_lock_reason: too heated - comments: 0 - pull_request: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 - html_url: https://github.com/octocat/Hello-World/pull/1347 - diff_url: https://github.com/octocat/Hello-World/pull/1347.diff - patch_url: https://github.com/octocat/Hello-World/pull/1347.patch - closed_at: - created_at: '2011-04-22T13:33:48Z' - updated_at: '2011-04-22T13:33:48Z' - closed_by: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - author_association: COLLABORATOR - state_reason: completed - headers: + Link: *67 + '301': *346 + '422': *15 + '404': *6 + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: issues + subcategory: issues + post: + summary: Create an issue + description: |- + Any user with pull access to a repository can create an issue. If [issues are disabled in the repository](https://docs.github.com/articles/disabling-issues/), the API returns a `410 Gone` status. + + This endpoint triggers [notifications](https://docs.github.com/github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" + and "[Best practices for using the REST API](https://docs.github.com/rest/guides/best-practices-for-using-the-rest-api)." + + This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)." + + - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type. + - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`. + - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`. + - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`. + tags: + - issues + operationId: issues/create + externalDocs: + description: API method documentation + url: https://docs.github.com/rest/issues/issues#create-an-issue + parameters: + - *342 + - *343 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + title: + oneOf: + - type: string + - type: integer + description: The title of the issue. + body: + type: string + description: The contents of the issue. + milestone: + oneOf: + - type: string + - type: integer + description: 'The `number` of the milestone to associate this + issue with. _NOTE: Only users with push access can set the milestone + for new issues. The milestone is silently dropped otherwise._' + nullable: true + labels: + type: array + description: 'Labels to associate with this issue. _NOTE: Only users + with push access can set labels for new issues. Labels are silently + dropped otherwise._' + items: + oneOf: + - type: string + - type: object + properties: + id: + type: integer + name: + type: string + description: + type: string + nullable: true + color: + type: string + nullable: true + assignees: + type: array + description: 'Logins for Users to assign to this issue. _NOTE: Only + users with push access can set assignees for new issues. Assignees + are silently dropped otherwise._' + items: + type: string + type: + type: string + description: 'The name of the issue type to associate with this + issue. _NOTE: Only users with push access can set the type for + new issues. The type is silently dropped otherwise._' + nullable: true + example: Epic + required: + - title + examples: + default: + value: + title: Found a bug + body: I'm having a problem with this. + assignees: + - octocat + milestone: 1 + labels: + - bug + responses: + '201': + description: Response + content: + application/json: + schema: *85 + examples: + default: &552 + value: + id: 1 + node_id: MDU6SXNzdWUx + url: https://api.github.com/repos/octocat/Hello-World/issues/1347 + repository_url: https://api.github.com/repos/octocat/Hello-World + labels_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name} + comments_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments + events_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/events + html_url: https://github.com/octocat/Hello-World/issues/1347 + number: 1347 + state: open + title: Found a bug + body: I'm having a problem with this. + user: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + pinned_comment: + labels: + - id: 208045946 + node_id: MDU6TGFiZWwyMDgwNDU5NDY= + url: https://api.github.com/repos/octocat/Hello-World/labels/bug + name: bug + description: Something isn't working + color: f29513 + default: true + assignees: + - login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + milestone: + url: https://api.github.com/repos/octocat/Hello-World/milestones/1 + html_url: https://github.com/octocat/Hello-World/milestones/v1.0 + labels_url: https://api.github.com/repos/octocat/Hello-World/milestones/1/labels + id: 1002604 + node_id: MDk6TWlsZXN0b25lMTAwMjYwNA== + number: 1 + state: open + title: v1.0 + description: Tracking milestone for version 1.0 + creator: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + open_issues: 4 + closed_issues: 8 + created_at: '2011-04-10T20:09:31Z' + updated_at: '2014-03-03T18:58:10Z' + closed_at: '2013-02-12T13:22:01Z' + due_on: '2012-10-09T23:39:01Z' + locked: true + active_lock_reason: too heated + comments: 0 + pull_request: + url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 + html_url: https://github.com/octocat/Hello-World/pull/1347 + diff_url: https://github.com/octocat/Hello-World/pull/1347.diff + patch_url: https://github.com/octocat/Hello-World/pull/1347.patch + closed_at: + created_at: '2011-04-22T13:33:48Z' + updated_at: '2011-04-22T13:33:48Z' + closed_by: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + author_association: COLLABORATOR + state_reason: completed + headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1347 schema: @@ -82474,25 +80005,6 @@ paths: description: Something isn't working color: f29513 default: true - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -88747,26 +86259,6 @@ paths: updated_at: '2011-01-26T19:01:12Z' closed_at: '2011-01-26T19:01:12Z' merged_at: '2011-01-26T19:01:12Z' - merge_commit_sha: e5bd3914e2e596debea16f433f57875b5b90bcd6 - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -91203,26 +88695,6 @@ paths: updated_at: '2011-01-26T19:01:12Z' closed_at: '2011-01-26T19:01:12Z' merged_at: '2011-01-26T19:01:12Z' - merge_commit_sha: e5bd3914e2e596debea16f433f57875b5b90bcd6 - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -95569,9 +93041,6 @@ paths: patched_versions: 1.0.2 vulnerable_functions: - function2 - cvss: - vector_string: CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H - score: 9.8 cvss_severities: cvss_v3: vector_string: CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H @@ -95885,7 +93354,6 @@ paths: patched_versions: 1.0.0 vulnerable_functions: - important_function - cvss: cvss_severities: cvss_v3: cvss_v4: @@ -97834,7 +95302,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -99422,7 +96889,6 @@ paths: name: bug color: ff0000 state: open - assignee: milestone: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -101236,7 +98702,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.json b/descriptions/api.github.com/dereferenced/api.github.com.deref.json index 06c3d7498..5d74bb3c5 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.deref.json +++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.json @@ -2091,7 +2091,19 @@ "type": "analyst" } ] - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -2132,3163 +2144,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -50977,7 +47832,18 @@ "site_admin": false }, "truncated": false - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_beta_media_type", + "patch": { + "value": { + "user": null + } + }, + "version": "2026-03-10" + } + ] } } } @@ -97831,6 +94697,19 @@ "type": "string" } } + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } } } } @@ -205268,130 +202147,142 @@ "forks": 1, "open_issues": 1, "watchers": 1 - }, - "source": { - "id": 1296269, - "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", - "name": "Hello-World", - "full_name": "octocat/Hello-World", - "owner": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, - "private": false, - "html_url": "https://github.com/octocat/Hello-World", - "description": "This your first repo!", - "fork": false, - "url": "https://api.github.com/repos/octocat/Hello-World", - "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", - "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", - "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", - "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", - "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", - "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", - "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", - "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", - "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", - "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", - "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", - "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", - "events_url": "https://api.github.com/repos/octocat/Hello-World/events", - "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", - "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", - "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", - "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", - "git_url": "git:github.com/octocat/Hello-World.git", - "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", - "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", - "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", - "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", - "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", - "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", - "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", - "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", - "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", - "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", - "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", - "ssh_url": "git@github.com:octocat/Hello-World.git", - "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", - "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", - "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", - "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", - "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", - "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", - "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", - "clone_url": "https://github.com/octocat/Hello-World.git", - "mirror_url": "git:git.example.com/octocat/Hello-World", - "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", - "svn_url": "https://svn.github.com/octocat/Hello-World", - "homepage": "https://github.com", - "language": null, - "forks_count": 9, - "stargazers_count": 80, - "watchers_count": 80, - "size": 108, - "default_branch": "master", - "open_issues_count": 0, - "is_template": true, - "topics": [ - "octocat", - "atom", - "electron", - "api" + }, + "source": { + "id": 1296269, + "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", + "name": "Hello-World", + "full_name": "octocat/Hello-World", + "owner": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "private": false, + "html_url": "https://github.com/octocat/Hello-World", + "description": "This your first repo!", + "fork": false, + "url": "https://api.github.com/repos/octocat/Hello-World", + "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", + "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", + "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", + "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", + "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", + "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", + "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", + "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", + "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", + "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", + "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", + "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", + "events_url": "https://api.github.com/repos/octocat/Hello-World/events", + "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", + "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", + "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", + "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", + "git_url": "git:github.com/octocat/Hello-World.git", + "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", + "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", + "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", + "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", + "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", + "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", + "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", + "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", + "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", + "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", + "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", + "ssh_url": "git@github.com:octocat/Hello-World.git", + "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", + "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", + "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", + "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", + "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", + "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", + "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", + "clone_url": "https://github.com/octocat/Hello-World.git", + "mirror_url": "git:git.example.com/octocat/Hello-World", + "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", + "svn_url": "https://svn.github.com/octocat/Hello-World", + "homepage": "https://github.com", + "language": null, + "forks_count": 9, + "stargazers_count": 80, + "watchers_count": 80, + "size": 108, + "default_branch": "master", + "open_issues_count": 0, + "is_template": true, + "topics": [ + "octocat", + "atom", + "electron", + "api" + ], + "has_issues": true, + "has_projects": true, + "has_wiki": true, + "has_pages": false, + "has_downloads": true, + "archived": false, + "disabled": false, + "visibility": "public", + "pushed_at": "2011-01-26T19:06:43Z", + "created_at": "2011-01-26T19:01:12Z", + "updated_at": "2011-01-26T19:14:43Z", + "permissions": { + "admin": false, + "push": false, + "pull": true + }, + "allow_rebase_merge": true, + "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", + "allow_squash_merge": true, + "allow_auto_merge": false, + "delete_branch_on_merge": true, + "allow_merge_commit": true, + "subscribers_count": 42, + "network_count": 0, + "license": { + "key": "mit", + "name": "MIT License", + "url": "https://api.github.com/licenses/mit", + "spdx_id": "MIT", + "node_id": "MDc6TGljZW5zZW1pdA==", + "html_url": "https://api.github.com/licenses/mit" + }, + "forks": 1, + "open_issues": 1, + "watchers": 1 + } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } ], - "has_issues": true, - "has_projects": true, - "has_wiki": true, - "has_pages": false, - "has_downloads": true, - "archived": false, - "disabled": false, - "visibility": "public", - "pushed_at": "2011-01-26T19:06:43Z", - "created_at": "2011-01-26T19:01:12Z", - "updated_at": "2011-01-26T19:14:43Z", - "permissions": { - "admin": false, - "push": false, - "pull": true - }, - "allow_rebase_merge": true, - "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", - "allow_squash_merge": true, - "allow_auto_merge": false, - "delete_branch_on_merge": true, - "allow_merge_commit": true, - "subscribers_count": 42, - "network_count": 0, - "license": { - "key": "mit", - "name": "MIT License", - "url": "https://api.github.com/licenses/mit", - "spdx_id": "MIT", - "node_id": "MDc6TGljZW5zZW1pdA==", - "html_url": "https://api.github.com/licenses/mit" - }, - "forks": 1, - "open_issues": 1, - "watchers": 1 + "version": "2026-03-10" } - } + ] } } } @@ -228751,7 +225642,19 @@ "forks": 1, "open_issues": 1, "watchers": 1 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -229779,7 +226682,19 @@ "remaining": 4999, "reset": 1372700873 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_rate_limit_rate", + "patch": [ + { + "op": "remove", + "path": "/value/rate" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -234000,7 +230915,19 @@ } } } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -238515,7 +235442,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -367782,130 +364721,142 @@ "forks": 1, "open_issues": 1, "watchers": 1 - }, - "source": { - "id": 1296269, - "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", - "name": "Hello-World", - "full_name": "octocat/Hello-World", - "owner": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, - "private": false, - "html_url": "https://github.com/octocat/Hello-World", - "description": "This your first repo!", - "fork": false, - "url": "https://api.github.com/repos/octocat/Hello-World", - "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", - "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", - "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", - "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", - "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", - "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", - "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", - "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", - "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", - "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", - "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", - "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", - "events_url": "https://api.github.com/repos/octocat/Hello-World/events", - "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", - "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", - "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", - "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", - "git_url": "git:github.com/octocat/Hello-World.git", - "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", - "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", - "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", - "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", - "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", - "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", - "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", - "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", - "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", - "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", - "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", - "ssh_url": "git@github.com:octocat/Hello-World.git", - "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", - "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", - "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", - "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", - "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", - "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", - "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", - "clone_url": "https://github.com/octocat/Hello-World.git", - "mirror_url": "git:git.example.com/octocat/Hello-World", - "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", - "svn_url": "https://svn.github.com/octocat/Hello-World", - "homepage": "https://github.com", - "language": null, - "forks_count": 9, - "stargazers_count": 80, - "watchers_count": 80, - "size": 108, - "default_branch": "master", - "open_issues_count": 0, - "is_template": true, - "topics": [ - "octocat", - "atom", - "electron", - "api" + }, + "source": { + "id": 1296269, + "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", + "name": "Hello-World", + "full_name": "octocat/Hello-World", + "owner": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "private": false, + "html_url": "https://github.com/octocat/Hello-World", + "description": "This your first repo!", + "fork": false, + "url": "https://api.github.com/repos/octocat/Hello-World", + "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", + "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", + "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", + "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", + "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", + "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", + "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", + "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", + "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", + "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", + "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", + "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", + "events_url": "https://api.github.com/repos/octocat/Hello-World/events", + "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", + "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", + "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", + "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", + "git_url": "git:github.com/octocat/Hello-World.git", + "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", + "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", + "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", + "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", + "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", + "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", + "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", + "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", + "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", + "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", + "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", + "ssh_url": "git@github.com:octocat/Hello-World.git", + "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", + "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", + "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", + "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", + "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", + "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", + "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", + "clone_url": "https://github.com/octocat/Hello-World.git", + "mirror_url": "git:git.example.com/octocat/Hello-World", + "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", + "svn_url": "https://svn.github.com/octocat/Hello-World", + "homepage": "https://github.com", + "language": null, + "forks_count": 9, + "stargazers_count": 80, + "watchers_count": 80, + "size": 108, + "default_branch": "master", + "open_issues_count": 0, + "is_template": true, + "topics": [ + "octocat", + "atom", + "electron", + "api" + ], + "has_issues": true, + "has_projects": true, + "has_wiki": true, + "has_pages": false, + "has_downloads": true, + "archived": false, + "disabled": false, + "visibility": "public", + "pushed_at": "2011-01-26T19:06:43Z", + "created_at": "2011-01-26T19:01:12Z", + "updated_at": "2011-01-26T19:14:43Z", + "permissions": { + "admin": false, + "push": false, + "pull": true + }, + "allow_rebase_merge": true, + "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", + "allow_squash_merge": true, + "allow_auto_merge": false, + "delete_branch_on_merge": true, + "allow_merge_commit": true, + "subscribers_count": 42, + "network_count": 0, + "license": { + "key": "mit", + "name": "MIT License", + "url": "https://api.github.com/licenses/mit", + "spdx_id": "MIT", + "node_id": "MDc6TGljZW5zZW1pdA==", + "html_url": "https://api.github.com/licenses/mit" + }, + "forks": 1, + "open_issues": 1, + "watchers": 1 + } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } ], - "has_issues": true, - "has_projects": true, - "has_wiki": true, - "has_pages": false, - "has_downloads": true, - "archived": false, - "disabled": false, - "visibility": "public", - "pushed_at": "2011-01-26T19:06:43Z", - "created_at": "2011-01-26T19:01:12Z", - "updated_at": "2011-01-26T19:14:43Z", - "permissions": { - "admin": false, - "push": false, - "pull": true - }, - "allow_rebase_merge": true, - "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", - "allow_squash_merge": true, - "allow_auto_merge": false, - "delete_branch_on_merge": true, - "allow_merge_commit": true, - "subscribers_count": 42, - "network_count": 0, - "license": { - "key": "mit", - "name": "MIT License", - "url": "https://api.github.com/licenses/mit", - "spdx_id": "MIT", - "node_id": "MDc6TGljZW5zZW1pdA==", - "html_url": "https://api.github.com/licenses/mit" - }, - "forks": 1, - "open_issues": 1, - "watchers": 1 + "version": "2026-03-10" } - } + ] } } } @@ -387537,7 +384488,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -405530,7 +402493,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } }, "pinned_comment": { @@ -405747,7 +402722,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -409321,7 +406308,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -412903,7 +409902,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -416269,7 +413280,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -425034,7 +422057,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -428565,7 +425600,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -446364,7 +443411,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -450790,7 +447849,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -457676,7 +454747,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -461206,7 +458289,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -493513,7 +490608,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -500536,7 +497653,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -504881,7 +502020,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -520195,7 +517356,29 @@ "author_association": "OWNER", "auto_merge": null, "draft": false - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -551542,7 +548725,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -553616,7 +550811,19 @@ } ], "private_fork": null - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -555656,7 +552863,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -557860,7 +555079,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] }, "add_credit": { "value": { @@ -558113,7 +555344,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -562655,7 +559898,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -567608,7 +564863,19 @@ "subscribers_count": 42, "network_count": 0 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -572005,7 +569272,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -579848,7 +577127,19 @@ "state_reason": "completed" } ] - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/items/0/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "lexical-fallback": { "summary": "Hybrid search with lexical fallback", @@ -587120,7 +584411,19 @@ "forks": 1, "open_issues": 1, "watchers": 1 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -639224,7 +636527,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } diff --git a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml index fa635370b..e3a0ad074 100644 --- a/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml +++ b/descriptions/api.github.com/dereferenced/api.github.com.deref.yaml @@ -1154,2466 +1154,22 @@ paths: type: User site_admin: false type: analyst - '404': &6 - description: Resource not found - content: - application/json: - schema: *3 - x-github: - githubCloudOnly: false - enabledForGitHubApps: true - category: security-advisories - subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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 + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' + '404': &6 + 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 - "/agents/tasks/{task_id}": - get: - summary: Get a task by ID - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 + schema: *3 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 + category: security-advisories + subcategory: global-advisories "/app": get: summary: Get the authenticated app @@ -17399,6 +14955,12 @@ paths: type: User site_admin: false truncated: false + x-github-breaking-changes: + - changeset: deprecate_beta_media_type + patch: + value: + user: + version: '2026-03-10' headers: Location: example: https://api.github.com/gists/aa5a315d61ae9438b18d @@ -28144,7 +25706,19 @@ paths: repositories: - 123 - 345 - '404': *6 + '404': + description: Resource not found + content: + application/json: + schema: *3 + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -47070,6 +44644,12 @@ paths: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -53235,6 +50815,12 @@ paths: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' '204': description: Response if team has permission for the repository. This is the response when the repository media type hasn't been provded in the @@ -53611,6 +51197,12 @@ paths: used: 1 remaining: 4999 reset: 1372700873 + x-github-breaking-changes: + - changeset: remove_rate_limit_rate + patch: + - op: remove + path: "/value/rate" + version: '2026-03-10' headers: X-RateLimit-Limit: example: 5000 @@ -54158,6 +51750,12 @@ paths: status: disabled secret_scanning_delegated_alert_dismissal: status: disabled + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' '403': *29 '404': *6 '301': *348 @@ -82331,6 +79929,12 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1347 @@ -83667,6 +81271,12 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' '301': *348 '404': *6 '410': *546 @@ -90365,6 +87975,17 @@ paths: additions: 100 deletions: 3 changed_files: 5 + x-github-breaking-changes: + - changeset: remove_pull_request_merge_commit_sha + patch: + - op: remove + path: "/value/merge_commit_sha" + version: '2026-03-10' + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' headers: Location: example: https://api.github.com/repos/octocat/Hello-World/pulls/1347 @@ -92805,6 +90426,17 @@ paths: author_association: OWNER auto_merge: draft: false + x-github-breaking-changes: + - changeset: remove_pull_request_merge_commit_sha + patch: + - op: remove + path: "/value/merge_commit_sha" + version: '2026-03-10' + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' '422': *15 x-github: githubCloudOnly: false @@ -96917,6 +94549,12 @@ paths: tags_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/tags teams_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams trees_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha} + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' '403': *29 '404': *6 '422': *15 @@ -97163,6 +94801,12 @@ paths: permission: admin parent: private_fork: + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' '403': *29 '404': *6 '422': *15 @@ -99173,6 +96817,12 @@ paths: allow_forking: true subscribers_count: 42 network_count: 0 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -100718,6 +98368,12 @@ paths: locked: true author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/items/0/assignee" + version: '2026-03-10' lexical-fallback: summary: Hybrid search with lexical fallback description: When a hybrid or semantic search falls back to lexical, @@ -102514,6 +100170,12 @@ paths: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' '204': description: Response if repository is managed by this team '404': diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json index 61a357256..4cfbc898a 100644 --- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json +++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.json @@ -2036,3163 +2036,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -142806,6 +139649,19 @@ "type": "string" } } + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } } } } diff --git a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml index 6844a8d63..357cf515a 100644 --- a/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml +++ b/descriptions/ghec/dereferenced/ghec.2022-11-28.deref.yaml @@ -1121,2456 +1121,6 @@ paths: enabledForGitHubApps: true category: security-advisories subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 @@ -41947,7 +39497,19 @@ paths: repositories: - 123 - 345 - '404': *6 + '404': + description: Resource not found + content: + application/json: + schema: *3 + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true diff --git a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json index 72c5aa4b0..23c32dae5 100644 --- a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json +++ b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.json @@ -1890,10 +1890,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H", - "score": 7.6 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H", @@ -1976,3163 +1972,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -96037,7 +92876,6 @@ "updated_at": "2011-06-20T11:34:15Z", "description": "Hello World Examples", "comments": 0, - "user": null, "comments_url": "https://api.github.com/gists/aa5a315d61ae9438b18d/comments/", "owner": { "login": "octocat", @@ -139190,6 +136028,19 @@ "type": "string" } } + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } } } } @@ -246867,7 +243718,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -271203,7 +268053,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -272527,12 +269376,6 @@ "remaining": 10, "reset": 1691591091 } - }, - "rate": { - "limit": 5000, - "used": 1, - "remaining": 4999, - "reset": 1372700873 } } } @@ -275946,7 +272789,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "has_discussions": false, "archived": false, "disabled": false, @@ -280126,7 +276968,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -413482,7 +410323,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -432804,26 +429644,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -449860,26 +446680,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -450077,26 +446877,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -453340,26 +450120,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -456597,26 +453357,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -459657,26 +456397,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -467810,26 +464530,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -471035,26 +467735,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -488222,26 +484902,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -492342,26 +489002,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -498616,26 +495256,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -501840,26 +498460,6 @@ "default": true } ], - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -532683,27 +529283,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -539229,27 +535808,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -543097,27 +539655,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -557514,27 +554051,6 @@ "updated_at": "2011-01-26T19:01:12Z", "closed_at": "2011-01-26T19:01:12Z", "merged_at": "2011-01-26T19:01:12Z", - "merge_commit_sha": "e5bd3914e2e596debea16f433f57875b5b90bcd6", - "assignee": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, "assignees": [ { "login": "octocat", @@ -589009,10 +585525,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -591096,7 +587608,6 @@ ] } ], - "cvss": null, "cvss_severities": { "cvss_v3": null, "cvss_v4": null @@ -592999,10 +589510,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -595141,10 +591648,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -595394,10 +591897,6 @@ ] } ], - "cvss": { - "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", - "score": 9.8 - }, "cvss_severities": { "cvss_v3": { "vector_string": "CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H", @@ -599313,7 +595812,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -604537,7 +601035,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -608285,7 +604782,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -626200,7 +622696,6 @@ } ], "state": "open", - "assignee": null, "milestone": { "url": "https://api.github.com/repos/octocat/Hello-World/milestones/1", "html_url": "https://github.com/octocat/Hello-World/milestones/v1.0", @@ -633399,7 +629894,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", @@ -680761,7 +677255,6 @@ "has_projects": true, "has_wiki": true, "has_pages": false, - "has_downloads": true, "archived": false, "disabled": false, "visibility": "public", diff --git a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml index fb3ca287f..d00e58db5 100644 --- a/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml +++ b/descriptions/ghec/dereferenced/ghec.2026-03-10.deref.yaml @@ -1048,2500 +1048,47 @@ paths: vulnerable_version_range: "<=1.0.2" vulnerable_functions: - a_function - cvss: - vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H - score: 7.6 - cvss_severities: - cvss_v3: - vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H - score: 7.6 - cvss_v4: - vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N - score: 9.3 - cwes: - - cwe_id: CWE-400 - name: Uncontrolled Resource Consumption - credits: - - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - type: analyst - '404': &6 - description: Resource not found - content: - application/json: - schema: *3 - x-github: - githubCloudOnly: false - enabledForGitHubApps: true - category: security-advisories - subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: + cvss_severities: + cvss_v3: + vector_string: CVSS:3.1/AV:N/AC:H/PR:H/UI:R/S:C/C:H/I:H/A:H + score: 7.6 + cvss_v4: + vector_string: CVSS:4.0/AV:N/AC:L/AT:N/PR:N/UI:N/VC:H/VI:H/VA:H/SC:N/SI:N/SA:N + score: 9.3 + cwes: + - cwe_id: CWE-400 + name: Uncontrolled Resource Consumption + credits: + - user: + login: octocat id: 1 - repository: - id: 1296269 - state: completed - session_count: 1 - artifacts: - - provider: github - type: pull - data: - id: 42 - 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 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + type: analyst + '404': &6 + 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 - "/agents/tasks/{task_id}": - get: - summary: Get a task by ID - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 + schema: *3 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 + category: security-advisories + subcategory: global-advisories "/app": get: summary: Get the authenticated app @@ -32419,7 +29966,6 @@ paths: updated_at: '2011-06-20T11:34:15Z' description: Hello World Examples comments: 0 - user: comments_url: https://api.github.com/gists/aa5a315d61ae9438b18d/comments/ owner: login: octocat @@ -41556,7 +39102,19 @@ paths: repositories: - 123 - 345 - '404': *6 + '404': + description: Resource not found + content: + application/json: + schema: *3 + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -60442,7 +58000,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -64967,7 +62524,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -65471,11 +63027,6 @@ paths: used: 0 remaining: 10 reset: 1691591091 - rate: - limit: 5000 - used: 1 - remaining: 4999 - reset: 1372700873 headers: X-RateLimit-Limit: example: 5000 @@ -65615,7 +63166,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true has_discussions: false archived: false disabled: false @@ -94849,262 +92399,243 @@ paths: author_association: COLLABORATOR state_reason: completed headers: - Link: *47 - '301': *484 - '422': *15 - '404': *6 - x-github: - githubCloudOnly: false - enabledForGitHubApps: true - category: issues - subcategory: issues - post: - summary: Create an issue - description: |- - Any user with pull access to a repository can create an issue. If [issues are disabled in the repository](https://docs.github.com/enterprise-cloud@latest//articles/disabling-issues/), the API returns a `410 Gone` status. - - This endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest//github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" - and "[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest//rest/guides/best-practices-for-using-the-rest-api)." - - This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)." - - - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type. - - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`. - - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`. - - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`. - tags: - - issues - operationId: issues/create - externalDocs: - description: API method documentation - url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#create-an-issue - parameters: - - *478 - - *479 - requestBody: - required: true - content: - application/json: - schema: - type: object - properties: - title: - oneOf: - - type: string - - type: integer - description: The title of the issue. - body: - type: string - description: The contents of the issue. - milestone: - oneOf: - - type: string - - type: integer - description: 'The `number` of the milestone to associate this - issue with. _NOTE: Only users with push access can set the milestone - for new issues. The milestone is silently dropped otherwise._' - nullable: true - labels: - type: array - description: 'Labels to associate with this issue. _NOTE: Only users - with push access can set labels for new issues. Labels are silently - dropped otherwise._' - items: - oneOf: - - type: string - - type: object - properties: - id: - type: integer - name: - type: string - description: - type: string - nullable: true - color: - type: string - nullable: true - assignees: - type: array - description: 'Logins for Users to assign to this issue. _NOTE: Only - users with push access can set assignees for new issues. Assignees - are silently dropped otherwise._' - items: - type: string - type: - type: string - description: 'The name of the issue type to associate with this - issue. _NOTE: Only users with push access can set the type for - new issues. The type is silently dropped otherwise._' - nullable: true - example: Epic - required: - - title - examples: - default: - value: - title: Found a bug - body: I'm having a problem with this. - assignees: - - octocat - milestone: 1 - labels: - - bug - responses: - '201': - description: Response - content: - application/json: - schema: *227 - examples: - default: &678 - value: - id: 1 - node_id: MDU6SXNzdWUx - url: https://api.github.com/repos/octocat/Hello-World/issues/1347 - repository_url: https://api.github.com/repos/octocat/Hello-World - labels_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name} - comments_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments - events_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/events - html_url: https://github.com/octocat/Hello-World/issues/1347 - number: 1347 - state: open - title: Found a bug - body: I'm having a problem with this. - user: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - pinned_comment: - labels: - - id: 208045946 - node_id: MDU6TGFiZWwyMDgwNDU5NDY= - url: https://api.github.com/repos/octocat/Hello-World/labels/bug - name: bug - description: Something isn't working - color: f29513 - default: true - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - assignees: - - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - milestone: - url: https://api.github.com/repos/octocat/Hello-World/milestones/1 - html_url: https://github.com/octocat/Hello-World/milestones/v1.0 - labels_url: https://api.github.com/repos/octocat/Hello-World/milestones/1/labels - id: 1002604 - node_id: MDk6TWlsZXN0b25lMTAwMjYwNA== - number: 1 - state: open - title: v1.0 - description: Tracking milestone for version 1.0 - creator: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - open_issues: 4 - closed_issues: 8 - created_at: '2011-04-10T20:09:31Z' - updated_at: '2014-03-03T18:58:10Z' - closed_at: '2013-02-12T13:22:01Z' - due_on: '2012-10-09T23:39:01Z' - locked: true - active_lock_reason: too heated - comments: 0 - pull_request: - url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 - html_url: https://github.com/octocat/Hello-World/pull/1347 - diff_url: https://github.com/octocat/Hello-World/pull/1347.diff - patch_url: https://github.com/octocat/Hello-World/pull/1347.patch - closed_at: - created_at: '2011-04-22T13:33:48Z' - updated_at: '2011-04-22T13:33:48Z' - closed_by: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false - author_association: COLLABORATOR - state_reason: completed - headers: + Link: *47 + '301': *484 + '422': *15 + '404': *6 + x-github: + githubCloudOnly: false + enabledForGitHubApps: true + category: issues + subcategory: issues + post: + summary: Create an issue + description: |- + Any user with pull access to a repository can create an issue. If [issues are disabled in the repository](https://docs.github.com/enterprise-cloud@latest//articles/disabling-issues/), the API returns a `410 Gone` status. + + This endpoint triggers [notifications](https://docs.github.com/enterprise-cloud@latest//github/managing-subscriptions-and-notifications-on-github/about-notifications). Creating content too quickly using this endpoint may result in secondary rate limiting. For more information, see "[Rate limits for the API](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/rate-limits-for-the-rest-api#about-secondary-rate-limits)" + and "[Best practices for using the REST API](https://docs.github.com/enterprise-cloud@latest//rest/guides/best-practices-for-using-the-rest-api)." + + This endpoint supports the following custom media types. For more information, see "[Media types](https://docs.github.com/enterprise-cloud@latest//rest/using-the-rest-api/getting-started-with-the-rest-api#media-types)." + + - **`application/vnd.github.raw+json`**: Returns the raw markdown body. Response will include `body`. This is the default if you do not pass any specific media type. + - **`application/vnd.github.text+json`**: Returns a text only representation of the markdown body. Response will include `body_text`. + - **`application/vnd.github.html+json`**: Returns HTML rendered from the body's markdown. Response will include `body_html`. + - **`application/vnd.github.full+json`**: Returns raw, text, and HTML representations. Response will include `body`, `body_text`, and `body_html`. + tags: + - issues + operationId: issues/create + externalDocs: + description: API method documentation + url: https://docs.github.com/enterprise-cloud@latest//rest/issues/issues#create-an-issue + parameters: + - *478 + - *479 + requestBody: + required: true + content: + application/json: + schema: + type: object + properties: + title: + oneOf: + - type: string + - type: integer + description: The title of the issue. + body: + type: string + description: The contents of the issue. + milestone: + oneOf: + - type: string + - type: integer + description: 'The `number` of the milestone to associate this + issue with. _NOTE: Only users with push access can set the milestone + for new issues. The milestone is silently dropped otherwise._' + nullable: true + labels: + type: array + description: 'Labels to associate with this issue. _NOTE: Only users + with push access can set labels for new issues. Labels are silently + dropped otherwise._' + items: + oneOf: + - type: string + - type: object + properties: + id: + type: integer + name: + type: string + description: + type: string + nullable: true + color: + type: string + nullable: true + assignees: + type: array + description: 'Logins for Users to assign to this issue. _NOTE: Only + users with push access can set assignees for new issues. Assignees + are silently dropped otherwise._' + items: + type: string + type: + type: string + description: 'The name of the issue type to associate with this + issue. _NOTE: Only users with push access can set the type for + new issues. The type is silently dropped otherwise._' + nullable: true + example: Epic + required: + - title + examples: + default: + value: + title: Found a bug + body: I'm having a problem with this. + assignees: + - octocat + milestone: 1 + labels: + - bug + responses: + '201': + description: Response + content: + application/json: + schema: *227 + examples: + default: &678 + value: + id: 1 + node_id: MDU6SXNzdWUx + url: https://api.github.com/repos/octocat/Hello-World/issues/1347 + repository_url: https://api.github.com/repos/octocat/Hello-World + labels_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/labels{/name} + comments_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/comments + events_url: https://api.github.com/repos/octocat/Hello-World/issues/1347/events + html_url: https://github.com/octocat/Hello-World/issues/1347 + number: 1347 + state: open + title: Found a bug + body: I'm having a problem with this. + user: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + pinned_comment: + labels: + - id: 208045946 + node_id: MDU6TGFiZWwyMDgwNDU5NDY= + url: https://api.github.com/repos/octocat/Hello-World/labels/bug + name: bug + description: Something isn't working + color: f29513 + default: true + assignees: + - login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + milestone: + url: https://api.github.com/repos/octocat/Hello-World/milestones/1 + html_url: https://github.com/octocat/Hello-World/milestones/v1.0 + labels_url: https://api.github.com/repos/octocat/Hello-World/milestones/1/labels + id: 1002604 + node_id: MDk6TWlsZXN0b25lMTAwMjYwNA== + number: 1 + state: open + title: v1.0 + description: Tracking milestone for version 1.0 + creator: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + open_issues: 4 + closed_issues: 8 + created_at: '2011-04-10T20:09:31Z' + updated_at: '2014-03-03T18:58:10Z' + closed_at: '2013-02-12T13:22:01Z' + due_on: '2012-10-09T23:39:01Z' + locked: true + active_lock_reason: too heated + comments: 0 + pull_request: + url: https://api.github.com/repos/octocat/Hello-World/pulls/1347 + html_url: https://github.com/octocat/Hello-World/pull/1347 + diff_url: https://github.com/octocat/Hello-World/pull/1347.diff + patch_url: https://github.com/octocat/Hello-World/pull/1347.patch + closed_at: + created_at: '2011-04-22T13:33:48Z' + updated_at: '2011-04-22T13:33:48Z' + closed_by: + login: octocat + id: 1 + node_id: MDQ6VXNlcjE= + avatar_url: https://github.com/images/error/octocat_happy.gif + gravatar_id: '' + url: https://api.github.com/users/octocat + html_url: https://github.com/octocat + followers_url: https://api.github.com/users/octocat/followers + following_url: https://api.github.com/users/octocat/following{/other_user} + gists_url: https://api.github.com/users/octocat/gists{/gist_id} + starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} + subscriptions_url: https://api.github.com/users/octocat/subscriptions + organizations_url: https://api.github.com/users/octocat/orgs + repos_url: https://api.github.com/users/octocat/repos + events_url: https://api.github.com/users/octocat/events{/privacy} + received_events_url: https://api.github.com/users/octocat/received_events + type: User + site_admin: false + author_association: COLLABORATOR + state_reason: completed + headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1347 schema: @@ -96324,25 +93855,6 @@ paths: description: Something isn't working color: f29513 default: true - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -102643,26 +100155,6 @@ paths: updated_at: '2011-01-26T19:01:12Z' closed_at: '2011-01-26T19:01:12Z' merged_at: '2011-01-26T19:01:12Z' - merge_commit_sha: e5bd3914e2e596debea16f433f57875b5b90bcd6 - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -105099,26 +102591,6 @@ paths: updated_at: '2011-01-26T19:01:12Z' closed_at: '2011-01-26T19:01:12Z' merged_at: '2011-01-26T19:01:12Z' - merge_commit_sha: e5bd3914e2e596debea16f433f57875b5b90bcd6 - assignee: - login: octocat - id: 1 - node_id: MDQ6VXNlcjE= - avatar_url: https://github.com/images/error/octocat_happy.gif - gravatar_id: '' - url: https://api.github.com/users/octocat - html_url: https://github.com/octocat - followers_url: https://api.github.com/users/octocat/followers - following_url: https://api.github.com/users/octocat/following{/other_user} - gists_url: https://api.github.com/users/octocat/gists{/gist_id} - starred_url: https://api.github.com/users/octocat/starred{/owner}{/repo} - subscriptions_url: https://api.github.com/users/octocat/subscriptions - organizations_url: https://api.github.com/users/octocat/orgs - repos_url: https://api.github.com/users/octocat/repos - events_url: https://api.github.com/users/octocat/events{/privacy} - received_events_url: https://api.github.com/users/octocat/received_events - type: User - site_admin: false assignees: - login: octocat id: 1 @@ -109466,9 +106938,6 @@ paths: patched_versions: 1.0.2 vulnerable_functions: - function2 - cvss: - vector_string: CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H - score: 9.8 cvss_severities: cvss_v3: vector_string: CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:H/I:H/A:H @@ -109782,7 +107251,6 @@ paths: patched_versions: 1.0.0 vulnerable_functions: - important_function - cvss: cvss_severities: cvss_v3: cvss_v4: @@ -111731,7 +109199,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public @@ -115346,7 +112813,6 @@ paths: name: bug color: ff0000 state: open - assignee: milestone: url: https://api.github.com/repos/octocat/Hello-World/milestones/1 html_url: https://github.com/octocat/Hello-World/milestones/v1.0 @@ -117164,7 +114630,6 @@ paths: has_projects: true has_wiki: true has_pages: false - has_downloads: true archived: false disabled: false visibility: public diff --git a/descriptions/ghec/dereferenced/ghec.deref.json b/descriptions/ghec/dereferenced/ghec.deref.json index 63be9081b..e0c909ade 100644 --- a/descriptions/ghec/dereferenced/ghec.deref.json +++ b/descriptions/ghec/dereferenced/ghec.deref.json @@ -2107,7 +2107,19 @@ "type": "analyst" } ] - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -2148,3163 +2160,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -99621,7 +96476,18 @@ "site_admin": false }, "truncated": false - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_beta_media_type", + "patch": { + "value": { + "user": null + } + }, + "version": "2026-03-10" + } + ] } } } @@ -145087,6 +141953,19 @@ "type": "string" } } + }, + "examples": { + "not_found": { + "value": { + "message": { + "cause": "One or more repositories do not exist", + "repositories": [ + "repoA", + "repoB" + ] + } + } + } } } } @@ -259760,130 +256639,142 @@ "forks": 1, "open_issues": 1, "watchers": 1 - }, - "source": { - "id": 1296269, - "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", - "name": "Hello-World", - "full_name": "octocat/Hello-World", - "owner": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, - "private": false, - "html_url": "https://github.com/octocat/Hello-World", - "description": "This your first repo!", - "fork": false, - "url": "https://api.github.com/repos/octocat/Hello-World", - "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", - "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", - "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", - "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", - "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", - "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", - "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", - "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", - "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", - "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", - "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", - "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", - "events_url": "https://api.github.com/repos/octocat/Hello-World/events", - "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", - "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", - "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", - "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", - "git_url": "git:github.com/octocat/Hello-World.git", - "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", - "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", - "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", - "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", - "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", - "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", - "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", - "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", - "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", - "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", - "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", - "ssh_url": "git@github.com:octocat/Hello-World.git", - "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", - "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", - "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", - "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", - "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", - "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", - "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", - "clone_url": "https://github.com/octocat/Hello-World.git", - "mirror_url": "git:git.example.com/octocat/Hello-World", - "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", - "svn_url": "https://svn.github.com/octocat/Hello-World", - "homepage": "https://github.com", - "language": null, - "forks_count": 9, - "stargazers_count": 80, - "watchers_count": 80, - "size": 108, - "default_branch": "master", - "open_issues_count": 0, - "is_template": true, - "topics": [ - "octocat", - "atom", - "electron", - "api" + }, + "source": { + "id": 1296269, + "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", + "name": "Hello-World", + "full_name": "octocat/Hello-World", + "owner": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "private": false, + "html_url": "https://github.com/octocat/Hello-World", + "description": "This your first repo!", + "fork": false, + "url": "https://api.github.com/repos/octocat/Hello-World", + "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", + "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", + "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", + "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", + "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", + "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", + "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", + "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", + "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", + "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", + "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", + "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", + "events_url": "https://api.github.com/repos/octocat/Hello-World/events", + "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", + "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", + "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", + "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", + "git_url": "git:github.com/octocat/Hello-World.git", + "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", + "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", + "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", + "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", + "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", + "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", + "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", + "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", + "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", + "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", + "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", + "ssh_url": "git@github.com:octocat/Hello-World.git", + "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", + "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", + "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", + "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", + "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", + "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", + "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", + "clone_url": "https://github.com/octocat/Hello-World.git", + "mirror_url": "git:git.example.com/octocat/Hello-World", + "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", + "svn_url": "https://svn.github.com/octocat/Hello-World", + "homepage": "https://github.com", + "language": null, + "forks_count": 9, + "stargazers_count": 80, + "watchers_count": 80, + "size": 108, + "default_branch": "master", + "open_issues_count": 0, + "is_template": true, + "topics": [ + "octocat", + "atom", + "electron", + "api" + ], + "has_issues": true, + "has_projects": true, + "has_wiki": true, + "has_pages": false, + "has_downloads": true, + "archived": false, + "disabled": false, + "visibility": "public", + "pushed_at": "2011-01-26T19:06:43Z", + "created_at": "2011-01-26T19:01:12Z", + "updated_at": "2011-01-26T19:14:43Z", + "permissions": { + "admin": false, + "push": false, + "pull": true + }, + "allow_rebase_merge": true, + "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", + "allow_squash_merge": true, + "allow_auto_merge": false, + "delete_branch_on_merge": true, + "allow_merge_commit": true, + "subscribers_count": 42, + "network_count": 0, + "license": { + "key": "mit", + "name": "MIT License", + "url": "https://api.github.com/licenses/mit", + "spdx_id": "MIT", + "node_id": "MDc6TGljZW5zZW1pdA==", + "html_url": "https://api.github.com/licenses/mit" + }, + "forks": 1, + "open_issues": 1, + "watchers": 1 + } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } ], - "has_issues": true, - "has_projects": true, - "has_wiki": true, - "has_pages": false, - "has_downloads": true, - "archived": false, - "disabled": false, - "visibility": "public", - "pushed_at": "2011-01-26T19:06:43Z", - "created_at": "2011-01-26T19:01:12Z", - "updated_at": "2011-01-26T19:14:43Z", - "permissions": { - "admin": false, - "push": false, - "pull": true - }, - "allow_rebase_merge": true, - "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", - "allow_squash_merge": true, - "allow_auto_merge": false, - "delete_branch_on_merge": true, - "allow_merge_commit": true, - "subscribers_count": 42, - "network_count": 0, - "license": { - "key": "mit", - "name": "MIT License", - "url": "https://api.github.com/licenses/mit", - "spdx_id": "MIT", - "node_id": "MDc6TGljZW5zZW1pdA==", - "html_url": "https://api.github.com/licenses/mit" - }, - "forks": 1, - "open_issues": 1, - "watchers": 1 + "version": "2026-03-10" } - } + ] } } } @@ -284066,7 +280957,19 @@ "forks": 1, "open_issues": 1, "watchers": 1 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -285402,7 +282305,19 @@ "remaining": 4999, "reset": 1372700873 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_rate_limit_rate", + "patch": [ + { + "op": "remove", + "path": "/value/rate" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -289640,7 +286555,19 @@ } } } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -294178,7 +291105,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -429630,130 +426569,142 @@ "forks": 1, "open_issues": 1, "watchers": 1 - }, - "source": { - "id": 1296269, - "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", - "name": "Hello-World", - "full_name": "octocat/Hello-World", - "owner": { - "login": "octocat", - "id": 1, - "node_id": "MDQ6VXNlcjE=", - "avatar_url": "https://github.com/images/error/octocat_happy.gif", - "gravatar_id": "", - "url": "https://api.github.com/users/octocat", - "html_url": "https://github.com/octocat", - "followers_url": "https://api.github.com/users/octocat/followers", - "following_url": "https://api.github.com/users/octocat/following{/other_user}", - "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", - "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", - "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", - "organizations_url": "https://api.github.com/users/octocat/orgs", - "repos_url": "https://api.github.com/users/octocat/repos", - "events_url": "https://api.github.com/users/octocat/events{/privacy}", - "received_events_url": "https://api.github.com/users/octocat/received_events", - "type": "User", - "site_admin": false - }, - "private": false, - "html_url": "https://github.com/octocat/Hello-World", - "description": "This your first repo!", - "fork": false, - "url": "https://api.github.com/repos/octocat/Hello-World", - "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", - "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", - "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", - "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", - "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", - "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", - "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", - "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", - "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", - "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", - "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", - "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", - "events_url": "https://api.github.com/repos/octocat/Hello-World/events", - "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", - "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", - "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", - "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", - "git_url": "git:github.com/octocat/Hello-World.git", - "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", - "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", - "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", - "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", - "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", - "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", - "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", - "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", - "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", - "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", - "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", - "ssh_url": "git@github.com:octocat/Hello-World.git", - "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", - "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", - "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", - "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", - "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", - "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", - "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", - "clone_url": "https://github.com/octocat/Hello-World.git", - "mirror_url": "git:git.example.com/octocat/Hello-World", - "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", - "svn_url": "https://svn.github.com/octocat/Hello-World", - "homepage": "https://github.com", - "language": null, - "forks_count": 9, - "stargazers_count": 80, - "watchers_count": 80, - "size": 108, - "default_branch": "master", - "open_issues_count": 0, - "is_template": true, - "topics": [ - "octocat", - "atom", - "electron", - "api" + }, + "source": { + "id": 1296269, + "node_id": "MDEwOlJlcG9zaXRvcnkxMjk2MjY5", + "name": "Hello-World", + "full_name": "octocat/Hello-World", + "owner": { + "login": "octocat", + "id": 1, + "node_id": "MDQ6VXNlcjE=", + "avatar_url": "https://github.com/images/error/octocat_happy.gif", + "gravatar_id": "", + "url": "https://api.github.com/users/octocat", + "html_url": "https://github.com/octocat", + "followers_url": "https://api.github.com/users/octocat/followers", + "following_url": "https://api.github.com/users/octocat/following{/other_user}", + "gists_url": "https://api.github.com/users/octocat/gists{/gist_id}", + "starred_url": "https://api.github.com/users/octocat/starred{/owner}{/repo}", + "subscriptions_url": "https://api.github.com/users/octocat/subscriptions", + "organizations_url": "https://api.github.com/users/octocat/orgs", + "repos_url": "https://api.github.com/users/octocat/repos", + "events_url": "https://api.github.com/users/octocat/events{/privacy}", + "received_events_url": "https://api.github.com/users/octocat/received_events", + "type": "User", + "site_admin": false + }, + "private": false, + "html_url": "https://github.com/octocat/Hello-World", + "description": "This your first repo!", + "fork": false, + "url": "https://api.github.com/repos/octocat/Hello-World", + "archive_url": "https://api.github.com/repos/octocat/Hello-World/{archive_format}{/ref}", + "assignees_url": "https://api.github.com/repos/octocat/Hello-World/assignees{/user}", + "blobs_url": "https://api.github.com/repos/octocat/Hello-World/git/blobs{/sha}", + "branches_url": "https://api.github.com/repos/octocat/Hello-World/branches{/branch}", + "collaborators_url": "https://api.github.com/repos/octocat/Hello-World/collaborators{/collaborator}", + "comments_url": "https://api.github.com/repos/octocat/Hello-World/comments{/number}", + "commits_url": "https://api.github.com/repos/octocat/Hello-World/commits{/sha}", + "compare_url": "https://api.github.com/repos/octocat/Hello-World/compare/{base}...{head}", + "contents_url": "https://api.github.com/repos/octocat/Hello-World/contents/{+path}", + "contributors_url": "https://api.github.com/repos/octocat/Hello-World/contributors", + "deployments_url": "https://api.github.com/repos/octocat/Hello-World/deployments", + "downloads_url": "https://api.github.com/repos/octocat/Hello-World/downloads", + "events_url": "https://api.github.com/repos/octocat/Hello-World/events", + "forks_url": "https://api.github.com/repos/octocat/Hello-World/forks", + "git_commits_url": "https://api.github.com/repos/octocat/Hello-World/git/commits{/sha}", + "git_refs_url": "https://api.github.com/repos/octocat/Hello-World/git/refs{/sha}", + "git_tags_url": "https://api.github.com/repos/octocat/Hello-World/git/tags{/sha}", + "git_url": "git:github.com/octocat/Hello-World.git", + "issue_comment_url": "https://api.github.com/repos/octocat/Hello-World/issues/comments{/number}", + "issue_events_url": "https://api.github.com/repos/octocat/Hello-World/issues/events{/number}", + "issues_url": "https://api.github.com/repos/octocat/Hello-World/issues{/number}", + "keys_url": "https://api.github.com/repos/octocat/Hello-World/keys{/key_id}", + "labels_url": "https://api.github.com/repos/octocat/Hello-World/labels{/name}", + "languages_url": "https://api.github.com/repos/octocat/Hello-World/languages", + "merges_url": "https://api.github.com/repos/octocat/Hello-World/merges", + "milestones_url": "https://api.github.com/repos/octocat/Hello-World/milestones{/number}", + "notifications_url": "https://api.github.com/repos/octocat/Hello-World/notifications{?since,all,participating}", + "pulls_url": "https://api.github.com/repos/octocat/Hello-World/pulls{/number}", + "releases_url": "https://api.github.com/repos/octocat/Hello-World/releases{/id}", + "ssh_url": "git@github.com:octocat/Hello-World.git", + "stargazers_url": "https://api.github.com/repos/octocat/Hello-World/stargazers", + "statuses_url": "https://api.github.com/repos/octocat/Hello-World/statuses/{sha}", + "subscribers_url": "https://api.github.com/repos/octocat/Hello-World/subscribers", + "subscription_url": "https://api.github.com/repos/octocat/Hello-World/subscription", + "tags_url": "https://api.github.com/repos/octocat/Hello-World/tags", + "teams_url": "https://api.github.com/repos/octocat/Hello-World/teams", + "trees_url": "https://api.github.com/repos/octocat/Hello-World/git/trees{/sha}", + "clone_url": "https://github.com/octocat/Hello-World.git", + "mirror_url": "git:git.example.com/octocat/Hello-World", + "hooks_url": "https://api.github.com/repos/octocat/Hello-World/hooks", + "svn_url": "https://svn.github.com/octocat/Hello-World", + "homepage": "https://github.com", + "language": null, + "forks_count": 9, + "stargazers_count": 80, + "watchers_count": 80, + "size": 108, + "default_branch": "master", + "open_issues_count": 0, + "is_template": true, + "topics": [ + "octocat", + "atom", + "electron", + "api" + ], + "has_issues": true, + "has_projects": true, + "has_wiki": true, + "has_pages": false, + "has_downloads": true, + "archived": false, + "disabled": false, + "visibility": "public", + "pushed_at": "2011-01-26T19:06:43Z", + "created_at": "2011-01-26T19:01:12Z", + "updated_at": "2011-01-26T19:14:43Z", + "permissions": { + "admin": false, + "push": false, + "pull": true + }, + "allow_rebase_merge": true, + "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", + "allow_squash_merge": true, + "allow_auto_merge": false, + "delete_branch_on_merge": true, + "allow_merge_commit": true, + "subscribers_count": 42, + "network_count": 0, + "license": { + "key": "mit", + "name": "MIT License", + "url": "https://api.github.com/licenses/mit", + "spdx_id": "MIT", + "node_id": "MDc6TGljZW5zZW1pdA==", + "html_url": "https://api.github.com/licenses/mit" + }, + "forks": 1, + "open_issues": 1, + "watchers": 1 + } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } ], - "has_issues": true, - "has_projects": true, - "has_wiki": true, - "has_pages": false, - "has_downloads": true, - "archived": false, - "disabled": false, - "visibility": "public", - "pushed_at": "2011-01-26T19:06:43Z", - "created_at": "2011-01-26T19:01:12Z", - "updated_at": "2011-01-26T19:14:43Z", - "permissions": { - "admin": false, - "push": false, - "pull": true - }, - "allow_rebase_merge": true, - "temp_clone_token": "ABTLWHOULUVAXGTRYU7OC2876QJ2O", - "allow_squash_merge": true, - "allow_auto_merge": false, - "delete_branch_on_merge": true, - "allow_merge_commit": true, - "subscribers_count": 42, - "network_count": 0, - "license": { - "key": "mit", - "name": "MIT License", - "url": "https://api.github.com/licenses/mit", - "spdx_id": "MIT", - "node_id": "MDc6TGljZW5zZW1pdA==", - "html_url": "https://api.github.com/licenses/mit" - }, - "forks": 1, - "open_issues": 1, - "watchers": 1 + "version": "2026-03-10" } - } + ] } } } @@ -449425,7 +446376,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -467418,7 +464381,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } }, "pinned_comment": { @@ -467635,7 +464610,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -471209,7 +468196,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -474791,7 +471790,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -478157,7 +475168,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -486922,7 +483945,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -490453,7 +487488,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -508252,7 +505299,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -512678,7 +509737,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -519564,7 +516635,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -523094,7 +520177,19 @@ }, "author_association": "COLLABORATOR", "state_reason": "completed" - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -555520,7 +552615,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -562543,7 +559660,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -566888,7 +564027,29 @@ "additions": 100, "deletions": 3, "changed_files": 5 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -582226,7 +579387,29 @@ "author_association": "OWNER", "auto_merge": null, "draft": false - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_pull_request_merge_commit_sha", + "patch": [ + { + "op": "remove", + "path": "/value/merge_commit_sha" + } + ], + "version": "2026-03-10" + }, + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/assignee" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -613579,7 +610762,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -615653,7 +612848,19 @@ } ], "private_fork": null - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -617693,7 +614900,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -619897,7 +617116,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] }, "add_credit": { "value": { @@ -620150,7 +617381,19 @@ "teams_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams", "trees_url": "https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha}" } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "deprecate_cvss", + "patch": [ + { + "op": "remove", + "path": "/value/cvss" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -624704,7 +621947,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -629669,7 +626924,19 @@ "subscribers_count": 42, "network_count": 0 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -634078,7 +631345,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -651962,7 +649241,19 @@ "state_reason": "completed" } ] - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_singular_assignee_from_issues_and_pull_requests", + "patch": [ + { + "op": "remove", + "path": "/value/items/0/assignee" + } + ], + "version": "2026-03-10" + } + ] }, "lexical-fallback": { "summary": "Hybrid search with lexical fallback", @@ -659246,7 +656537,19 @@ "forks": 1, "open_issues": 1, "watchers": 1 - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } @@ -711985,7 +709288,19 @@ "open_issues": 1, "watchers": 1 } - } + }, + "x-github-breaking-changes": [ + { + "changeset": "remove_has_downloads", + "patch": [ + { + "op": "remove", + "path": "/value/has_downloads" + } + ], + "version": "2026-03-10" + } + ] } } } diff --git a/descriptions/ghec/dereferenced/ghec.deref.yaml b/descriptions/ghec/dereferenced/ghec.deref.yaml index 67c371d17..c88ea8c73 100644 --- a/descriptions/ghec/dereferenced/ghec.deref.yaml +++ b/descriptions/ghec/dereferenced/ghec.deref.yaml @@ -1162,2466 +1162,22 @@ paths: type: User site_admin: false type: analyst - '404': &6 - description: Resource not found - content: - application/json: - schema: *3 - x-github: - githubCloudOnly: false - enabledForGitHubApps: true - category: security-advisories - subcategory: global-advisories - "/agents/repos/{owner}/{repo}/tasks": - get: - summary: List tasks for repository - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - prompt - properties: - prompt: - type: string - description: The user's prompt for the agent - model: - type: string - description: 'The model to use for this task. The allowed models - may change over time and depend on the user''s GitHub Copilot - plan and organization policies. Currently supported values: `claude-sonnet-4.6`, - `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, - `claude-sonnet-4.5`, `claude-opus-4.5`' - create_pull_request: - type: boolean - description: Whether to create a PR. - default: false - base_ref: - type: string - description: Base ref for new branch/PR - examples: - default: - value: - prompt: Fix the login button on the homepage - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 - default: false - description: Filter by archived status. When `true`, returns only archived - tasks. When `false` or omitted, returns only non-archived tasks. Defaults - to `false`. - - 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: - - pull - - branch - description: 'Type of artifact. Available Values: - `pull`, `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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: pull - data: - id: 42 - 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 + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' + '404': &6 + 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 - "/agents/tasks/{task_id}": - get: - summary: Get a task by ID - description: | - > [!NOTE] - > This endpoint is in public preview and is subject to change. - - 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 + schema: *3 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: - - pull - - branch - description: 'Type of artifact. Available Values: `pull`, - `branch`. - - ' - data: - oneOf: - - type: object - description: A GitHub resource (pull request, issue, - etc.) - required: - - id - properties: - id: - type: integer - format: int64 - description: GitHub resource ID - global_id: - type: string - description: GraphQL global ID - - type: object - description: A Git branch reference - required: - - head_ref - - base_ref - 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 - format: date-time - nullable: true - 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 - 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 - prompt: - type: string - description: Content of the triggering event - head_ref: - type: string - description: Head branch name - base_ref: - type: string - description: Base branch name - model: - type: string - description: Model used for this session - 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: pull - data: - id: 42 - 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' - prompt: Fix the login button on the homepage - head_ref: copilot/fix-1 - base_ref: main - model: claude-sonnet-4.6 - '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 + category: security-advisories + subcategory: global-advisories "/app": get: summary: Get the authenticated app @@ -32988,6 +30544,12 @@ paths: type: User site_admin: false truncated: false + x-github-breaking-changes: + - changeset: deprecate_beta_media_type + patch: + value: + user: + version: '2026-03-10' headers: Location: example: https://api.github.com/gists/aa5a315d61ae9438b18d @@ -42241,7 +39803,19 @@ paths: repositories: - 123 - 345 - '404': *6 + '404': + description: Resource not found + content: + application/json: + schema: *3 + examples: + not_found: + value: + message: + cause: One or more repositories do not exist + repositories: + - repoA + - repoB x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -61664,6 +59238,12 @@ paths: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' headers: Location: example: https://api.github.com/repos/octocat/Hello-World @@ -65990,6 +63570,12 @@ paths: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' '204': description: Response if team has permission for the repository. This is the response when the repository media type hasn't been provded in the @@ -66477,6 +64063,12 @@ paths: used: 1 remaining: 4999 reset: 1372700873 + x-github-breaking-changes: + - changeset: remove_rate_limit_rate + patch: + - op: remove + path: "/value/rate" + version: '2026-03-10' headers: X-RateLimit-Limit: example: 5000 @@ -67028,6 +64620,12 @@ paths: status: disabled secret_scanning_delegated_alert_dismissal: status: disabled + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' '403': *29 '404': *6 '301': *486 @@ -96205,6 +93803,12 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' headers: Location: example: https://api.github.com/repos/octocat/Hello-World/issues/1347 @@ -97541,6 +95145,12 @@ paths: site_admin: false author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' '301': *486 '404': *6 '410': *672 @@ -104285,6 +101895,17 @@ paths: additions: 100 deletions: 3 changed_files: 5 + x-github-breaking-changes: + - changeset: remove_pull_request_merge_commit_sha + patch: + - op: remove + path: "/value/merge_commit_sha" + version: '2026-03-10' + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' headers: Location: example: https://api.github.com/repos/octocat/Hello-World/pulls/1347 @@ -106725,6 +104346,17 @@ paths: author_association: OWNER auto_merge: draft: false + x-github-breaking-changes: + - changeset: remove_pull_request_merge_commit_sha + patch: + - op: remove + path: "/value/merge_commit_sha" + version: '2026-03-10' + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/assignee" + version: '2026-03-10' '422': *15 x-github: githubCloudOnly: false @@ -110838,6 +108470,12 @@ paths: tags_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/tags teams_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/teams trees_url: https://api.github.com/repos/octo-org/octo-repo-ghsa-abcd-1234-efgh/git/trees{/sha} + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' '403': *29 '404': *6 '422': *15 @@ -111084,6 +108722,12 @@ paths: permission: admin parent: private_fork: + x-github-breaking-changes: + - changeset: deprecate_cvss + patch: + - op: remove + path: "/value/cvss" + version: '2026-03-10' '403': *29 '404': *6 '422': *15 @@ -113094,6 +110738,12 @@ paths: allow_forking: true subscribers_count: 42 network_count: 0 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' x-github: githubCloudOnly: false enabledForGitHubApps: true @@ -116666,6 +114316,12 @@ paths: locked: true author_association: COLLABORATOR state_reason: completed + x-github-breaking-changes: + - changeset: remove_singular_assignee_from_issues_and_pull_requests + patch: + - op: remove + path: "/value/items/0/assignee" + version: '2026-03-10' lexical-fallback: summary: Hybrid search with lexical fallback description: When a hybrid or semantic search falls back to lexical, @@ -118466,6 +116122,12 @@ paths: forks: 1 open_issues: 1 watchers: 1 + x-github-breaking-changes: + - changeset: remove_has_downloads + patch: + - op: remove + path: "/value/has_downloads" + version: '2026-03-10' '204': description: Response if repository is managed by this team '404': diff --git a/descriptions/ghec/ghec.2022-11-28.json b/descriptions/ghec/ghec.2022-11-28.json index 8bc36061c..e58ec0ff8 100644 --- a/descriptions/ghec/ghec.2022-11-28.json +++ b/descriptions/ghec/ghec.2022-11-28.json @@ -538,3163 +538,6 @@ } } }, - "/agents/repos/{owner}/{repo}/tasks": { - "get": { - "summary": "List tasks for repository", - "description": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for a specific repository\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nCreates a new task for a repository.\n", - "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": [ - "prompt" - ], - "properties": { - "prompt": { - "type": "string", - "description": "The user's prompt for the agent" - }, - "model": { - "type": "string", - "description": "The model to use for this task. The allowed models may change over time and depend on the user's GitHub Copilot plan and organization policies. Currently supported values: `claude-sonnet-4.6`, `claude-opus-4.6`, `gpt-5.2-codex`, `gpt-5.3-codex`, `gpt-5.4`, `claude-sonnet-4.5`, `claude-opus-4.5`" - }, - "create_pull_request": { - "type": "boolean", - "description": "Whether to create a PR.", - "default": false - }, - "base_ref": { - "type": "string", - "description": "Base ref for new branch/PR" - } - } - }, - "examples": { - "default": { - "value": { - "prompt": "Fix the login button on the homepage", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID scoped to an owner/repo path\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a list of tasks for the authenticated user\n", - "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", - "default": false - }, - "description": "Filter by archived status. When `true`, returns only archived tasks. When `false` or omitted, returns only non-archived tasks. Defaults to `false`." - }, - { - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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": "> [!NOTE]\n> This endpoint is in public preview and is subject to change.\n\nReturns a task by ID with its associated sessions\n", - "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": [ - "pull", - "branch" - ], - "description": "Type of artifact. Available Values: `pull`, `branch`.\n" - }, - "data": { - "oneOf": [ - { - "type": "object", - "description": "A GitHub resource (pull request, issue, etc.)", - "required": [ - "id" - ], - "properties": { - "id": { - "type": "integer", - "format": "int64", - "description": "GitHub resource ID" - }, - "global_id": { - "type": "string", - "description": "GraphQL global ID" - } - } - }, - { - "type": "object", - "description": "A Git branch reference", - "required": [ - "head_ref", - "base_ref" - ], - "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", - "format": "date-time", - "nullable": true, - "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" - } - } - }, - "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" - }, - "prompt": { - "type": "string", - "description": "Content of the triggering event" - }, - "head_ref": { - "type": "string", - "description": "Head branch name" - }, - "base_ref": { - "type": "string", - "description": "Base branch name" - }, - "model": { - "type": "string", - "description": "Model used for this session" - }, - "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": "pull", - "data": { - "id": 42 - } - } - ], - "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", - "prompt": "Fix the login button on the homepage", - "head_ref": "copilot/fix-1", - "base_ref": "main", - "model": "claude-sonnet-4.6" - } - ] - } - } - } - } - } - }, - "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", @@ -28419,7 +25262,27 @@ } }, "404": { - "$ref": "#/components/responses/not_found" + "description": "Resource not found", + "content": { + {"code":"deadline_exceeded","msg":"operation timed out"}