Skip to main content
POST
/
v1
/
workspaces
/
{id}
/
files
/
{path}
Create an entry at a sub-path
curl --request POST \
  --url https://storage.runtools.ai/v1/workspaces/{id}/files/{path} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "type": "file",
  "contents": "<string>"
}
'

Documentation Index

Fetch the complete documentation index at: https://docs.runtools.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

WorkOS session token or RunTools API key (rt_live_* / rt_test_*). Used in Authorization: Bearer <token> header.

Path Parameters

​
id
string<uuid>
required
​
path
string
required

Sub-path within the workspace; may contain /.

Body

application/json
​
name
string
​
type
enum<string>
Available options:
file,
directory
​
contents
string

Optional initial text contents for a new file.

Response

200

Created.