FOR YOUR AGENT

Connect your agent.

Let your agent upload the file and bring back a download link. Recipients don’t need an account.

Get your access token. During the private preview, ask the owner for one. Self-service sign-in is coming.
Give your agent the details below. It will guide you through saving the token securely.
Ask it to send a file. Your agent uploads it and gives you a link to share.

Testing today? Uploads are free, with a 1 GB limit and seven days to download. These are preview limits, not the launch offer.

Give your agent the connection details

Paste this once so your agent knows where Bilaga is and how to use it. This does not sign you in or grant access to your account.

Connect to Bilaga for file transfers. Read https://bilaga.link/llms.txt and use https://bilaga.link as the API address. Help me save my Bilaga API token in your secure credential storage, never in a URL or chat. Then upload files when I ask and return their download links. If you cannot store credentials securely, tell me what setup is needed.

Use your private token only in secure credential setup, not in the chat message.

Technical setup and API reference

Start with a file

Use the Python client with Python 3.10 or later. It uses the standard library and retries failed chunks. Inspect the downloaded script before running it. Set BILAGA_TOKEN in your environment, then replace the filename below.

python3 bilaga.py \
  --base https://bilaga.link \
  --file report.pdf

The response includes the shareable link and expiry. Your agent delivers that link through its existing conversation or communication channel.

Check the handoff

python3 bilaga.py --base https://bilaga.link \
  --status TRANSFER_ID

Poll at most once every 15 seconds. A download request means a download started; it doesn’t prove completion or that a human read the file. Bilaga only marks a transfer “sent” when the agent reports delivery.

A small API, end to end

Send your token as Authorization: Bearer …. Keep it private: it can manage the transfers created with it. Recipient links never contain the token.

Endpoint	What it does
GET /api/config	See upload limits and availability.
GET /api/quote?bytes=…	Get the future transfer price. No charge in this preview.
POST /api/transfers	Create an upload with a filename and size in bytes.
PUT /api/transfers/{id}/parts/{n}	Upload one binary chunk. Retry failed chunks.
POST /api/transfers/{id}/complete	Finish the upload and receive the shareable link.
GET /api/transfers/{id}	Check uploaded parts, expiry, and download requests.
POST /api/transfers/{id}/sent	Record that your agent delivered the link.
DELETE /api/transfers/{id}	Revoke the link and delete the stored file.

The launch offer

Add $15 or $30 in credit. Pay $0.10 per GB, with a $0.25 minimum per completed transfer. A 1 GB file costs $0.25; 10 GB costs $1; 50 GB costs $5.

Credit expires 24 months after each purchase. Files will be available for 30 days. Files up to 50 GB are planned, subject to reliability testing. Payments and launch limits are not enabled yet.

Read the complete agent instructions