Connector API for cloud imports and exports

Summary

Connectors are the public storage integration boundary for import and export workflows. The API supports provider-specific creation, listing, retrieval, testing, browsing, update, and deletion.

Connector endpoints

Method	Path	Purpose
`POST`	`/api/v2/connectors/gcs`	Create a GCS connector
`POST`	`/api/v2/connectors/s3`	Create an S3 connector
`POST`	`/api/v2/connectors/azure`	Create an Azure Blob connector
`GET`	`/api/v2/connectors`	List connectors
`GET`	`/api/v2/connectors/{connector_id}`	Retrieve one connector
`PATCH`	`/api/v2/connectors/{connector_id}`	Update mutable connector fields
`POST`	`/api/v2/connectors/{connector_id}/test`	Validate access
`POST`	`/api/v2/connectors/{connector_id}/browse`	Browse files with prefix and pattern
`DELETE`	`/api/v2/connectors/{connector_id}`	Delete a connector

Common connector fields

Field	Notes
`name`	Human-readable connector name
`scopes`	One or both of `import` and `export`
`export_base_path`	Optional export boundary inside the storage namespace
`import_mode`	`all` or `new_only`

Provider-specific creation

GCS creation uses multipart form data with credentials_file.
S3 creation uses JSON with bucket, region, aws_access_key_id, and aws_secret_access_key.
Azure creation uses JSON with storage_account, container, tenant_id, client_id, and client_secret.

Example: create an S3 connector

curl -X POST /api/v2/connectors/s3 \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: connector-s3-archive" \
  -d '{
    "name": "Archive S3",
    "bucket": "media-archive",
    "region": "us-east-1",
    "aws_access_key_id": "AKIA...",
    "aws_secret_access_key": "<secret>",
    "scopes": ["import", "export"],
    "export_base_path": "exports/review",
    "import_mode": "new_only"
  }'

Example: browse files

curl -X POST /api/v2/connectors/conn_123/browse \
  -H "X-API-Key: sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "prefix": "incoming/2026/04/",
    "pattern": "*.mp4"
  }'