APIs.io Engineering Platform · Schema
Workflow Run
An invocation of a workflow
APIs.ioEngineeringPlatform
Properties
| Name | Type | Description |
|---|---|---|
| id | integer | The ID of the workflow run. |
| name | string | The name of the workflow run. |
| node_id | string | |
| check_suite_id | integer | The ID of the associated check suite. |
| check_suite_node_id | string | The node ID of the associated check suite. |
| head_branch | string | |
| head_sha | string | The SHA of the head commit that points to the version of the workflow being run. |
| path | string | The full path of the workflow |
| run_number | integer | The auto incrementing run number for the workflow run. |
| run_attempt | integer | Attempt number of the run, 1 for first attempt and higher if the workflow was re-run. |
| referenced_workflows | array | |
| event | string | |
| status | string | |
| conclusion | string | |
| workflow_id | integer | The ID of the parent workflow. |
| url | string | The URL to the workflow run. |
| html_url | string | |
| pull_requests | array | Pull requests that are open with a `head_sha` or `head_branch` that matches the workflow run. The returned pull requests do not necessarily indicate pull requests that triggered the run. |
| created_at | string | |
| updated_at | string | |
| actor | object | |
| triggering_actor | object | |
| run_started_at | string | The start time of the latest run. Resets on re-run. |
| jobs_url | string | The URL to the jobs for the workflow run. |
| logs_url | string | The URL to download the logs for the workflow run. |
| check_suite_url | string | The URL to the associated check suite. |
| artifacts_url | string | The URL to the artifacts for the workflow run. |
| cancel_url | string | The URL to cancel the workflow run. |
| rerun_url | string | The URL to rerun the workflow run. |
| previous_attempt_url | string | The URL to the previous attempted run of this workflow, if one exists. |
| workflow_url | string | The URL to the workflow. |
| head_commit | object | |
| repository | object | |
| head_repository | object | |
| head_repository_id | integer | |
| display_title | string | The event-specific title associated with the run or the run-name if set, or the value of `run-name` if it is set in the workflow. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "#/components/schemas/workflow-run",
"title": "Workflow Run",
"description": "An invocation of a workflow",
"type": "object",
"properties": {
"id": {
"type": "integer",
"description": "The ID of the workflow run.",
"example": 5
},
"name": {
"type": "string",
"description": "The name of the workflow run.",
"nullable": true,
"example": "Build"
},
"node_id": {
"type": "string",
"example": "MDEwOkNoZWNrU3VpdGU1"
},
"check_suite_id": {
"type": "integer",
"description": "The ID of the associated check suite.",
"example": 42
},
"check_suite_node_id": {
"type": "string",
"description": "The node ID of the associated check suite.",
"example": "MDEwOkNoZWNrU3VpdGU0Mg=="
},
"head_branch": {
"type": "string",
"nullable": true,
"example": "master"
},
"head_sha": {
"description": "The SHA of the head commit that points to the version of the workflow being run.",
"example": "009b8a3a9ccbb128af87f9b1c0f4c62e8a304f6d",
"type": "string"
},
"path": {
"description": "The full path of the workflow",
"example": "octocat/octo-repo/.github/workflows/ci.yml@main",
"type": "string"
},
"run_number": {
"type": "integer",
"description": "The auto incrementing run number for the workflow run.",
"example": 106
},
"run_attempt": {
"type": "integer",
"description": "Attempt number of the run, 1 for first attempt and higher if the workflow was re-run.",
"example": 1
},
"referenced_workflows": {
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/referenced-workflow"
}
},
"event": {
"type": "string",
"example": "push"
},
"status": {
"type": "string",
"nullable": true,
"example": "completed"
},
"conclusion": {
"type": "string",
"nullable": true,
"example": "neutral"
},
"workflow_id": {
"type": "integer",
"description": "The ID of the parent workflow.",
"example": 5
},
"url": {
"type": "string",
"description": "The URL to the workflow run.",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5"
},
"html_url": {
"type": "string",
"example": "https://github.com/github/hello-world/suites/4"
},
"pull_requests": {
"description": "Pull requests that are open with a `head_sha` or `head_branch` that matches the workflow run. The returned pull requests do not necessarily indicate pull requests that triggered the run.",
"type": "array",
"nullable": true,
"items": {
"$ref": "#/components/schemas/pull-request-minimal"
}
},
"created_at": {
"type": "string",
"format": "date-time"
},
"updated_at": {
"type": "string",
"format": "date-time"
},
"actor": {
"$ref": "#/components/schemas/simple-user"
},
"triggering_actor": {
"$ref": "#/components/schemas/simple-user"
},
"run_started_at": {
"type": "string",
"format": "date-time",
"description": "The start time of the latest run. Resets on re-run."
},
"jobs_url": {
"description": "The URL to the jobs for the workflow run.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5/jobs"
},
"logs_url": {
"description": "The URL to download the logs for the workflow run.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5/logs"
},
"check_suite_url": {
"description": "The URL to the associated check suite.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/check-suites/12"
},
"artifacts_url": {
"description": "The URL to the artifacts for the workflow run.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5/rerun/artifacts"
},
"cancel_url": {
"description": "The URL to cancel the workflow run.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5/cancel"
},
"rerun_url": {
"description": "The URL to rerun the workflow run.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5/rerun"
},
"previous_attempt_url": {
"nullable": true,
"description": "The URL to the previous attempted run of this workflow, if one exists.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/runs/5/attempts/3"
},
"workflow_url": {
"description": "The URL to the workflow.",
"type": "string",
"example": "https://api.github.com/repos/github/hello-world/actions/workflows/main.yaml"
},
"head_commit": {
"$ref": "#/components/schemas/nullable-simple-commit"
},
"repository": {
"$ref": "#/components/schemas/minimal-repository"
},
"head_repository": {
"$ref": "#/components/schemas/minimal-repository"
},
"head_repository_id": {
"type": "integer",
"example": 5
},
"display_title": {
"type": "string",
"example": "Simple Workflow",
"description": "The event-specific title associated with the run or the run-name if set, or the value of `run-name` if it is set in the workflow."
}
},
"required": [
"id",
"node_id",
"head_branch",
"run_number",
"display_title",
"event",
"status",
"conclusion",
"head_sha",
"path",
"workflow_id",
"url",
"html_url",
"created_at",
"updated_at",
"head_commit",
"head_repository",
"repository",
"jobs_url",
"logs_url",
"check_suite_url",
"cancel_url",
"rerun_url",
"artifacts_url",
"workflow_url",
"pull_requests"
]
}