markifact-com Logs API
The Logs API from markifact-com — 2 operation(s) for logs.
The Logs API from markifact-com — 2 operation(s) for logs.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/markifact-com:markifact-com-logs-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Markifact Logs API
version: 1.0.0
description: API for managing Markifact workspace connections.
servers:
- url: https://api.markifact.com
security:
- bearerAuth: []
tags:
- name: Logs
paths:
/v1/logs:
get:
operationId: listLogs
summary: List logs
description: List your team's operation logs, newest first.
tags:
- Logs
parameters:
- name: source_type
in: query
required: false
schema:
type: string
enum:
- mcp
- agent
- workflow
description: Only return logs from this source. Omit for all sources.
- name: status
in: query
required: false
schema:
type: string
enum:
- success
- error
- skipped
- stop
- start
description: Only return logs with this status.
- name: operation_id
in: query
required: false
schema:
type: string
example: gads_get_campaigns
description: Exact operation ID to filter by.
- name: source_id
in: query
required: false
schema:
type: string
description: Only return logs from one MCP server, agent conversation, or workflow.
- name: source_run_id
in: query
required: false
schema:
type: string
description: Only return logs from a single workflow run.
- name: started_after
in: query
required: false
schema:
type: integer
format: int64
minimum: 0
description: Only return logs started at or after this Unix second. Cannot reach past your plan's history window.
- name: started_before
in: query
required: false
schema:
type: integer
format: int64
minimum: 0
description: Only return logs started at or before this Unix second.
- name: limit
in: query
required: false
schema:
type: integer
minimum: 1
maximum: 100
default: 25
description: Logs per page.
- name: cursor
in: query
required: false
schema:
type: string
description: The next_cursor from the previous page. Keep every other filter unchanged while paging.
responses:
'200':
description: Logs returned.
content:
application/json:
schema:
$ref: '#/components/schemas/LogPage'
'400':
description: Invalid cursor.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'401':
description: Invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/v1/logs/{log_id}:
get:
operationId: getLog
summary: Get log
description: Fetch a single log by ID.
tags:
- Logs
parameters:
- name: log_id
in: path
required: true
schema:
type: string
description: The log ID.
responses:
'200':
description: Log returned.
content:
application/json:
schema:
$ref: '#/components/schemas/Log'
'401':
description: Invalid API key.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Log not found, or older than your plan's history window.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
components:
schemas:
Log:
type: object
properties:
id:
type: string
description: Log ID.
operation_id:
type: string
example: gads_get_campaigns
description: Markifact operation that ran.
operation_version:
type:
- integer
- 'null'
status:
type: string
enum:
- success
- error
- skipped
- stop
- start
source:
$ref: '#/components/schemas/LogSource'
user:
$ref: '#/components/schemas/LogUser'
started_at:
type: integer
format: int64
example: 1784874174
description: Start time in Unix seconds.
completed_at:
type:
- integer
- 'null'
format: int64
description: Completion time in Unix seconds. Null while the operation is still running.
credits_used:
type: integer
cache_hit:
type: boolean
description: Whether the result came from cache instead of the provider.
input:
description: Input the operation ran with. Shape depends on the operation.
output:
description: Result the operation returned, or the error payload when status is error. Shape depends on the operation.
metadata:
type: object
additionalProperties: true
description: 'Extra context. Keys depend on the source: node_id, node_label, and retry_attempts for workflows, tool_name for MCP.'
required:
- id
- operation_id
- status
- source
- user
- started_at
- credits_used
- cache_hit
- metadata
LogSource:
type: object
properties:
type:
type: string
enum:
- mcp
- agent
- workflow
description: What ran the operation.
id:
type:
- string
- 'null'
description: 'Parent object ID: the MCP server, agent conversation, or workflow.'
run_id:
type:
- string
- 'null'
description: Single execution ID. Set on workflow logs, null otherwise.
name:
type:
- string
- 'null'
description: Current parent name, falling back to the name captured at log time if the parent was deleted.
required:
- type
Error:
type: object
properties:
detail: {}
LogUser:
type: object
properties:
id:
type:
- string
- 'null'
description: Markifact user ID.
email:
type:
- string
- 'null'
description: Email of the team member who ran the operation.
LogPage:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Log'
has_more:
type: boolean
description: Whether more logs match beyond this page.
next_cursor:
type:
- string
- 'null'
description: Pass back as `cursor` to fetch the next page. Null on the last page.
required:
- data
- has_more
securitySchemes:
bearerAuth:
type: http
scheme: bearer