# Docs

- Start here
  - [AgentFS docs](/): Cloud file storage for agents. Upload, organize, share, and keep iterating on files through one API.
  - [Quickstart](/quickstart): Create an API key, upload a file, and read its hosted URL.
  - [Authentication](/authentication): Create an API key or connect an agent through the device authorization flow.
  - [Uploads](/uploads): Upload files up to 5 TB with one request, one upload URL, or resumable parts.
  - [Files](/files): Find files by path, tag, or run, read them back, update them in place, and delete them.
  - [Sharing](/sharing): Choose file visibility and create time-limited links for private files.
  - [Projects](/projects): Create projects, set their defaults, and manage their storage paths.
  - [Batch uploads](/batch): Upload several files in one multipart request and inspect each result.

  - **Agents**
  - [MCP](/mcp): Connect Claude Code, Cursor, or another MCP client to the hosted AgentFS server.
  - [MCP for agents](/mcp-keyless): Agents can upload files through MCP right away, with no API key or account. Add an API key for every tool.
  - [Agent skill](/agent-skill): Give an agent the AgentFS instructions for authentication, uploads, MCP, and file management.

  - **Reliability**
  - [Limits](/limits): Check plan storage, request rates, upload sizes, session counts, and batch limits before sending data.
  - [Errors](/errors): Handle AgentFS problem responses by status, code, detail, and retryability.
  - [Retries and recovery](/retries): Decide when an agent should retry, wait, repair its request, or stop.
- HTTP API guide
  - [API reference](/api): HTTP API endpoints for files, uploads, batches, projects, and agent authentication.
  - [Files](/api/files): Upload, list, read, delete, and share files through the file system API.
  - [Uploads](/api/uploads): Create and complete resumable multipart uploads.
  - [Batches](/api/batch): Upload several files in one multipart request and inspect the result.
  - [Events](/api/events): Poll the account event feed.
  - [Projects](/api/projects): Create and manage project settings and inspect project contents.
  - [Account](/api/account): Inspect the account associated with an API key.
  - [Device authorization](/api/device-auth): Connect an agent to an account without putting a user password in the agent.
- Api reference
  - [Get the current account](/api-reference/getAccount): Returns the authenticated account. Without a bearer key it reports the guest caller.
  - [List files](/api-reference/listFiles)
  - [Upload a file](/api-reference/uploadFile): Accepts an upload with an API key, or without one: a keyless upload is limited to 100 MB, is always unlisted, expires after 24 hours, and cannot set path, project, prefix, if_exists=replace, expires_in, label, or Idempotency-Key. Send Idempotency-Key with a key to make a lost response safe to retry.
  - [Get file metadata](/api-reference/getFile)
  - [Move or rename a file](/api-reference/moveFile)
  - [Delete a file](/api-reference/deleteFile)
  - [Get a file download URL](/api-reference/downloadFile)
  - [Create a temporary private-file URL](/api-reference/createAccessUrl)
  - [Revoke every private link issued for a file](/api-reference/revokeAccessUrls)
  - [Restore a file from the trash](/api-reference/restoreFile)
  - [Create a resumable upload](/api-reference/createUpload): Handles files up to 5 TB, and is required above 100 MiB. Files up to 5 GB get one upload_url unless the body sets multipart: true. Repeating an identical live request returns the existing session.
  - [Get an upload session](/api-reference/getUpload)
  - [Abort an upload](/api-reference/abortUpload)
  - [Upload one streamed part](/api-reference/uploadPart)
  - [Complete a resumable upload](/api-reference/completeUpload)
  - [Upload a batch of files](/api-reference/createBatch)
  - [Get a batch's progress and results](/api-reference/getBatch)
  - [List projects](/api-reference/listProjects)
  - [Create a project](/api-reference/createProject)
  - [Get a project](/api-reference/getProject)
  - [Update project settings](/api-reference/updateProject)
  - [Delete an empty project](/api-reference/deleteProject)
  - [List organization events](/api-reference/listEvents)
  - [Start device authorization](/api-reference/startDeviceAuthorization)
  - [Approve a device authorization request](/api-reference/approveDeviceAuthorization)
  - [Claim a device API key](/api-reference/claimDeviceToken)