The builds.sr.ht API allows you to insert jobs, monitor their progress, and access some information about the build system. Authentication to this API is brokered by meta.sr.ht. This API uses standard sr.ht error responses. All requests should be submitted via https://builds.sr.ht.
The following endpoints are available to users with an OAuth key valid for the specified scope.
Scopes: jobs:write
Inserts a new job into the job queue.
{
"manifest": "string", The build manifest
"note": "string", Human-friendly description of this build
(markdown, optional)
"tags": [...], Arbitrary list of strings that identify this
build and can be used to navigate the
dashboard. Each string must use only
lowercase alphanumeric characters, or any
of "-_.:" (optional)
"access:read": [ List of users that have read access to this
job (optional). The user submitting the
build will be included regardless of this
value. The special username "*" indicates
public read access to this build.
Defaults to *.
"string" Username
],
"access:write": [ List of users that have write access to this
job (optional). The user submitting the
build will be included regardless of this
value.
"string" Username
],
"triggers": [...], Post-build triggers (optional)
"execute": boolean, True to start the build immediately
(optional - defaults to true)
"secrets": boolean, True to provide secrets during the build
(optional - defaults to true)
}See also: Build triggers
Gets information about a job by its ID.
Scopes: jobs:read
{
"id": integer,
"status": "job status enum",
"setup_log": "url", URL to captured stdout/stderr of setup
"tasks": [
{
"name": "setup",
"status": "task status enum"
"log": "url",
},
...
]
}Returns the original job's build manifest as plain text.
Starts a job that was created with execute=false. Returns an empty JSON
object when successful.
commit 10f7bc7fceb46f923e7392763a3502e020e1d422 Author: Drew DeVault <sir@cmpwn.com> Date: 2019-01-20T15:08:19 s/e.g./i.e./