Quickstart

Connect an account

1. Open agentfs.cloud, sign in, open a project, and open API Keys.
2. Select Create key.
3. Store the secret when it appears. AgentFS shows it only once.

Set the key in your shell, then upload. The file goes into the key's project:

export AGENTFS_KEY="afs_..."

curl -sS -X POST https://agentfs.cloud/v1/files \
  -H "Authorization: Bearer $AGENTFS_KEY" \
  -F "file=@./report.pdf" \
  -F "prefix=research"

The authenticated response uses the same file object shape. The file lands in research/ inside the key's project. Use Authentication, Uploads, and Files for the rest of the API.