Request logs
One API or MCP request. IP addresses, user agents, headers and bodies are never included.
The request log object
Attributes
idstring (uuid)requiredIdentifier for this resource.
projectIdstring (uuid)requiredIdentifier of the Polymorfa project that owns this resource.
createdAtstring (date-time)requiredWhen the request was recorded.
methodstringrequiredHTTP method.
routestringrequiredMatched route pattern, for example
/messaging/:session/messages. Path values are not included.statusintegerrequirednullableHTTP response status.
durationMsintegerrequirednullableSpecifies duration ms for this management request log.
resultstringrequiredfailurefor any status of 400 or above.Allowed valuessuccessfailuresourcestringrequiredSpecifies source for this management request log.
Allowed valuesapimcprequestIdstringrequirednullableValue of the
X-Request-Idresponse header.traceIdstringrequirednullablepattern^[0-9a-f]{32}$W3C trace ID, also returned in the
X-Trace-Idresponse header. When you send a validtraceparentheader, this is your trace ID.errorCodestringrequirednullableError code from the response body of a failed request.
mcpToolstringrequirednullableMCP tool name for requests made through MCP.
credentialobjectrequirednullableCredential that made the request. Client tokens have no listed record, so their
idandlast4are null. Null when the key or token no longer exists.Show 3 child fields
{
"id": "00000000-0000-4000-8000-000000000000",
"projectId": "00000000-0000-4000-8000-000000000000",
"createdAt": "2026-09-22T12:00:00Z",
"method": "string",
"route": "string",
"status": 0,
"durationMs": 0,
"result": "success",
"source": "api",
"requestId": "string",
"traceId": "string",
"errorCode": "string",
"mcpTool": "string",
"credential": {
"type": "team_key",
"id": "00000000-0000-4000-8000-000000000000",
"last4": "string"
}
}List project request logs
- Base URL
https://api.polymorfa.com- Required permission
logs:read
Lists API and MCP requests made to the exact project in the route from the last 30 days. Without after, requests are newest first and page.nextCursor returns older requests. Pass page.followCursor as after to receive only newer requests, oldest first; this is how you tail the log. A request appears about two seconds after it completes. Reads of the request log are not listed.
Requires logs:read. Project tokens only access resources in their own project.
Path parameters
projectIdstring (uuid)requiredIdentifier of the Polymorfa project that owns this resource.
Query parameters
limitintegerrange1–100Requests per page, from 1 to 100.
Default25cursorstringlength1–2048page.nextCursorfrom an earlier page. Lists older requests with the same filters. Cannot be combined with filters orafter.afterstringlength1–2048page.followCursorfrom an earlier page. Lists newer requests, oldest first, with the same filters. Cannot be combined with filters orcursor.sincestring (date-time)Earliest request time. Requests older than 30 days are never listed.
untilstring (date-time)Latest request time.
statusstringpattern^[1-5]([0-9]{2}|[xX]{2})(,[1-5]([0-9]{2}|[xX]{2})){0,9}$Comma-separated HTTP status codes or classes, for example
404,5xx.methodstringpattern^(GET|POST|PUT|PATCH|DELETE)(,(GET|POST|PUT|PATCH|DELETE)){0,9}$Comma-separated HTTP methods, for example
POST,DELETE.routestringlength1–256Exact route pattern, for example
/messaging/:session/messages.sourcestringapifor direct API requests ormcpfor requests made through MCP.Allowed valuesapimcpcredentialIdstring (uuid)ID of the team API key or project token that made the request.
requestIdstringpattern^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$Request ID from the
X-Request-Idresponse header.traceIdstringpattern^[0-9a-fA-F]{32}$W3C trace ID from the
X-Trace-Idresponse header or your owntraceparent. Matched case-insensitively.
Responses
200Success
dataarray of objectrequiredStructured data carried by this object.
Show 14 child fields
pageobjectrequiredSpecifies page for this schema.
Show 3 child fields
Show 3 headers
400A path, query, or request-body value did not pass validation.
401Missing/invalid credential for this audience.
403Authenticated but lacks the required scope/role/audience.
404The requested resource was not found inside the authenticated team or project scope.
429A limit was reached. Wait for `Retry-After` before retrying.
curl "https://api.polymorfa.com/platform/projects/<projectId>/request-logs" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Polymorfa-Version: 2026-09-22"{
"data": [
{
"id": "00000000-0000-4000-8000-000000000000",
"projectId": "00000000-0000-4000-8000-000000000000",
"createdAt": "2026-09-22T12:00:00Z",
"method": "string",
"route": "string",
"status": 0,
"durationMs": 0,
"result": "success",
"source": "api",
"requestId": "string",
"traceId": "string",
"errorCode": "string",
"mcpTool": "string",
"credential": {
"type": "team_key",
"id": "00000000-0000-4000-8000-000000000000",
"last4": "string"
}
}
],
"page": {
"nextCursor": "string",
"hasMore": true,
"followCursor": "string"
}
}