# Super.ai files API

**Canonical:** https://apis.io/apis/superai/superai-files-api/  
**Provider:** Super.ai — https://apis.io/providers/superai/  
**Base URL:** https://flows.super.ai/api  
**Documentation:** https://docs.flows.super.ai

Super.ai files API is one of 19 APIs that [Super.ai](https://apis.io/providers/superai/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include File. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and authentication docs.

File download operations for retrieving files from gs:// storage URIs. When Super.AI Flows processes documents, task outputs often include file references as `gs://` URIs pointing to Google Cloud Storage. These endpoints let you download those files without needing to understand GCS internals or parse storage URLs. **The problem these endpoints solve:** Previously, downloading a file required: 1. Recognizing the URL as a GCS reference 2. Parsing out the file key from the URI 3. Calling a separate endpoint to get a signed URL 4. Downloading using that signed URL **Now it's simple:** Pass the `gs://` URI exactly as received and get your file. **Two ways to download:** 1. **Direct download** (`GET /files/download`): Returns a redirect to the file. Perfect for curl with `-L` flag. ``` curl -L -H "X-API-Key: saf_xxx" "https://flows.super.ai/api/files/download?uri=gs://..." -o file.pdf ``` 2. **Resolve first** (`POST /files/resolve`): Returns a JSON response with the download URL. Better for programmatic use and sensitive files (keeps URI out of logs). ``` curl -X POST "https://flows.super.ai/api/files/resolve" \ -H "X-API-Key: saf_xxx" \ -H "Content-Type: application/json" \ -d '{"uri": "gs://..."}' ``` **Security:** - Files are organization-scoped: you can only download files from flows your organization owns - URIs are validated to prevent path traversal attacks - Download URLs expire after 1 hour **Common use cases:** - Download processed documents from completed flow executions - Retrieve extracted data files from task outputs - Integrate file downloads into automated pipelines

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/superai/refs/heads/main/openapi/superai-files-api-openapi.yml
- **APIReference** — https://docs.flows.super.ai/api-reference
- **Authentication** — https://raw.githubusercontent.com/api-evangelist/superai/refs/heads/main/authentication/superai-authentication.yml

## Other Super.ai APIs (12)

- [Super.ai auth API](https://apis.io/apis/superai/superai-auth-api/)
- [Super.ai flow-executions API](https://apis.io/apis/superai/superai-flow-executions-api/)
- [Super.ai flows API](https://apis.io/apis/superai/superai-flows-api/)
- [Super.ai human-review-tasks API](https://apis.io/apis/superai/superai-human-review-tasks-api/)
- [Super.ai integrations API](https://apis.io/apis/superai/superai-integrations-api/)
- [Super.ai models API](https://apis.io/apis/superai/superai-models-api/)
- [Super.ai organizations API](https://apis.io/apis/superai/superai-organizations-api/)
- [Super.ai plugins API](https://apis.io/apis/superai/superai-plugins-api/)
- [Super.ai profile API](https://apis.io/apis/superai/superai-profile-api/)
- [Super.ai service-accounts API](https://apis.io/apis/superai/superai-service-accounts-api/)
- [Super.ai sso API](https://apis.io/apis/superai/superai-sso-api/)
- [Super.ai task-data API](https://apis.io/apis/superai/superai-task-data-api/)

## Tags

File

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/superai/superai-files-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/superai/.