For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Go to Platform
HomeSDKs & toolsAPI referencePricing
  • API reference
      • GETSearch
      • POSTSearch
      • POSTContents
      • POSTResearch
      • POSTFinance Research
  • Error handling
    • Error code reference
        • GETLive News
        • GETImages
          • STREAMExpress Agent
          • STREAMCustom Agent
          • STREAMAdvanced Agent
LogoLogo
HomeSDKs & toolsAPI referencePricing
LogoLogo
Go to Platform
Custom solutionsAgents

Express Agent

Beta
|View as Markdown|Open in Claude|
POST
https://api.you.com/v1/agents/runs
POST
/v1/agents/runs
$curl -X POST https://api.you.com/v1/agents/runs \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "agent": "express",
>  "input": "What are some great recipes I can make in under half an hour",
>  "stream": true
>}'
This endpoint answers the user’s query with an LLM. Optionally, you can ground the answer using web results (max 1 web search). Use it for answering simple questions that require a low latency response. The data returns as SSE (Server-Side Events) with the `text/event-stream` content type in the response header. <Info> This call streams data as the agent responds.</Info>
Was this page helpful?
Built with

This endpoint answers the user’s query with an LLM. Optionally, you can ground the answer using web results (max 1 web search).

Use it for answering simple questions that require a low latency response.

The data returns as SSE (Server-Side Events) with the text/event-stream content type in the response header.

This call streams data as the agent responds.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.
agentenumRequired
Setting this value to "express" is mandatory to use the express agent.
Allowed values:
inputstringRequired
The question you'd like to ask the agent
streamtrueRequired

Must be set to true when you want to stream the express agent response as its being generated, and false when you want the response to return after the agent has finished.

toolslist of objectsOptional

You can optionally ground the express agent response using results fetched from the web (max 1 web search)

Response

response.createdobject
SSE event signifying the response stream has been created
OR
response.startingobject
SSE event signifying the response is starting
OR
response.output_item.addedobject
SSE event signifying an output item has been added
OR
response.output_content.fullobject
OR
response.output_item.doneobject
OR
response.output_text.deltaobject
OR
response.doneobject

Errors

400
Express Agent Runs Stream Request Bad Request Error
422
Express Agent Runs Stream Request Unprocessable Entity Error