List logs
Returns workspace logs newest-first with cursor pagination. List rows never include raw request or response payloads. Follow meta.next_cursor to backfill every retained log.
Authorization
AuthorizationBearer <token>In header
Workspace API key, or a dashboard Clerk session.
Query Params
categoryOptionalstring
Filter by log category.
Valuespublishing | api_request | oauth | webhook | system
actionOptionalstring
Exact log action, for example post.publish.platform_failed.
sourceOptionalstring
Origin of the log.
Valuesapi | dashboard | worker | webhook | oauth
levelOptionalstring
Severity level.
Valuesdebug | info | warn | error
statusOptionalstring
Outcome status.
Valuessuccess | warning | error
platformOptionalstring
Platform token such as instagram, tiktok, youtube, or linkedin.
profile_idOptionalstring
Filter logs associated with one profile.
social_account_idOptionalstring
Filter logs associated with one connected account.
post_idOptionalstring
Filter logs associated with one post.
request_idOptionalstring
Filter logs associated with one API request.
error_codeOptionalstring
Filter logs by normalized error code.
qOptionalstring
Search message, action, request id, post id, and error code.
fromOptionalstring
RFC3339 timestamp. Inclusive lower bound. Defaults to 7 days ago — set it explicitly to backfill further.
toOptionalstring
RFC3339 timestamp. Inclusive upper bound.
limitOptionalinteger
Page size. Default 100, maximum 500.
cursorOptionalstring
Opaque cursor from the previous response's meta.next_cursor.
Response Body
200
dataarray
Log rows, newest first. Never includes request_payload or response_payload.
data[].idinteger
Numeric log id. Use it as after_id when switching to the stream.
data[].workspace_idstring
Owning workspace. Always your authenticated workspace.
data[].tsstring
RFC3339 event timestamp.
data[].levelstring
Severity level.
data[].statusstring
Outcome status.
data[].categorystring
Log category.
data[].actionstring
Specific log action.
data[].sourcestring
Origin of the log.
data[].messagestring
Human-readable summary.
data[].request_idstring
Correlates with the X-Request-Id of the originating API call.
data[].error_codestring
Normalized error code when the log represents a failure.
meta.limitinteger
Echoed page size.
meta.has_moreboolean
True when another page exists.
meta.next_cursorstring | null
Cursor for the next page, or null on the last page. meta.total is intentionally omitted.
401
error.codestring
Such as "UNAUTHORIZED" or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase alias such as "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
422
error.codestring
Such as "UNAUTHORIZED" or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase alias such as "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.
500
error.codestring
Such as "UNAUTHORIZED" or "VALIDATION_ERROR".
error.normalized_codestring
Lowercase alias such as "validation_error".
error.messagestring
Human-readable error message.
request_idstring
Request identifier for debugging and support.