AdminGate2

Agents56

AI Applications29

AI Chat43

AI Gateway14

AI Gateway Admin12

AI Gateway Pricing1

AI Gateway Usage7

AI Provider Status3

Alarms12

Alerts6

Analytics43

Analytics Ingest Keys5

API Keys9

Audit Logs2

Authentication29

Autofixer7

Backups35

Blob6

Blob Management4

Cloud8

Containers8

Crons3

Custom Domains8

Dashboards5

Deployment Tokens6

Deployments25

DNS1

DNS Providers14

DNS Records4

Domains19

Email Domains12

Email Providers9

Email Tracking7

Email Validation1

Emails5

Environments2

error-alert-rules5

error-tracking10

Events13

External Images7

External Services49

External Services - Query11

Feature Flags9

Files1

Funnels7

GenAI2

geo2

Git Provider Connections3

Git Providers35

HTTP Checks12

Imports5

Insights1

Internal DNS2

IP Access Control6

KV Management4

KV Store7

Load Balancer5

Logs11

Metrics17

Nodes27

Notification Preferences4

Notification Providers15

Notification Routes7

Observability2

Operations1

OTel15

OTel Facets4

OTel Ingest6

Performance6

Platform6

Postgres Upgrades7

Presets2

Preview Gateway6

Projects46

Proxy Logs14

Public Repositories6

Repositories6

Restore6

Revenue16

Sandboxes39

Secrets7

sentry-compat6

sentry-ingestor3

Settings16

Snapshots5

source-maps8

Static Bundles4

Status Page27

Teams13

Telemetry2

Telemetry Logs1

Telemetry Metrics4

Templates3

Traces8

Traefik Discovery6

Traffic Delivery11

Users13

Visitor Activity5

Vulnerability Scans8

Webhook Deliveries3

Webhooks6

Workflows1

Logs

Search logs with structured filters and full text search

Changed on Oct 5, 2026

post/logs/search

Request

Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
URL: /api/logs/search
Auth: HTTP bearer

Request body

container_idsstring[]

Filter to specific containers (Docker container IDs). Empty = all containers. Drives "filter by container / show all" in a project's history, which spans multiple deployments and containers.

context_linesinteger nullable

grep -C: number of raw context lines to include before and after each match (0 = none, default). Clamped to 50 server-side. The surrounding lines ignore the level/text filters — they are the actual adjacent log lines, merged across overlapping matches.

cursorstring nullable

Pagination cursor

deploy_idinteger nullable

Filter by deployment ID (deployments.id)

end_timestring nullable

End of time range (ISO 8601). Defaults to now.

envsstring[]

Filter by environments

external_service_idinteger nullable

When set, search an imported/managed external service's logs instead of a project's. project_id is ignored in this mode.

levelsstring[]

Filter by log levels

node_idsinteger[]

Filter to specific worker nodes (node_id). Empty = all nodes, including control-plane-local logs.

page_sizeinteger nullable

Page size (default: 100, max: 500)

project_idinteger required

Project ID (integer, as used by the rest of the platform)

servicesstring[]

Filter by services

start_timestring nullable

Start of time range (ISO 8601). Defaults to 1 hour ago.

textstring nullable

Full text search query

Response

Search results

next_cursorstring nullable

Opaque keyset cursor for the next (older) page. Stays populated on a partial page — that's the whole point: the user can press Next to keep searching.

partialboolean

true when the store's time/byte budget ran out before this page could be proven complete.

scanned_back_tostring nullable

Set when partial is true: every chunk ending after this timestamp has been searched, nothing older has yet.

Changes

Oct 5, 20264b228ebed583 Revision changes
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property ///////// from the response with the status
- breaking
  removed the required property ///////// from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property // to the response with the status
Oct 5, 20261dc3e6788214 Revision changes
- breaking
  removed the required property ///////// from the response with the status
- breaking
  removed the required property ///////// from the response with the status
- breaking
  removed the required property // from the response with the status
- breaking
  removed the required property // from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- warning
  removed the optional property from the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property ///////// to the response with the status
- info
  added the required property // to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (3 revisions)