Create Directories and Remove Files in a Capsule

Two endpoints let you manage the structure of a capsule’s filesystem: one for creating directories and one for removing files or directories. Both require the capsule to be in the running state.

Create a directory

POST https://app.wrenn.dev/api/v1/capsules/{id}/files/mkdir

Creates a directory at the specified path inside the capsule. Intermediate directories are created as needed (equivalent to mkdir -p).

Authentication

string

required

Your team’s API key. Pass the full wrn_... key value.

Path parameters

string

required

The ID of the capsule. The capsule must be in the running state.

Request body

string

required

Absolute path of the directory to create inside the capsule, e.g. "/app/data".

Example request

curl -X POST https://app.wrenn.dev/api/v1/capsules/cl-abc123/files/mkdir \
  -H "X-API-Key: wrn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"path": "/app/data"}'

{"path": "/app/data"}

Response

Returns 200 OK with a FileEntry object describing the created directory.

object

The created directory entry.

Show entry fields

string

Directory name.

string

Full absolute path of the created directory.

string

Always "directory".

string

Human-readable permission string, e.g. "drwxr-xr-x".

integer

Unix timestamp (seconds) of creation time.

Example response

{
  "entry": {
    "name": "data",
    "path": "/app/data",
    "type": "directory",
    "size": 4096,
    "permissions": "drwxr-xr-x",
    "owner": "user",
    "group": "user",
    "modified_at": 1730000000,
    "symlink_target": null
  }
}

Remove a file or directory

POST https://app.wrenn.dev/api/v1/capsules/{id}/files/remove

Removes a file or directory at the specified path inside the capsule. Removal is recursive for directories — all contents are deleted.

This operation is irreversible. Entire directory trees are removed without confirmation. Make sure you have a copy of any data you need before calling this endpoint.

Authentication

string

required

Your team’s API key. Pass the full wrn_... key value.

Path parameters

string

required

The ID of the capsule. The capsule must be in the running state.

Request body

string

required

Absolute path to the file or directory to remove, e.g. "/app/old".

Example request

curl -X POST https://app.wrenn.dev/api/v1/capsules/cl-abc123/files/remove \
  -H "X-API-Key: wrn_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{"path": "/app/old"}'

{"path": "/app/old"}

Response

Returns 204 No Content on success. No body is returned.

Python SDK

from wrenn import Capsule

with Capsule(wait=True) as capsule:
    # Create a directory (and any needed parents)
    capsule.files.make_dir("/app/data")

    # Remove a file
    capsule.files.remove("/app/old-script.py")

    # Remove an entire directory tree
    capsule.files.remove("/app/old")

remove works recursively for directories. There is no rmdir-style safe guard — it behaves like rm -rf.

Error responses

Status	Meaning
`404 Not Found`	The capsule does not exist, or the specified path does not exist inside the capsule.
`409 Conflict`	The capsule is not in the `running` state. Resume or start the capsule first.

Capsules

Execution

Files

Snapshots

Create Directories and Remove Files in a Capsule

Create a directory

Authentication

Path parameters

Request body

Example request

Response

Example response

Remove a file or directory

Authentication

Path parameters

Request body

Example request

Response

Python SDK

Error responses

​Create a directory

​Authentication

​Path parameters

​Request body

​Example request

​Response

​Example response

​Remove a file or directory

​Authentication

​Path parameters

​Request body

​Example request

​Response

​Python SDK

​Error responses

Create a directory

Authentication

Path parameters

Request body

Example request

Response

Example response

Remove a file or directory

Authentication

Path parameters

Request body

Example request

Response

Python SDK

Error responses