Skip to main content
POST
Hand a file to a run so it can attach it to a page: at submit time, mid-run, or before its first step.

Authorizations

Authorization
string
header
required

An Outcrawl API key, ock_<keyId>.<secret>, minted in the console at https://outcrawl.ai/console/keys, or an OAuth access token, oat_..., issued by https://outcrawl.ai/api/auth with scope api (the CLI gets one from outcrawl login, an MCP client when it signs in).

Path Parameters

id
string
required

The id this route addresses.

Body

application/json

See the matching capability page under docs/app/ and the SDK reference for the exact fields this route accepts.

Response

Hand a file to a run so it can attach it to a page: at submit time, mid-run, or before its first step. Answers a HANDLE the agent uses with attachFile; you never send the bytes twice and the model never sees them. The file is destroyed when the run ends, on every ending. Use it for something the task needs to upload; not to fetch a file the run produced, because downloads do not exist.

See the matching capability page under docs/app/ and the SDK reference for the exact shape.