Menu
Platform
AI
App store purchases
Credits
Database
Flags
Generated Assets
Jobs and cron
Localization
Monitoring
Notifications
Payments
Sandboxes
Webhooks
Getting Started
Authentication
KV Store
Deploy & Infrastructure
Reference
On this page
Read logs on a build
Reads a page of a build's log lines, oldest first.
Reads a page of a build's log lines, oldest first. With wait, an empty page on a running build waits up to that long for new lines, so a client follows the log by passing each next_page_token back.
Not available yet. Sylphx Build is declared in the registry but no backend serves it: every call answers 501 with the problem code UNIMPLEMENTED.
- Path
GET https://api.sylphx.com/v1/orgs/acme/projects/shop/builds/build:readLogs - Scope
build:read - Effect
read— nothing is written. - Collection builds
- Query
page_size,page_token,wait
#Request
| Field | Type | What it is |
|---|---|---|
name | string | The name of the build. Required. |
page_size | int32 | At most this many lines; default 500, clamped to 5000. |
page_token | string | next_page_token of the previous page. |
wait | duration | On a running build, wait up to this long (at most 30s) for new lines before returning an empty page. |
#Response
| Field | Type | What it is |
|---|---|---|
lines | BuildLogLine[] | The page, oldest first. |
next_page_token | string | The token of the next page. It is set while the build can still write, so a follower keeps polling; empty once the build is final and every line was read. |
#BuildLogLine
| Field | Type | What it is |
|---|---|---|
write_time | timestamp | When the line was written. Output only. |
stream | string | stdout or stderr. Output only. |
text | string | The line, without its trailing newline. Output only. |
#Errors
UNAUTHENTICATED— No valid key or token was presented.PERMISSION_DENIED— The key lacks the method's permission.RESOURCE_NOT_FOUND— The named Resource does not exist or is not visible.PAGE_TOKEN_MISMATCH— A page token was reused with different parameters.
Every error arrives in the body Errors describes.
#Examples
curl "https://api.sylphx.com/v1/orgs/acme/projects/shop/builds/build:readLogs" \
-H "Authorization: Bearer $SYLPHX_API_KEY"