Info
Endpoint added: PATCH /agents/repos/{}/{}/automations/{}
openapi:PATCH /agents/repos/{}/{}/automations/{}::operation.endpoint-added- Product
- GitHub REST API
- Source
- OpenAPI URL
- Change kind
- Endpoint Added
- Detected
- Last updated
Deterministic evidence
Before / after
Extracted from GitHub's published contract. Shows the whole operation — a narrower excerpt was not available for this change. Open the source ↗
null
{
"operationId": "agent-automations/edit-repo-automation",
"parameters": [
{
"in": "path",
"name": "owner",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "repo",
"required": true,
"schema": {
"type": "string"
}
},
{
"in": "path",
"name": "automation_id",
"required": true,
"schema": {
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"allowed_custom_agents": {
"items": {
"type": "string"
},
"type": "array"
},
"enabled": {
"type": "boolean"
},
"model": {
"type": "string"
},
"name": {
"type": "string"
},
"prompt": {
"type": "string"
},
"reasoning_effort": {
"oneOf": [
{
"maxLength": 0,
"type": "string"
},
{
"enum": [
"none",
"low",
"medium",
"high",
"xhigh",
"max"
],
"type": "string"
}
]
},
"require_actor_write_permission": {
"type": "boolean"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
},
"triggers": {
"additionalProperties": false,
"properties": {
"automation_completed": {
"additionalProperties": false,
"properties": {
"automation_ids": {
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"automation_ids"
],
"type": "object"
},
"discussion_comment": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"categories": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"comment_types": {
"items": {
"enum": [
"comment",
"reply"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"discussion_opened": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"categories": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"discussion_updated": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"categories": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"interval": {
"additionalProperties": false,
"properties": {
"cadence": {
"items": {
"enum": [
"hourly",
"daily",
"weekly"
],
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"day_of_week": {
"maximum": 6,
"minimum": 0,
"type": "integer"
},
"hour_utc": {
"maximum": 23,
"minimum": 0,
"type": "integer"
},
"minute_utc": {
"default": 0,
"enum": [
0,
15,
30,
45
],
"type": "integer"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"cadence"
],
"type": "object"
},
"issue_assigned": {
"additionalProperties": false,
"properties": {
"assignees": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"issue_comment": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"issue_labeled": {
"additionalProperties": false,
"properties": {
"labels": {
"items": {
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"issue_opened": {
"additionalProperties": false,
"properties": {
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_assigned": {
"additionalProperties": false,
"properties": {
"assignees": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_comment": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"comment_types": {
"items": {
"enum": [
"timeline_comment",
"review_comment"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"comment_types"
],
"type": "object"
},
"pull_request_labeled": {
"additionalProperties": false,
"properties": {
"labels": {
"items": {
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_merge_conflict": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_merged": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_opened": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_ready_for_review": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_review_requested": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_review_submitted": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"states": {
"items": {
"enum": [
"approved",
"changes_requested",
"commented"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"states"
],
"type": "object"
},
"pull_request_synchronize": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"sub_issue_added": {
"additionalProperties": false,
"properties": {
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"workflow_run": {
"additionalProperties": false,
"properties": {
"conclusions": {
"items": {
"enum": [
"failure"
],
"type": "string"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"workflows": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"workflows",
"conclusions"
],
"type": "object"
}
},
"type": "object"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
}
}
},
"required": true
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"allowed_custom_agents": {
"items": {
"type": "string"
},
"type": "array"
},
"created_at": {
"format": "date-time",
"type": "string"
},
"created_by": {
"properties": {
"id": {
"format": "int64",
"type": "integer"
}
},
"type": "object"
},
"enabled": {
"type": "boolean"
},
"id": {
"type": "string"
},
"model": {
"type": "string"
},
"name": {
"type": "string"
},
"owner_type": {
"enum": [
"user",
"repository"
],
"readOnly": true,
"type": "string"
},
"prompt": {
"type": "string"
},
"reasoning_effort": {
"type": "string"
},
"require_actor_write_permission": {
"default": false,
"type": "boolean"
},
"tools": {
"items": {
"type": "string"
},
"type": "array"
},
"triggers": {
"additionalProperties": false,
"properties": {
"automation_completed": {
"additionalProperties": false,
"properties": {
"automation_ids": {
"items": {
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"automation_ids"
],
"type": "object"
},
"discussion_comment": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"categories": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"comment_types": {
"items": {
"enum": [
"comment",
"reply"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"discussion_opened": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"categories": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"discussion_updated": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"categories": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"interval": {
"additionalProperties": false,
"properties": {
"cadence": {
"items": {
"enum": [
"hourly",
"daily",
"weekly"
],
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"day_of_week": {
"maximum": 6,
"minimum": 0,
"type": "integer"
},
"hour_utc": {
"maximum": 23,
"minimum": 0,
"type": "integer"
},
"minute_utc": {
"default": 0,
"enum": [
0,
15,
30,
45
],
"type": "integer"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"cadence"
],
"type": "object"
},
"issue_assigned": {
"additionalProperties": false,
"properties": {
"assignees": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"issue_comment": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"issue_labeled": {
"additionalProperties": false,
"properties": {
"labels": {
"items": {
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"issue_opened": {
"additionalProperties": false,
"properties": {
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_assigned": {
"additionalProperties": false,
"properties": {
"assignees": {
"items": {
"type": "string"
},
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_comment": {
"additionalProperties": false,
"properties": {
"body_substring": {
"type": "string"
},
"comment_types": {
"items": {
"enum": [
"timeline_comment",
"review_comment"
],
"type": "string"
},
"maxItems": 2,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"comment_types"
],
"type": "object"
},
"pull_request_labeled": {
"additionalProperties": false,
"properties": {
"labels": {
"items": {
"type": "string"
},
"type": "array",
"uniqueItems": true
},
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_merge_conflict": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_merged": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_opened": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_ready_for_review": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_review_requested": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"pull_request_review_submitted": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"states": {
"items": {
"enum": [
"approved",
"changes_requested",
"commented"
],
"type": "string"
},
"maxItems": 3,
"minItems": 1,
"type": "array",
"uniqueItems": true
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"states"
],
"type": "object"
},
"pull_request_synchronize": {
"additionalProperties": false,
"properties": {
"paths": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"sub_issue_added": {
"additionalProperties": false,
"properties": {
"query": {
"minLength": 1,
"type": "string"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"type": "object"
},
"workflow_run": {
"additionalProperties": false,
"properties": {
"conclusions": {
"items": {
"enum": [
"failure"
],
"type": "string"
},
"maxItems": 1,
"minItems": 1,
"type": "array"
},
"query": {
"minLength": 1,
"type": "string"
},
"workflows": {
"items": {
"minLength": 1,
"type": "string"
},
"minItems": 1,
"type": "array"
},
"write_scope": {
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"workflows",
"conclusions"
],
"type": "object"
}
},
"type": "object"
},
"updated_at": {
"format": "date-time",
"type": "string"
},
"write_scope": {
"default": "trigger",
"enum": [
"trigger",
"repository"
],
"type": "string"
}
},
"required": [
"id",
"name",
"prompt",
"created_at",
"updated_at",
"created_by"
],
"type": "object"
}
}
}
},
"400": {
"content": {
"application/json": {
"schema": {
"properties": {
"documentation_url": {
"type": "string"
},
"errors": {
"items": {
"properties": {
"code": {
"enum": [
"missing",
"missing_field",
"invalid",
"already_exists",
"unprocessable",
"custom"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
}
},
"required": [
"message",
"documentation_url"
],
"type": "object"
}
}
}
},
"401": {
"content": {
"application/json": {
"schema": {
"properties": {
"documentation_url": {
"type": "string"
},
"errors": {
"items": {
"properties": {
"code": {
"enum": [
"missing",
"missing_field",
"invalid",
"already_exists",
"unprocessable",
"custom"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
}
},
"required": [
"message",
"documentation_url"
],
"type": "object"
}
}
}
},
"404": {
"content": {
"application/json": {
"schema": {
"properties": {
"documentation_url": {
"type": "string"
},
"errors": {
"items": {
"properties": {
"code": {
"enum": [
"missing",
"missing_field",
"invalid",
"already_exists",
"unprocessable",
"custom"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
}
},
"required": [
"message",
"documentation_url"
],
"type": "object"
}
}
}
},
"422": {
"content": {
"application/json": {
"schema": {
"properties": {
"documentation_url": {
"type": "string"
},
"errors": {
"items": {
"properties": {
"code": {
"enum": [
"missing",
"missing_field",
"invalid",
"already_exists",
"unprocessable",
"custom"
],
"type": "string"
},
"message": {
"type": "string"
}
},
"required": [
"code"
],
"type": "object"
},
"type": "array"
},
"message": {
"type": "string"
}
},
"required": [
"message",
"documentation_url"
],
"type": "object"
}
}
}
}
},
"tags": [
"agent-automations"
],
"x-github": {
"category": "agent-automations",
"enabledForGitHubApps": true,
"githubCloudOnly": false,
"subcategory": "agent-automations"
}
}
Monitored for you
Does this change affect your integration?
Choose the operations and fields your services use. Detektu matches GitHub findings to that declared usage so your team can review the relevant evidence. No agent or repository access required.