Skip to content

Get Deployment Logs

GET
/api/deployments/{deployment_id}/logs

Retrieve paginated deployment logs for a given deployment.

Returns log entries ordered by timestamp ASC. Optionally filter by log level (INFO / WARN / ERROR / DEBUG).

Args: deployment_id: UUID of the deployment to fetch logs for. organization_id: UUID of the organization that must own the firmware. page: 1-based page number (default 1). page_size: Number of rows per page (default 100, max 500). level: Optional log-level filter (e.g. ERROR). Case-insensitive. organization: Resolved org from org_member dependency. db: Async SQLAlchemy session.

Returns: Paginated envelope: { items, total, page, page_size }. Each item contains { id, timestamp, level, message }.

Raises: HTTPException 404 if the deployment does not exist or is not owned by the given organisation.

Authorizations

Parameters

Path Parameters

deployment_id
required
string format: uuid

Query Parameters

organization_id
required
string format: uuid
page
integer
default: 1 >= 1
page_size
integer
default: 100 >= 1 <= 500
level
Any of:
string

Responses

200

Successful Response

object

422

Validation Error

object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string