Files
Object storage: buckets, uploads, presigned links, media and a CDN face.
partData75 operationsid files
How it sits
A part does one thing, and any other part can call it. The counts and the links below are from the platform's spec and the other services' own descriptions.
| Operations | 75 GET 38 · POST 27 · DELETE 8 · PATCH 2 |
| Resources | 16 |
| Leaned on by | E-signature, Hive, Manim |
| Leans on | none named |
| In recipes | A region brief; A field team's turf pack |
What it can do
75 operations in 16 resources, as the spec declares them. Each row is one call; paths are relative to the part.
buckets
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/buckets | List buckets |
| POST | /api/v1/buckets | Create bucket |
| DELETE | /api/v1/buckets/{bucket_name} | Delete bucket |
| GET | /api/v1/buckets/{bucket_name} | Get bucket details |
| PATCH | /api/v1/buckets/{bucket_name} | Update bucket settings |
| GET | /api/v1/buckets/{bucket_name}/files | List files in bucket |
| DELETE | /api/v1/buckets/{bucket_name}/files/{object_name} | Delete file |
| GET | /api/v1/buckets/{bucket_name}/files/{object_name} | Download file |
| POST | /api/v1/buckets/{bucket_name}/files/{object_name} | Upload file |
| POST | /api/v1/buckets/{bucket_name}/files/{object_name}/signed-url | Generate signed download URL |
| POST | /api/v1/buckets/{bucket_name}/files/{object_name}/upload-url | Generate signed upload URL |
| POST | /api/v1/buckets/{bucket_name}/zip | Zip objects into one archive |
| GET | /api/v1/buckets/{bucket}/grants | List grants on a bucket |
| POST | /api/v1/buckets/{bucket}/grants | Share files with a user |
| DELETE | /api/v1/buckets/{bucket}/grants/{grant_id} | Revoke a grant |
15 operations
admin
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/admin/buckets/{bucket_name}/derivatives | Generate JPEG twins for images browsers cannot decode |
| GET | /api/v1/admin/minio/buckets | List MinIO buckets directly |
| GET | /api/v1/admin/minio/health | Check MinIO health |
| POST | /api/v1/admin/minio/restart | Restart MinIO server |
| POST | /api/v1/admin/minio/start | Start MinIO server |
| GET | /api/v1/admin/minio/status | Get MinIO server status |
| POST | /api/v1/admin/minio/stop | Stop MinIO server |
| GET | /api/v1/admin/registry/drive-backends | List all drive backends (operator view) |
| POST | /api/v1/admin/registry/reap-stale-syncs | Reap stale pending/running sync jobs |
| GET | /api/v1/admin/registry/sync-jobs | List recent sync jobs across all backends |
| POST | /api/v1/admin/screenshot/scan-publish | Publish new Loom screenshot reports to the mesh (user issue channel) |
| POST | /api/v1/admin/stash/scan-publish | Publish new Stash doc-drops to the mesh (Kevin push pipeline) |
12 operations
media
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/media/brands | List brands |
| GET | /api/v1/media/recent | Get recent media assets |
| GET | /api/v1/media/search | Search media assets |
| GET | /api/v1/media/sync | List media sync jobs |
| POST | /api/v1/media/sync | Trigger media sync |
| GET | /api/v1/media/sync/{job_id} | Get media sync job status |
| POST | /api/v1/media/upload | Upload media asset |
| POST | /api/v1/media/upsert | Upsert media asset by (bucket, object_name) |
| GET | /api/v1/media/{asset_id} | Get media asset |
| POST | /api/v1/media/{asset_id}/tag | Re-tag media asset |
| PATCH | /api/v1/media/{asset_id}/tags | Update media tags |
11 operations
drives
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/drives | List Google Drive backends |
| POST | /api/v1/drives | Register Google Drive backend |
| DELETE | /api/v1/drives/{backend_id} | Remove Google Drive backend |
| GET | /api/v1/drives/{backend_id} | Get Google Drive backend |
| GET | /api/v1/drives/{backend_id}/sync | List sync jobs |
| POST | /api/v1/drives/{backend_id}/sync | Trigger Drive sync |
| DELETE | /api/v1/drives/{backend_id}/sync/{job_id} | Delete sync job (admin purge) |
| GET | /api/v1/drives/{backend_id}/sync/{job_id} | Get sync job status |
| POST | /api/v1/drives/{backend_id}/test | Test Drive connectivity |
9 operations
users
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/users | List users |
| POST | /api/v1/users | Create user |
| GET | /api/v1/users/me | Get current user |
| GET | /api/v1/users/me/keys | List API keys |
| POST | /api/v1/users/me/keys | Create API key |
| DELETE | /api/v1/users/me/keys/{key_id} | Revoke API key |
| DELETE | /api/v1/users/{user_id} | Deactivate user |
| GET | /api/v1/users/{user_id} | Get user by ID |
8 operations
gdrive
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/gdrive | List GCS backends |
| POST | /api/v1/gdrive | Register GCS backend |
| DELETE | /api/v1/gdrive/{backend_id} | Remove GCS backend |
| GET | /api/v1/gdrive/{backend_id} | Get GCS backend |
| POST | /api/v1/gdrive/{backend_id}/test | Test GCS connectivity |
5 operations
index
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/index/{bucket_name} | List index jobs for a bucket |
| POST | /api/v1/index/{bucket_name} | Trigger content indexing for a bucket |
| GET | /api/v1/index/{bucket_name}/{job_id} | Get index job status |
3 operations
usage
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/usage | List usage records |
| GET | /api/v1/usage/storage | Get storage usage |
| GET | /api/v1/usage/summary | Get usage summary |
3 operations
health
| Method | Path | Does |
|---|---|---|
| GET | /health | Basic health check |
| GET | /health/detailed | Detailed health check |
2 operations
prime
| Method | Path | Does |
|---|---|---|
| GET | /prime | Prime application caches |
1 operation
public
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/public/{bucket_name}/{object_name} | Public file download |
1 operation
query
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/query/sql | Execute read-only SQL |
1 operation
search
| Method | Path | Does |
|---|---|---|
| POST | /api/v1/search | Semantic search across indexed files |
1 operation
shared-by-me
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/shared-by-me | Files I've shared |
1 operation
shared-with-me
| Method | Path | Does |
|---|---|---|
| GET | /api/v1/shared-with-me | Files shared with me |
1 operation
status
| Method | Path | Does |
|---|---|---|
| GET | /status | Service status overview |
1 operation
All the partsDataThe platform's own id for this service is cbfiles.
forge-catalog.json, generated Oct 30, 2026