52 lines
915 B
Markdown
52 lines
915 B
Markdown
# Jobs
|
|
|
|
<aside class="notice">
|
|
|
|
All routes in this section require authentication.
|
|
|
|
</aside>
|
|
|
|
## Manually schedule a job
|
|
|
|
```shell
|
|
curl \
|
|
-H 'X-Api-Key: secret' \
|
|
https://example.com/api/v1/jobs/queue?target=10&force&arch=x86_64
|
|
```
|
|
|
|
Manually schedule a job on the server.
|
|
|
|
### HTTP Request
|
|
|
|
`POST /api/v1/jobs/queue`
|
|
|
|
### Query Parameters
|
|
|
|
Parameter | Description
|
|
--------- | -----------
|
|
target | Id of target to schedule build for
|
|
arch | Architecture to build on
|
|
force | Whether it's a forced build (true if present)
|
|
|
|
## Poll for new jobs
|
|
|
|
<aside class="warning">
|
|
|
|
This endpoint is used by the agents and should not be used manually. It's just
|
|
here for completeness.
|
|
|
|
</aside>
|
|
|
|
Poll the server for new builds.
|
|
|
|
### HTTP Request
|
|
|
|
`GET /api/v1/jobs/poll`
|
|
|
|
### Query Parameters
|
|
|
|
Parameter | Description
|
|
--------- | -----------
|
|
arch | For which architecture to receive jobs
|
|
max | How many jobs to receive at most
|