--- title: "List events on alias-routed session" method: GET path: "/v2/agent_aliases/{alias_key}/sessions/{session_key}/events" tags: ["Agent Aliases"] --- # List events on alias-routed session `GET /v2/agent_aliases/{alias_key}/sessions/{session_key}/events` Lists events of a session originally created via this alias. ## Path parameters - `alias_key` string, required — The unique key that identifies an alias. Alias keys are independent of agent keys. The same string can exist as both an alias key and an agent key in the same customer account. Calls to `/v2/agent_aliases/{key}/...` target the alias. Calls to `/v2/agents/{key}/...` target the agent. - `session_key` string, required — A unique key that identifies an agent session. ## Query parameters - `limit` integer - `page_key` string ## Headers - `Request-Timeout` integer - `Request-Timeout-Millis` integer ## Response `200` Events on this session. - ListAgentEventsResponse — Response containing a list of agent events. - `events` AgentEvent[], required — List of agent events. - union — An event in an agent session conversation. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `messages` AgentInput[], required — List of inputs that make up this message. - union — An input that can be provided to an agent message. - AgentTextInput — A text input for an agent message. - … - AgentSkillInput — An input that invokes a skill by name. - … - `message_diffs` string[] — Opaque diffs against the raw event payload, one per produced agent message. Each diff captures the exact text sent to the model at emission time. When present, the array length MUST equal `messages.length`; a mismatched length is rejected. When absent, the platform reconstructs the rendering on read. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `skill_name` string, required — The name of the skill that was loaded. - `content` string, required — The skill content that was loaded. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `artifacts` ArtifactReference[], required — References to uploaded artifacts - `artifact_id` string, required — Unique identifier for the artifact - `filename` string, required — Original filename of the artifact - `mime_type` string, required — MIME type of the file - `size_bytes` integer, required — File size in bytes - `agent_upload_message` string — Frozen text of the single user-role agent message rendered for this artifact upload at emission time, capturing the artifact metadata and instruction block as one prompt. When absent the platform reconstructs the rendering on read using current templates. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `tool_call_id` string, required — The identifier for the tool call. - `tool_configuration_name` string, required — The name of the tool configuration being invoked, as defined in the agent's tool_configurations map. - `tool_name` string, required — Name of the tool being called. - `tool_input` object, required — Input data for the tool. - `argument_override_paths` string[] — Dot-notation leaf paths supplied by the tool configuration's argument overrides rather than by the agent — for example `api_key`, `config.auth.token`, or `items[0]`. These paths are frozen on the input event so that the agent's view of its own past tool calls stays stable when the tool configuration changes: overrides are excluded from replayed calls regardless of how the override has evolved since. Only the paths are frozen here; the resolved values at those paths are not — they are recomputed against the live session at each launch and recorded on the corresponding `ToolOutputEvent.resolved_argument_overrides`. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `tool_call_id` string, required — The unique identifier for the tool call, matching the input event. - `tool_configuration_name` string, required — The name of the tool configuration that was invoked, as defined in the agent's tool_configurations map. - `tool_name` string, required — Name of the tool that was called. - `resolved_argument_overrides` object — The values the tool configuration's argument overrides contributed to this call, keyed by the paths in `ToolInputEvent.argument_override_paths`. `$ref` overrides are resolved against the session — agent secrets, session metadata, and prior tool outputs — with secret values masked as `****`. Literal overrides appear as-is. Overlay these onto `ToolInputEvent.tool_input` at the matching paths to see exactly what the tool received. Absent when the tool short-circuits before running (for example, malformed arguments from the agent or an unresolved dependency). - `tool_output` object, required — Output data from the tool. - `output_wrapped` boolean — Whether `tool_output` is an envelope holding a non-object result: tools may return raw text, a number, or an array, which is stored as `{"content": }` so the event stays a JSON object. When true, the actual tool result is the value under `content`; when false or absent, `tool_output` is the tool's own object result. - `error` boolean, required — Whether the tool call resulted in an error. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `content` string — Human-readable content of the reasoning process. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `content` string, required — The complete agent response content. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `schema_name` string, required — The name of the JSON schema that the content conforms to. - `content` unknown, required - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `context_limit` integer — The maximum number of tokens allowed by the model - `actual_tokens` integer — The actual number of tokens in the request - `message` string, required — Human-readable error message - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `transition_limit` integer — The maximum number of step transitions allowed - `message` string, required — Human-readable error message - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - object — Event signaling there was an error with the request. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string — If the stream fails, the platform sends an event with type `error`. - `messages` string[] — The error messages. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `pending_calls` ClientToolPendingCall[], required — The client tool calls awaiting output, one entry per outstanding call. - `event_id` string, required — The `tool_input` event this call corresponds to. Submit the matching `tool_output` with this `event_id`. - `tool_configuration_name` string, required — The name of the tool configuration being invoked, as defined in the agent's tool_configurations map. - `tool_name` string, required — Name of the tool being called. - `arguments` object, required — The fully materialized arguments for this call: the agent-supplied arguments merged with the tool configuration's argument overrides and literals, with `$ref`s resolved against the session. Secret-derived values are delivered unmasked because the client needs them to execute the tool. This is exactly what the client should execute the tool with. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `artifact_id` string, required — The ID of the image artifact being loaded into the agent's conversation context. - `detail` 'auto' | 'low' | 'high' — Detail level for image processing. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `from_step` string, required — The name of the step being transitioned from. - `to_step` string, required — The name of the step being transitioned to. - `content` string, required — The handoff message content for the agent. - object — Base properties shared by all agent event types. - `id` string, required — The unique identifier for the event. - `session_key` string, required — A unique key that identifies an agent session. - `created_at` string, date-time, required — Timestamp when the event was created. - `type` string, required — The type of event. - `turns_compacted` integer, required — Number of conversation turns that were compacted. - `events_compacted` integer, required — Number of events that were hidden by compaction. - `summary_text` string — The plain text summary produced by compaction. - `summary_key` string, required — The key of the summary created by compaction. - `metadata` ListMetadata, required — The standard metadata in the response of a list operation. - `page_key` string — The page key for the next page of results. Pass it as a query parameter to request the next page. ## Other responses - `403` — Permissions do not allow listing events on this session. - `404` — Alias or session not found. --- [API](https://skmtc.net/vectara/apis/vectara-rest-api-v2.md) · [All operations](https://skmtc.net/vectara/apis/vectara-rest-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vectara/vectara-rest-api-v2/versions/e85040b266cc/schema)