CircleCI · Schema
BuildDetail
CI/CDContinuous IntegrationContinuous DeploymentDevOpsPipelinesWorkflowsDeveloper Tools
Properties
| Name | Type | Description |
|---|---|---|
| vcs_url | string | The VCS URL |
| build_url | string | URL to view the build in CircleCI |
| build_num | integer | The build number |
| branch | string | The branch that was built |
| vcs_revision | string | The VCS revision (commit SHA) |
| committer_name | string | Name of the committer |
| committer_email | string | Email of the committer |
| subject | string | The commit message subject |
| body | string | The commit message body |
| why | string | Why the build was triggered |
| status | string | The build status |
| outcome | string | The build outcome |
| start_time | string | When the build started |
| stop_time | string | When the build stopped |
| build_time_millis | integer | Total build time in milliseconds |
| queued_at | string | When the build was queued |
| lifecycle | string | The build lifecycle phase |
| username | string | The organization or username |
| reponame | string | The repository name |
| steps | array | Build steps |
| circle_yml | object | The parsed CircleCI configuration |
| messages | array | Build messages |
| node | array | Node information for SSH access |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/circleci/main/json-schema/circleci-build-detail-schema.json",
"title": "BuildDetail",
"x-generated": "2026-10-04",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/circleci-build-api-openapi.yml#/components/schemas/BuildDetail",
"allOf": [
{
"$ref": "#/$defs/Build"
},
{
"type": "object",
"properties": {
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The step name"
},
"actions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The action name"
},
"type": {
"type": "string",
"description": "The action type"
},
"status": {
"type": "string",
"description": "The action status"
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "When the action started"
},
"end_time": {
"type": "string",
"format": "date-time",
"description": "When the action ended"
},
"run_time_millis": {
"type": "integer",
"description": "Action run time in milliseconds"
},
"output_url": {
"type": "string",
"format": "uri",
"description": "URL to the action output"
}
}
},
"description": "Actions within the step"
}
}
},
"description": "Build steps"
},
"circle_yml": {
"type": "object",
"description": "The parsed CircleCI configuration"
},
"messages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Build messages"
},
"node": {
"type": "array",
"items": {
"type": "object",
"properties": {
"image_id": {
"type": "string",
"description": "The image ID used"
},
"port": {
"type": "integer",
"description": "The SSH port"
},
"public_ip_addr": {
"type": "string",
"description": "The public IP address"
},
"username": {
"type": "string",
"description": "The SSH username"
}
}
},
"description": "Node information for SSH access"
}
}
}
],
"$defs": {
"Build": {
"type": "object",
"properties": {
"vcs_url": {
"type": "string",
"format": "uri",
"description": "The VCS URL"
},
"build_url": {
"type": "string",
"format": "uri",
"description": "URL to view the build in CircleCI"
},
"build_num": {
"type": "integer",
"description": "The build number"
},
"branch": {
"type": "string",
"description": "The branch that was built"
},
"vcs_revision": {
"type": "string",
"description": "The VCS revision (commit SHA)"
},
"committer_name": {
"type": "string",
"description": "Name of the committer"
},
"committer_email": {
"type": "string",
"format": "email",
"description": "Email of the committer"
},
"subject": {
"type": "string",
"description": "The commit message subject"
},
"body": {
"type": "string",
"description": "The commit message body"
},
"why": {
"type": "string",
"description": "Why the build was triggered"
},
"status": {
"type": "string",
"enum": [
"retried",
"canceled",
"infrastructure_fail",
"timedout",
"not_run",
"running",
"failed",
"queued",
"scheduled",
"not_running",
"no_tests",
"fixed",
"success"
],
"description": "The build status"
},
"outcome": {
"type": "string",
"enum": [
"canceled",
"infrastructure_fail",
"timedout",
"failed",
"no_tests",
"success"
],
"description": "The build outcome"
},
"start_time": {
"type": "string",
"format": "date-time",
"description": "When the build started"
},
"stop_time": {
"type": "string",
"format": "date-time",
"description": "When the build stopped"
},
"build_time_millis": {
"type": "integer",
"description": "Total build time in milliseconds"
},
"queued_at": {
"type": "string",
"format": "date-time",
"description": "When the build was queued"
},
"lifecycle": {
"type": "string",
"enum": [
"queued",
"scheduled",
"not_run",
"not_running",
"running",
"finished"
],
"description": "The build lifecycle phase"
},
"username": {
"type": "string",
"description": "The organization or username"
},
"reponame": {
"type": "string",
"description": "The repository name"
}
}
}
}
}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/circleci-build-detail"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
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.