Create file system
Creates a file system. Storage is provisioned lazily on first use by an agent run or MCP client.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
The unique key of the file system. The key is unique and immutable and cannot be repeated within the same workspace.
1 - 255^[A-Za-z]([A-Za-z0-9]*([._][A-Za-z0-9]+)*)?$Entity storage path. With workspace-level API keys, the first element identifies the project. With project-level API keys, the path is relative to that project.
1Human readable name shown in the UI. Defaults to the key.
2554096Whether external MCP clients may reach this file system. Defaults to disabled.
disabled, read_only, read_write Sharing controls which projects in the workspace may use this entity and what they may do with it.
Response
File system successfully created.
The unique key of the file system. The key is unique and immutable and cannot be repeated within the same workspace.
1 - 255^[A-Za-z]([A-Za-z0-9]*([._][A-Za-z0-9]+)*)?$Human readable name shown in the UI
The description of the file system. Be as precise as possible to help the AI understand what the file system is for.
Identifier of the project the file system belongs to
Whether external MCP clients may reach this file system, and with which access
disabled, read_only, read_write The creation date of the file system
The last update date of the file system
The unique identifier of the file system
The user ID of the creator
The user ID of the last updater
Sharing controls which projects in the workspace may use this entity and what they may do with it.
Apparent size of the file system in bytes at the last metering. Absent until first metered.
Number of files and directories in the file system at the last metering. Absent until first metered.
When usage was last measured. Absent until first metered.