Create a file

POST 
/api/v1/files

Creates a new file record in the system

Request

Responses

201

File created successfully

400

Invalid request — a query parameter or body field the operation does not declare, or a value that fails validation

401

Authentication required

403

Insufficient permissions

409

The project's storage_bytes quota is exceeded (QUOTA_STORAGE_EXCEEDED). Delete stored content, or raise the quota — no window reset clears a stored total, so no Retry-After is sent.

413

REQUEST_REJECTED — the request body is over the size the body parser accepts

429

QUOTA_EXCEEDED — a requests quota on the calling API key or its project is spent for the window; Retry-After says when it reopens

Response Headers

Retry-After

Seconds until the quota window admits a request again

500

Internal server error