Skip to main content
Every request you make to the Virtus Cloud Blob API must include a valid API key. Authentication is handled through a single HTTP header — there are no session tokens, cookies, or OAuth flows to manage. This keeps integration simple and predictable whether you are calling the API directly or using one of the official SDKs.

​
Base URL

All Blob API endpoints are served from the following base URL: 
https://blob.virtuscloud.app
Prepend this base URL to every endpoint path shown in this reference. For example, the upload endpoint is: 
POST https://blob.virtuscloud.app/v1/objects

​
Obtaining Your API Key

To get your API key, log in to the Virtus Cloud Developer Dashboard and navigate to Account → Security. Generate a new API key or copy an existing one.
Treat your API key like a password. Anyone who holds it can read, upload, and delete objects in your account. Do not commit it to version control or expose it in client-side code.

​
Sending Your API Key

Include your API key in the Authorization header of every request: 
Authorization: <your-api-key>

curl -X GET https://blob.virtuscloud.app/v1/objects \
  -H "Authorization: <your-api-key>"
If your API key is missing or invalid, every endpoint returns a 401 status with the following body: 
{
  "status": "error",
  "code": "ACCESS_DENIED"
}

​
API Usage Policy

Use of the Blob API is subject to the Virtus Cloud Terms of Service and Acceptable Use Policy. Ensure your integration complies with both before going to production.

Limits and Restrictions

Review the rate limits and usage restrictions that apply to all Blob API endpoints.