Skip to content

Get Deployment Logs

GET
/api/deployments/{deployment_id}/logs
curl --request GET \
--url 'https://example.com/api/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/logs?organization_id=2489E9AD-2EE2-8E00-8EC9-32D5F69181C0&page=1&page_size=100' \
--header 'Authorization: Bearer <token>'

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.

deployment_id
required
Deployment Id
string format: uuid
organization_id
required
Organization Id
string format: uuid
page
Page
integer
default: 1 >= 1
page_size
Page Size
integer
default: 100 >= 1 <= 500
level
Any of:
string

Successful Response

Media type application/json
Response Get Deployment Logs Api Deployments Deployment Id Logs Get
object
key
additional properties
any
Example generated
{}

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Example generated
{
"detail": [
{
"ctx": {},
"input": "example",
"loc": [
"example"
],
"msg": "example",
"type": "example"
}
]
}