Create or overwrite file
Create a non-empty file or overwrite an existing file.
If the parent folder of the `path` parameter doesn't exist, the file system creates it before creating the file.
<Info>This acts on files in the AI Hub filesystem, not your local filesystem.</Info>
<Note>Ensure the path is accessible within the context defined by the `IB-Context` header.</Note>
Not all filesystem types support this operation.
| Filesystem | Supported |
|----------------------|-----------|
| Instabase | ✓ |
| Amazon S3 | ✓ |
| Azure Blob Storage | ✓ |
| Google Cloud Storage | ✓ |
| Google Drive | - |
Authentication
AuthorizationBearer
Bearer HTTP authentication.
Path parameters
path
Full path to the file.
Headers
IB-Context
Specify whether to use your community account or organization account to complete the request. To use your community account, define as your user ID. To use your organization account, define as your organization ID. If unspecified, defaults to community account context. See [Authorization and context identification](/api-sdk/authorization#ib-context-header) for details.
Request
This endpoint expects binary data of type application/octet-stream.
Response
The request succeeded and a new file was created at the target location. AI Hub returns this status code only when the request includes an If-None-Match header with a value of *.