Core Exports

import { Agent, Runflow, openai, anthropic, bedrock } from '@runflow-ai/sdk';

AgentInput.request

When an agent is invoked via the direct HTTP Agent API, the platform auto-injects the raw HTTP request context on input.request: method, sub-path, path segments, body, headers, query and cookies. Use it to read custom headers or query params, or to expose several endpoints from one agent (see HTTP Routing). Header names arrive in canonical form, and header and query values are arrays:

export async function main(input: AgentInput) {
  const traceId = input.request?.headers?.['X-Trace-Id']?.[0];
  const lang    = input.request?.query?.lang?.[0] ?? 'pt-BR';

  if (input.request?.params?.[0] === 'health') return { ok: true };
  // ...
}

input.request is not populated for webhook-triggered invocations (the payload lives in metadata instead), scheduled jobs, or direct SDK calls. Always guard access with optional chaining. See Core Types → AgentInput for the full field list.

Overview

Main Exports

TypeScript Types

Runtime REST API

Core Exports

Core Exports

AgentInput.request

Next Steps

Tools & Connectors

Workflows

​Core Exports

​AgentInput.request

​Next Steps

Tools & Connectors

Workflows

Core Exports

AgentInput.request

Next Steps