Request logs

List project request logs

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.

GET

platform

projects

{projectId}

request-logs

List project request logs

curl --request GET \
  --url https://api.polymorfa.com/platform/projects/{projectId}/request-logs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.polymorfa.com/platform/projects/{projectId}/request-logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.polymorfa.com/platform/projects/{projectId}/request-logs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polymorfa.com/platform/projects/{projectId}/request-logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z",
      "method": "<string>",
      "route": "<string>",
      "status": 123,
      "durationMs": 123,
      "result": "success",
      "source": "api",
      "requestId": "<string>",
      "traceId": "<string>",
      "errorCode": "<string>",
      "mcpTool": "<string>",
      "credential": {
        "type": "team_key",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "last4": "<string>"
      }
    }
  ],
  "page": {
    "nextCursor": "<string>",
    "hasMore": true,
    "followCursor": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

Authorizations

Authorization

string

header

required

Send your team API key or project token as Authorization: Bearer <token>. The credential must have the required permissions. Project tokens can access only their own project.

Path Parameters

projectId

string<uuid>

required

Identifier of the Polymorfa project that owns this resource.

Value constraints

Constraint	Accepted input
Format	`uuid`

Query Parameters

limit

integer

default:25

Requests per page, from 1 to 100.

Value constraints

Constraint	Accepted input
Numeric value	`1` through `100` (inclusive)

Required range: 1 <= x <= 100

cursor

string

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

Value constraints

Constraint	Accepted input
String length	`1` through `2048` characters

Required string length: 1 - 2048

after

string

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

Value constraints

Constraint	Accepted input
String length	`1` through `2048` characters

Required string length: 1 - 2048

since

string<date-time>

Earliest request time. Requests older than 30 days are never listed.

Value constraints

Constraint	Accepted input
Format	`date-time`

until

string<date-time>

Latest request time.

Value constraints

Constraint	Accepted input
Format	`date-time`

status

string

Comma-separated HTTP status codes or classes, for example 404,5xx.

Value constraints

Constraint	Accepted input
Pattern	`^[1-5]([0-9]{2}\|[xX]{2})(,[1-5]([0-9]{2}\|[xX]{2})){0,9}$`

Pattern: ^[1-5]([0-9]{2}|[xX]{2})(,[1-5]([0-9]{2}|[xX]{2})){0,9}$

method

string

Comma-separated HTTP methods, for example POST,DELETE.

Value constraints

Constraint	Accepted input
Pattern	`^(GET\|POST\|PUT\|PATCH\|DELETE)(,(GET\|POST\|PUT\|PATCH\|DELETE)){0,9}$`

Pattern: ^(GET|POST|PUT|PATCH|DELETE)(,(GET|POST|PUT|PATCH|DELETE)){0,9}$

route

string

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

Value constraints

Constraint	Accepted input
String length	`1` through `256` characters

Required string length: 1 - 256

source

enum<string>

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

Allowed values

Value	Meaning
`api`	Api.
`mcp`	Mcp.

Available options:

api,

mcp

credentialId

string<uuid>

ID of the team API key or project token that made the request.

Value constraints

Constraint	Accepted input
Format	`uuid`

requestId

string

Request ID from the X-Request-Id response header.

Value constraints

Constraint	Accepted input
Pattern	`^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$`

Pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$

traceId

string

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

Value constraints

Constraint	Accepted input
Pattern	`^[0-9a-fA-F]{32}$`

Pattern: ^[0-9a-fA-F]{32}$

Response

Success

data

object[]

required

Structured data carried by this object.

Show child attributes

page

object

required

Specifies page for this schema.

Show child attributes

List project request logs

curl --request GET \
  --url https://api.polymorfa.com/platform/projects/{projectId}/request-logs \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.polymorfa.com/platform/projects/{projectId}/request-logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.polymorfa.com/platform/projects/{projectId}/request-logs"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.polymorfa.com/platform/projects/{projectId}/request-logs"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "projectId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "2023-11-07T05:31:56Z",
      "method": "<string>",
      "route": "<string>",
      "status": 123,
      "durationMs": 123,
      "result": "success",
      "source": "api",
      "requestId": "<string>",
      "traceId": "<string>",
      "errorCode": "<string>",
      "mcpTool": "<string>",
      "credential": {
        "type": "team_key",
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "last4": "<string>"
      }
    }
  ],
  "page": {
    "nextCursor": "<string>",
    "hasMore": true,
    "followCursor": "<string>"
  }
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

{
  "error": {
    "type": "invalid_request_error",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "request_id": "<string>",
    "request_log_url": "<string>"
  },
  "data": null,
  "docs": "<string>"
}

Overview

Messaging API

Platform API

Graph API

Webhook events

List project request logs

Authorizations

Path Parameters

Query Parameters

Response