Quickstart
Create an anonymous account, open a drive, and make your first authenticated request.
This quickstart creates a real free Yogfile account and a persistent drive. You only need
curl and jq.
Create an account
The complete account number is returned once. Save the response outside terminal history and move the credential to a password manager before deleting the file.
API=https://api.yogfile.com
curl -sS -X POST "$API/v2/accounts" > account.json
ACCOUNT=$(jq -r '.data.account_number' account.json)This is the account credential
Do not print the variable, paste it into a prompt, commit it, or send it to support. Yogfile cannot recover the complete number for you.
Start a session
Exchange the account credential for a 24-hour Bearer token. A device name makes the session easier to recognize and revoke later.
TOKEN=$(curl -sS -X POST "$API/v2/sessions" \
-H 'content-type: application/json' \
-d "{\"account_number\":\"$ACCOUNT\",\"device_name\":\"API quickstart\"}" \
| jq -r '.data.token')Create and list a drive
Mutating filesystem requests use an idempotency key. Reuse a key only when retrying the exact same operation.
curl -sS -X POST "$API/v2/drives" \
-H "authorization: Bearer $TOKEN" \
-H 'content-type: application/json' \
-H 'idempotency-key: quickstart-drive-v1' \
-d '{}'
curl -sS "$API/v2/drives" \
-H "authorization: Bearer $TOKEN" | jq '.data'Your drive receives a short stable ID. That ID is its initial name in native clients. A local alias can make it friendlier without changing which remote drive receives the writes.
Choose your client
- Install a desktop client for a filesystem inside Finder, File Explorer, or Linux.
- Connect an MCP agent without maintaining a custom integration.
- Continue with the HTTP API for direct uploads, sharing, realtime events, and lifecycle policy.