Fonts
GET /v1/fonts
Section titled “GET /v1/fonts”Lists the fonts LibreOffice and the PDF stage can use.
Needs credentials, if any are configured.
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
| 200 | The loaded fonts | array of FontSchema |
POST /v1/fonts
Section titled “POST /v1/fonts”Stores fonts for every caller and every replica: a ZIP of TTF, OTF or TTC files,
or one such file. Takes an admin. They are in use on this replica when this
returns, and on the others within syncIntervalSeconds.
Needs credentials, if any are configured.
Request
Section titled “Request”multipart/form-data
| Field | Type | Required | Description |
|---|---|---|---|
file |
file | Yes | A ZIP of TTF, OTF or TTC files, or one such file. |
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
| 201 | Stored | FontsStored |
| 400 | Not fonts, or too large | ErrorBody |
| 403 | Needs an admin, or the store is full | ErrorBody |
| 501 | RUSTICDOC_STORE is not set | ErrorBody |
| 503 | The store cannot be reached | ErrorBody |
DELETE /v1/fonts/{id}
Section titled “DELETE /v1/fonts/{id}”Deletes a stored font. Takes an admin. It leaves this replica when this returns, and the others within the sync interval. Documents that name it fall back to another font.
Needs credentials, if any are configured.
Parameters
Section titled “Parameters”| Name | In | Required | Description |
|---|---|---|---|
id |
path | Yes | The font’s id, from GET /v1/fonts |
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
| 204 | Deleted | |
| 403 | Needs an admin | ErrorBody |
| 404 | No such stored font | ErrorBody |
| 501 | RUSTICDOC_STORE is not set | ErrorBody |
| 503 | The store cannot be reached | ErrorBody |
POST /v1/fonts/reload
Section titled “POST /v1/fonts/reload”Rescans the fonts directory and restarts idle LibreOffice workers, so a new font needs no container restart. Busy workers restart after their current job.
Needs credentials, if any are configured.
Responses
Section titled “Responses”| Status | Meaning | Body |
|---|---|---|
| 200 | What is loaded now | Reloaded |
| 429 | Reloaded moments ago | ErrorBody |
| 503 | A worker could not restart | ErrorBody |