Skip to content
Shortcut: /, ⌘K or Ctrl+K

Request logs

View as Markdown

One API or MCP request. IP addresses, user agents, headers and bodies are never included.

The request log object

Attributes

  • idstring (uuid)required

    Identifier for this resource.

  • projectIdstring (uuid)required

    Identifier of the Polymorfa project that owns this resource.

  • createdAtstring (date-time)required

    When the request was recorded.

  • methodstringrequired

    HTTP method.

  • routestringrequired

    Matched route pattern, for example /messaging/:session/messages. Path values are not included.

  • statusintegerrequirednullable

    HTTP response status.

  • durationMsintegerrequirednullable

    Specifies duration ms for this management request log.

  • resultstringrequired

    failure for any status of 400 or above.

    Allowed valuessuccessfailure
  • sourcestringrequired

    Specifies source for this management request log.

    Allowed valuesapimcp
  • requestIdstringrequirednullable

    Value of the X-Request-Id response header.

  • traceIdstringrequirednullablepattern^[0-9a-f]{32}$

    W3C trace ID, also returned in the X-Trace-Id response header. When you send a valid traceparent header, this is your trace ID.

  • errorCodestringrequirednullable

    Error code from the response body of a failed request.

  • mcpToolstringrequirednullable

    MCP tool name for requests made through MCP.

  • credentialobjectrequirednullable

    Credential that made the request. Client tokens have no listed record, so their id and last4 are null. Null when the key or token no longer exists.

    Show 3 child fields
The request log object
{
  "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

GET/platform/projects/{projectId}/request-logsPlatform API
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)required

    Identifier of the Polymorfa project that owns this resource.

Query parameters

  • limitintegerrange1–100

    Requests per page, from 1 to 100.

    Default 25
  • cursorstringlength1–2048

    page.nextCursor from an earlier page. Lists older requests with the same filters. Cannot be combined with filters or after.

  • afterstringlength1–2048

    page.followCursor from an earlier page. Lists newer requests, oldest first, with the same filters. Cannot be combined with filters or cursor.

  • 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–256

    Exact route pattern, for example /messaging/:session/messages.

  • sourcestring

    api for direct API requests or mcp for requests made through MCP.

    Allowed valuesapimcp
  • credentialIdstring (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-Id response header.

  • traceIdstringpattern^[0-9a-fA-F]{32}$

    W3C trace ID from the X-Trace-Id response header or your own traceparent. Matched case-insensitively.

Responses

  • 200Success
    • dataarray of objectrequired

      Structured data carried by this object.

      Show 14 child fields
    • pageobjectrequired

      Specifies 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.
GET /platform/projects/{projectId}/request-logscURL
curl "https://api.polymorfa.com/platform/projects/<projectId>/request-logs" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Polymorfa-Version: 2026-09-22"
Response
{
  "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"
  }
}