Skip to main content
POST
Every wallet’s goals run on the agent loop and can use cases. List uploads are for one-off goals.
Stores a list for a goal that works through many units: offices to call, invoices to check, accounts to review. Pass the returned list_id as params.case_list when you create a goal:
The quote counts the list’s rows as the goal’s units. Once the goal starts, OneShot opens one case per row by itself, a batch at a time as earlier cases finish, so the goal’s agent never opens them. Each case’s record carries its row’s other columns as row.

Authentication

A signed write proof or an access token: see Authentication schemes.

Request body

The file itself, with ?key=<column> naming the column that names each case:
string
required
text/csv (a header row, then one row per unit) or application/x-ndjson (one JSON object per line).
Or JSON naming a Google Sheet read through your files connection: { "key": "office", "sheet": { "connection_id": "…", "file_id": "…", "sheet": "Tab name" } }. Limits: 10,000 rows, 5 MB, 100 columns, 4 KB of other columns per row, UTF-8. A key has no spaces and is at most 200 characters. A repeated key keeps its first row; the others are counted in duplicates_skipped. An unused list expires after 7 days; at most 20 wait at once.

Response

201 with list_id, rows, duplicates_skipped, columns, key_column, sample_keys and expires_at.

Errors