Upload a file
POST/v2/spaces/:space_id/files
Send multipart/form-data with a file field, or JSON {"url": …}. A source that refuses the fetch, or a URL that cannot be fetched, is a 400 naming /url; only a genuine server fault answers 500. The id that comes back is the one file blocks, image blocks and icon_image values reference.
Request
Responses
- 200
- 201
- 400
- 401
- 403
- 404
- 409
- 413
- 429
Dry run; validation result without committing
Created file object id
Validation failure, or a source URL that did not yield the file
Missing, unknown, revoked or expired key; shared authentication envelope
The shared key-scope gate uses the legacy envelope; an operation-specific refusal may use the v2 error envelope
The space does not exist, or is not available (deleted, left, or still joining)
Idempotency-Key conflict, or an operation-specific concurrency conflict
Request body exceeds this operation's documented cap
Shared write rate limit; legacy error envelope