Skip to main content
Get canonical user-visible events for a specific job

Tool details

FieldValue
Nameget_job_events
GroupJobs

Playground

Input schema

Input schema
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    },
    "job_id": {
      "type": "string",
      "description": "Job ID"
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from a previous response"
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 1000,
      "description": "Maximum entries to return (default: 100, max: 1000)",
      "default": 100
    },
    "direction": {
      "type": "string",
      "enum": [
        "forward",
        "backward"
      ],
      "description": "Sort order (default: backward)",
      "default": "backward"
    }
  },
  "required": [
    "project_reference",
    "job_id"
  ],
  "additionalProperties": false,
  "description": "Input schema for the get_job_events tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Output schema

Output schema
{
  "type": "object",
  "properties": {
    "entries": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "timestamp": {
            "type": "string",
            "description": "The timestamp associated with this tool result."
          },
          "level": {
            "type": "string",
            "description": "The level associated with this tool result."
          },
          "message": {
            "type": "string",
            "description": "The message associated with this tool result."
          },
          "service": {
            "type": "string",
            "description": "The service associated with this tool result."
          },
          "trace_id": {
            "type": "string",
            "description": "The trace id associated with this tool result."
          },
          "request_id": {
            "type": "string",
            "description": "The request id associated with this tool result."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "type": "string",
              "description": "Additional structured values associated with this result."
            },
            "description": "Additional structured metadata returned by the tool."
          }
        },
        "required": [
          "timestamp",
          "level",
          "message",
          "service"
        ],
        "additionalProperties": false,
        "description": "One entry item associated with this tool result."
      },
      "description": "List of entries associated with this tool result."
    },
    "next_cursor": {
      "type": [
        "string",
        "null"
      ],
      "description": "The next cursor associated with this tool result."
    },
    "stats": {
      "type": "object",
      "properties": {
        "bytes_processed": {
          "type": "number",
          "description": "The bytes processed associated with this tool result."
        },
        "lines_processed": {
          "type": "number",
          "description": "The lines processed associated with this tool result."
        },
        "query_time_ms": {
          "type": "number",
          "description": "The query time ms associated with this tool result."
        }
      },
      "required": [
        "bytes_processed",
        "lines_processed",
        "query_time_ms"
      ],
      "additionalProperties": false,
      "description": "Structured stats details associated with this tool result."
    }
  },
  "required": [
    "entries",
    "next_cursor",
    "stats"
  ],
  "additionalProperties": false,
  "description": "Structured result returned by the get_job_events tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}