openstead
APIEndpoint referenceLogs

Read or tail service logs

Without after returns the newest retained batch in ascending numeric ID order. With after returns later lines in ascending ID order. Continue with response cursor; this is not opaque collection pagination. Retention depends on the plan, and search is limited to 200 characters.

Suggest a change

Kept in memory for this page. Requests go through this documentation site to the live Openstead API and can change your workspace. Use a read-only key to explore read operations.

GET
/workspaces/{workspaceId}/services/{serviceId}/logs

Without after returns the newest retained batch in ascending numeric ID order. With after returns later lines in ascending ID order. Continue with response cursor; this is not opaque collection pagination. Retention depends on the plan, and search is limited to 200 characters.

Authorization

AuthorizationBearer <token>

Workspace-scoped rnv_ API key. Read scope allows GET; write scope is additionally constrained by current membership, role, email verification, expiry and workspace MFA policy.

In: header

Path Parameters

workspaceId*string

Workspace UUID; it must match the bearer key scope.

Formatuuid
serviceId*string

Service UUID in this workspace.

Formatuuid

Query Parameters

after?integer

Numeric log cursor from the previous response.

Range0 <= value
Default0
limit?integer

Maximum lines per batch.

Range1 <= value <= 500
Default500
deployment?string

Filter by deployment in this service.

Formatuuid
source?string

Log source.

Value in

  • "build"
  • "runtime"
  • "system"
search?string

Case-insensitive message substring.

Lengthlength <= 200
hours?integer

Lookback window, clamped to at least one hour and the plan retention limit.

Default24

Header Parameters

X-Request-ID?string

Optional correlation identifier; invalid values are replaced. The accepted/generated value is returned in X-Request-ID and error body requestId. This is not an idempotency key.

Match^[A-Za-z0-9][A-Za-z0-9._-]*$
Lengthlength <= 64

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.openstead.tech/api/v1/workspaces/497f6eca-6276-4993-bfeb-53cbbbba6f08/services/497f6eca-6276-4993-bfeb-53cbbbba6f08/logs" \  -H "Authorization: Bearer <OPENSTEAD_API_KEY>"
{  "available": true,  "cursor": 42,  "hasMore": false,  "items": [    {      "id": 42,      "level": "info",      "message": "Application ready",      "source": "runtime",      "timestamp": "2026-09-25T12:00:00Z"    }  ],  "limit": 500}
Need a hand? Contact Openstead support.

Queue a rollback to a successful release POST

The source must be a live deployment of this service with a retained image. Reuses its configuration and encrypted secret snapshot to queue a new deployment. confirm is the service name. This is not an in-place status edit.

List masked variable metadata GET

Values are always null. Legacy requests without limit/cursor return all variables.