Skip to main content
GET
Search deployment history logs

Authorizations

x-brimble-key
string
header
required

API key created in the dashboard under Settings → API keys. Each key carries permission scopes; every endpoint lists the scope it needs.

Path Parameters

projectId
string
required

ID of the project.

Pattern: ^[a-fA-F0-9]{24}$

Query Parameters

Only return deployments whose name, commit message, branch, SHA or author contains this text.

Maximum string length: 120
limit
integer

Deployments per page. Defaults to 10.

Required range: 1 <= x <= 100
page
integer

Page to return, starting at 1.

Required range: x >= 1
filterBy
enum<string>

Field to sort by, newest first: createdAt (default), startTime, endTime or status.

Available options:
createdAt,
startTime,
endTime,
status
statuses
string

Comma-separated deployment statuses to include, for example FAILED,ACTIVE.

environment
string

Only return deployments in this environment: PRODUCTION or PREVIEW.

start
string<date-time>

Only return deployments created on or after this date (ISO 8601). Defaults to 30 days ago.

end
string<date-time>

Only return deployments created on or before this date (ISO 8601). Defaults to today.

Response

Deployment history logs fetched successfully

message
string
required

Human-readable result of the request.

Example:

"Deployment history logs fetched successfully"

data
object
required

The result of the request.

Last modified on October 11, 2026