GitHub · Schema
Timeline Event
Timeline Event
CodeDeveloper ToolsPipelinesPlatformSoftware DevelopmentVersion ControlT1GitHubGit
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/github/main/json-schema/github-timeline-issue-events-schema.json",
"title": "Timeline Event",
"description": "Timeline Event",
"x-generated": "2026-10-03",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/github-issues-api-openapi.yml#/components/schemas/timeline-issue-events",
"type": "object",
"anyOf": [
{
"$ref": "#/$defs/labeled-issue-event"
},
{
"$ref": "#/$defs/unlabeled-issue-event"
},
{
"$ref": "#/$defs/milestoned-issue-event"
},
{
"$ref": "#/$defs/demilestoned-issue-event"
},
{
"$ref": "#/$defs/renamed-issue-event"
},
{
"$ref": "#/$defs/review-requested-issue-event"
},
{
"$ref": "#/$defs/review-request-removed-issue-event"
},
{
"$ref": "#/$defs/review-dismissed-issue-event"
},
{
"$ref": "#/$defs/locked-issue-event"
},
{
"$ref": "#/$defs/added-to-project-issue-event"
},
{
"$ref": "#/$defs/moved-column-in-project-issue-event"
},
{
"$ref": "#/$defs/removed-from-project-issue-event"
},
{
"$ref": "#/$defs/converted-note-to-issue-issue-event"
},
{
"$ref": "#/$defs/timeline-comment-event"
},
{
"$ref": "#/$defs/timeline-cross-referenced-event"
},
{
"$ref": "#/$defs/timeline-committed-event"
},
{
"$ref": "#/$defs/timeline-reviewed-event"
},
{
"$ref": "#/$defs/timeline-line-commented-event"
},
{
"$ref": "#/$defs/timeline-commit-commented-event"
},
{
"$ref": "#/$defs/timeline-assigned-issue-event"
},
{
"$ref": "#/$defs/timeline-unassigned-issue-event"
},
{
"$ref": "#/$defs/state-change-issue-event"
}
],
"$defs": {
"added-to-project-issue-event": {
"title": "Added to Project Issue Event",
"description": "Added to Project Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"project_card": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string",
"format": "uri"
},
"project_id": {
"type": "integer"
},
"project_url": {
"type": "string",
"format": "uri"
},
"column_name": {
"type": "string"
},
"previous_column_name": {
"type": "string"
}
},
"required": [
"id",
"url",
"project_id",
"project_url",
"column_name"
]
}
},
"required": [
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"author-association": {
"title": "author_association",
"type": "string",
"description": "How the author is associated with the repository.",
"enum": [
"COLLABORATOR",
"CONTRIBUTOR",
"FIRST_TIMER",
"FIRST_TIME_CONTRIBUTOR",
"MANNEQUIN",
"MEMBER",
"NONE",
"OWNER"
]
},
"commit-comment": {
"title": "Commit Comment",
"description": "Commit Comment",
"type": "object",
"properties": {
"html_url": {
"type": "string",
"format": "uri"
},
"url": {
"type": "string",
"format": "uri"
},
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"body": {
"type": "string"
},
"path": {
"type": [
"string",
"null"
]
},
"position": {
"type": [
"integer",
"null"
]
},
"line": {
"type": [
"integer",
"null"
]
},
"commit_id": {
"type": "string"
},
"user": {
"$ref": "#/$defs/nullable-simple-user"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"author_association": {
"$ref": "#/$defs/author-association"
},
"reactions": {
"$ref": "#/$defs/reaction-rollup"
}
},
"required": [
"url",
"html_url",
"id",
"node_id",
"user",
"position",
"line",
"path",
"commit_id",
"body",
"author_association",
"created_at",
"updated_at"
]
},
"converted-note-to-issue-issue-event": {
"title": "Converted Note to Issue Issue Event",
"description": "Converted Note to Issue Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/integration"
},
"project_card": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string",
"format": "uri"
},
"project_id": {
"type": "integer"
},
"project_url": {
"type": "string",
"format": "uri"
},
"column_name": {
"type": "string"
},
"previous_column_name": {
"type": "string"
}
},
"required": [
"id",
"url",
"project_id",
"project_url",
"column_name"
]
}
},
"required": [
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"demilestoned-issue-event": {
"title": "Demilestoned Issue Event",
"description": "Demilestoned Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"milestone": {
"type": "object",
"properties": {
"title": {
"type": "string"
}
},
"required": [
"title"
]
}
},
"required": [
"milestone",
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"integration": {
"title": "GitHub app",
"description": "GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.",
"type": "object",
"properties": {
"id": {
"description": "Unique identifier of the GitHub app",
"type": "integer"
},
"slug": {
"description": "The slug name of the GitHub app",
"type": "string"
},
"node_id": {
"type": "string"
},
"owner": {
"$ref": "#/$defs/nullable-simple-user"
},
"name": {
"description": "The name of the GitHub app",
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"external_url": {
"type": "string",
"format": "uri"
},
"html_url": {
"type": "string",
"format": "uri"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"permissions": {
"description": "The set of permissions for the GitHub app",
"type": "object",
"properties": {
"issues": {
"type": "string"
},
"checks": {
"type": "string"
},
"metadata": {
"type": "string"
},
"contents": {
"type": "string"
},
"deployments": {
"type": "string"
}
},
"additionalProperties": {
"type": "string"
}
},
"events": {
"description": "The list of events for the GitHub app",
"type": "array",
"items": {
"type": "string"
}
},
"installations_count": {
"description": "The number of installations associated with the GitHub app",
"type": "integer"
},
"client_id": {
"type": "string"
},
"client_secret": {
"type": "string"
},
"webhook_secret": {
"type": [
"string",
"null"
]
},
"pem": {
"type": "string"
}
},
"required": [
"id",
"node_id",
"owner",
"name",
"description",
"external_url",
"html_url",
"created_at",
"updated_at",
"permissions",
"events"
]
},
"issue": {
"title": "Issue",
"description": "Issues are a great way to keep track of tasks, enhancements, and bugs for your projects.",
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"node_id": {
"type": "string"
},
"url": {
"description": "URL for the issue",
"type": "string",
"format": "uri"
},
"repository_url": {
"type": "string",
"format": "uri"
},
"labels_url": {
"type": "string"
},
"comments_url": {
"type": "string",
"format": "uri"
},
"events_url": {
"type": "string",
"format": "uri"
},
"html_url": {
"type": "string",
"format": "uri"
},
"number": {
"description": "Number uniquely identifying the issue within its repository",
"type": "integer"
},
"state": {
"description": "State of the issue; either 'open' or 'closed'",
"type": "string"
},
"state_reason": {
"description": "The reason for the current state",
"type": [
"string",
"null"
],
"enum": [
"completed",
"reopened",
"not_planned"
]
},
"title": {
"description": "Title of the issue",
"type": "string"
},
"body": {
"description": "Contents of the issue",
"type": [
"string",
"null"
]
},
"user": {
"$ref": "#/$defs/nullable-simple-user"
},
"labels": {
"description": "Labels to associate with this issue; pass one or more label names to replace the set of labels on this issue; send an empty array to clear all labels from the issue; note that the labels are silently dropped for users without push access to the repository",
"type": "array",
"items": {
"oneOf": [
{
"type": "string"
},
{
"type": "object",
"properties": {
"id": {
"type": "integer",
"format": "int64"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"color": {
"type": [
"string",
"null"
]
},
"default": {
"type": "boolean"
}
}
}
]
}
},
"assignee": {
"$ref": "#/$defs/nullable-simple-user"
},
"assignees": {
"type": [
"array",
"null"
],
"items": {
"$ref": "#/$defs/simple-user"
}
},
"milestone": {
"$ref": "#/$defs/nullable-milestone"
},
"locked": {
"type": "boolean"
},
"active_lock_reason": {
"type": [
"string",
"null"
]
},
"comments": {
"type": "integer"
},
"pull_request": {
"type": "object",
"properties": {
"merged_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"diff_url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"html_url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"patch_url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri"
}
},
"required": [
"diff_url",
"html_url",
"patch_url",
"url"
]
},
"closed_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"draft": {
"type": "boolean"
},
"closed_by": {
"$ref": "#/$defs/nullable-simple-user"
},
"body_html": {
"type": "string"
},
"body_text": {
"type": "string"
},
"timeline_url": {
"type": "string",
"format": "uri"
},
"repository": {
"$ref": "#/$defs/repository"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"author_association": {
"$ref": "#/$defs/author-association"
},
"reactions": {
"$ref": "#/$defs/reaction-rollup"
}
},
"required": [
"assignee",
"closed_at",
"comments",
"comments_url",
"events_url",
"html_url",
"id",
"node_id",
"labels",
"labels_url",
"milestone",
"number",
"repository_url",
"state",
"locked",
"title",
"url",
"user",
"author_association",
"created_at",
"updated_at"
]
},
"labeled-issue-event": {
"title": "Labeled Issue Event",
"description": "Labeled Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"label": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"color": {
"type": "string"
}
},
"required": [
"name",
"color"
]
}
},
"required": [
"label",
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"locked-issue-event": {
"title": "Locked Issue Event",
"description": "Locked Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"lock_reason": {
"type": [
"string",
"null"
]
}
},
"required": [
"lock_reason",
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"milestoned-issue-event": {
"title": "Milestoned Issue Event",
"description": "Milestoned Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"milestone": {
"type": "object",
"properties": {
"title": {
"type": "string"
}
},
"required": [
"title"
]
}
},
"required": [
"milestone",
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"moved-column-in-project-issue-event": {
"title": "Moved Column in Project Issue Event",
"description": "Moved Column in Project Issue Event",
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"type": "string"
},
"actor": {
"$ref": "#/$defs/simple-user"
},
"event": {
"type": "string"
},
"commit_id": {
"type": [
"string",
"null"
]
},
"commit_url": {
"type": [
"string",
"null"
]
},
"created_at": {
"type": "string"
},
"performed_via_github_app": {
"$ref": "#/$defs/nullable-integration"
},
"project_card": {
"type": "object",
"properties": {
"id": {
"type": "integer"
},
"url": {
"type": "string",
"format": "uri"
},
"project_id": {
"type": "integer"
},
"project_url": {
"type": "string",
"format": "uri"
},
"column_name": {
"type": "string"
},
"previous_column_name": {
"type": "string"
}
},
"required": [
"id",
"url",
"project_id",
"project_url",
"column_name"
]
}
},
"required": [
"id",
"node_id",
"url",
"actor",
"event",
"commit_id",
"commit_url",
"created_at",
"performed_via_github_app"
]
},
"nullable-integration": {
"title": "GitHub app",
"description": "GitHub apps are a new way to extend GitHub. They can be installed directly on organizations and user accounts and granted access to specific repositories. They come with granular permissions and built-in webhooks. GitHub apps are first class actors within GitHub.",
"type": [
"object",
"null"
],
"properties": {
"id": {
"description": "Unique identifier of the GitHub app",
"type": "integer"
},
"slug": {
"description": "The slug name of the GitHub app",
"type": "string"
},
"node_id": {
"type": "string"
},
"owner": {
"$ref": "#/$defs/nullable-simple-user"
},
"name": {
"description": "The name of the GitHub app",
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"external_url": {
"type": "string",
"format": "uri"
},
"html_url": {
"type": "string",
"format": "uri"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"permissions": {
"description": "The set of permissions for the GitHub app",
"type": "object",
"properties": {
"issues": {
"type": "string"
},
"checks": {
"type": "string"
},
"metadata": {
"type": "string"
},
"contents": {
"type": "string"
},
"deployments": {
"type": "string"
}
},
"additionalProperties": {
"type": "string"
}
},
"events": {
"description": "The list of events for the GitHub app",
"type": "array",
"items": {
"type": "string"
}
},
"installations_count": {
"description": "The number of installations associated with the GitHub app",
"type": "integer"
},
"client_id": {
"type": "string"
},
"client_secret": {
"type": "string"
},
"webhook_secret": {
"type": [
"string",
"null"
]
},
"pem": {
"type": "string"
}
},
"required": [
"id",
"node_id",
"owner",
"name",
"description",
"external_url",
"html_url",
"created_at",
"updated_at",
"permissions",
"events"
]
},
"nullable-license-simple": {
"title": "License Simple",
"description": "License Simple",
"type": [
"object",
"null"
],
"properties": {
"key": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": [
"string",
"null"
],
"format": "uri"
},
"spdx_id": {
"type": [
"string",
"null"
]
},
"node_id": {
"type": "string"
},
"html_url": {
"type": "string",
"format": "uri"
}
},
"required": [
"key",
"name",
"url",
"spdx_id",
"node_id"
]
},
"nullable-milestone": {
"title": "Milestone",
"description": "A collection of related issues and pull requests.",
"type": [
"object",
"null"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"html_url": {
"type": "string",
"format": "uri"
},
"labels_url": {
"type": "string",
"format": "uri"
},
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"number": {
"description": "The number of the milestone.",
"type": "integer"
},
"state": {
"description": "The state of the milestone.",
"type": "string",
"enum": [
"open",
"closed"
],
"default": "open"
},
"title": {
"description": "The title of the milestone.",
"type": "string"
},
"description": {
"type": [
"string",
"null"
]
},
"creator": {
"$ref": "#/$defs/nullable-simple-user"
},
"open_issues": {
"type": "integer"
},
"closed_issues": {
"type": "integer"
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"closed_at": {
"type": [
"string",
"null"
],
"format": "date-time"
},
"due_on": {
"type": [
"string",
"null"
],
"format": "date-time"
}
},
"required": [
"closed_issues",
"creator",
"description",
"due_on",
"closed_at",
"id",
"node_id",
"labels_url",
"html_url",
"number",
"open_issues",
"state",
"title",
"url",
"created_at",
"updated_at"
]
},
"nullable-simple-user": {
"title": "Simple User",
"description": "A GitHub user.",
"type": [
"object",
"null"
],
"properties": {
"name": {
"type": [
"string",
"null"
]
},
"email": {
"type": [
"string",
"null"
]
},
"login": {
"type": "string"
},
"id": {
"type": "integer"
},
"node_id": {
"type": "string"
},
"avatar_url": {
"type": "string",
"format": "uri"
},
"gravatar_id": {
"type": [
"string",
"null"
]
},
"url": {
"type": "string",
"format": "uri"
},
"html_url": {
"type": "string",
"format": "uri"
},
"followers_url": {
"type": "string",
"format": "uri"
},
"following_url": {
"type": "string"
},
"gists_url": {
"type": "string"
},
"starred_url": {
"type": "string"
},
"subscriptions_url": {
"type": "string",
"format": "uri"
},
"organizations_url": {
"type": "string",
"format": "uri"
},
"repos_url": {
"type": "string",
"format": "uri"
},
"events_url": {
"type": "string"
},
"received_events_url": {
"type": "string",
"format": "uri"
},
"type": {
"type": "string"
},
"site_admin": {
"type": "boolean"
},
"starred_at": {
"type": "string"
}
},
"required": [
"avatar_url",
"events_url",
"followers_url",
"following_url",
"gists_url",
"gravatar_id",
"html_url",
"id",
"node_id",
"login",
"organizations_url",
"received_events_url",
"repos_url",
"site_admin",
"starred_url",
"subscriptions_url",
"type",
"url"
]
},
"nullable-team-simple": {
"title": "Team Simple",
"description": "Groups of organization members that gives permissions on specified repositories.",
"type": [
"object",
"null"
],
"properties": {
"id": {
"description": "Unique identifier of the team",
"type": "integer"
},
"node_id": {
"type": "string"
},
"url": {
"description": "URL for the team",
"type": "string",
"format": "uri"
},
"members_url": {
"type": "string"
},
"name": {
"description": "Name of the team",
"type": "string"
},
"description": {
"description": "Description of the team",
"type": [
"string",
"null"
]
# --- truncated at 32 KB (78 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/github/refs/heads/main/json-schema/github-timeline-issue-events-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/github-timeline-issue-events"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.