Skip to main content
GET
List logs
Returns one log per operation your team ran, newest first, whatever produced it: a workflow node, an MCP tool call, or an agent step. API keys can only be created by team owners, so a key sees every log the team wrote, including operations run by other members and through private MCP servers. How far back you can read depends on your plan’s history window. Logs outside that window are not returned even though Markifact still stores them.

Endpoint

Query Parameters

Example Request

Response

Pagination

Read next_cursor from the response and pass it back as cursor to get the next page. When has_more is false, next_cursor is null and you have reached the end.
Keep every other parameter identical while paging. The cursor marks a position in the ordered result set, not the query that produced it, so changing a filter mid-walk gives you a page that does not line up with the previous one. Treat the cursor as opaque. Its contents are internal and can change.

Log Object

Source Object

Timestamps in this resource are Unix seconds. Connection timestamps are in milliseconds.

Reconstructing a Workflow Run

A workflow writes one log per node, all sharing a source_run_id. To pull a whole run in order, filter by it:
Logs come back newest first, so reverse them to read the run in execution order. A run that failed before any node executed, for example when the team ran out of credits, produces no logs at all.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

source_type
enum<string>

Only return logs from this source. Omit for all sources.

Available options:
mcp,
agent,
workflow
status
enum<string>

Only return logs with this status.

Available options:
success,
error,
skipped,
stop,
start
operation_id
string

Exact operation ID to filter by.

Example:

"gads_get_campaigns"

source_id
string

Only return logs from one MCP server, agent conversation, or workflow.

source_run_id
string

Only return logs from a single workflow run.

started_after
integer<int64>

Only return logs started at or after this Unix second. Cannot reach past your plan's history window.

Required range: x >= 0
started_before
integer<int64>

Only return logs started at or before this Unix second.

Required range: x >= 0
limit
integer
default:25

Logs per page.

Required range: 1 <= x <= 100
cursor
string

The next_cursor from the previous page. Keep every other filter unchanged while paging.

Response

Logs returned.

data
object[]
required
has_more
boolean
required

Whether more logs match beyond this page.

next_cursor
string | null

Pass back as cursor to fetch the next page. Null on the last page.