curl -X POST "https://win.oneshotagent.com/v1/compute/lists?key=office" \
-H "Content-Type: text/csv" \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope write>" \
--data-binary @offices.csv
{
"list_id": "5d0c4c7e-2f71-4d38-9a43-0b2b4b8f6a51",
"format": "csv",
"key_column": "office",
"columns": ["office", "city", "phone"],
"rows": 2480,
"duplicates_skipped": 3,
"sample_keys": ["austin-01", "austin-02", "boise-01"],
"expires_at": "2026-11-10T12:00:00.000Z"
}
Working with a goal
Upload a list
Upload up to 10,000 units for a goal; each row opens one case
POST
/
v1
/
compute
/
lists
curl -X POST "https://win.oneshotagent.com/v1/compute/lists?key=office" \
-H "Content-Type: text/csv" \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope write>" \
--data-binary @offices.csv
{
"list_id": "5d0c4c7e-2f71-4d38-9a43-0b2b4b8f6a51",
"format": "csv",
"key_column": "office",
"columns": ["office", "city", "phone"],
"rows": 2480,
"duplicates_skipped": 3,
"sample_keys": ["austin-01", "austin-02", "boise-01"],
"expires_at": "2026-11-10T12:00:00.000Z"
}
Every wallet’s goals run on the agent loop and can use cases. List uploads are for one-off goals.
list_id as params.case_list when you create a goal:
{ "params": { "case_list": { "list_id": "5d0c4c7e-2f71-4d38-9a43-0b2b4b8f6a51" } } }
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:
text/csv (a header row, then one row per unit) or application/x-ndjson (one JSON object per line).{ "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.
curl -X POST "https://win.oneshotagent.com/v1/compute/lists?key=office" \
-H "Content-Type: text/csv" \
-H "X-Agent-ID: 0xYourWalletAddress" \
-H "x-agent-proof: <base64 EIP-712 proof, scope write>" \
--data-binary @offices.csv
{
"list_id": "5d0c4c7e-2f71-4d38-9a43-0b2b4b8f6a51",
"format": "csv",
"key_column": "office",
"columns": ["office", "city", "phone"],
"rows": 2480,
"duplicates_skipped": 3,
"sample_keys": ["austin-01", "austin-02", "boise-01"],
"expires_at": "2026-11-10T12:00:00.000Z"
}
Errors
| Status | error | Meaning |
|---|---|---|
400 | invalid_list, invalid_header, invalid_row, invalid_key, row_too_large, too_many_rows | The message names the line. |
400 | key_column_missing | No such column, or no key. |
400 | invalid_encoding | Not UTF-8 text. |
413 | list_too_large | Over 5 MB. |
415 | unsupported_media_type | Not CSV, JSONL or JSON. |
429 | list_storage_limit | 20 lists wait for a goal. |