mkdir

Create a directory

Create a new directory at the specified Viking URI.

Python SDK

from openviking import OpenViking

client = OpenViking()

# Create a new directory
client.mkdir("viking://resources/new-project/")

HTTP API

cURL

curl -X POST http://localhost:1933/api/v1/fs/mkdir \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-key" \
  -d '{
    "uri": "viking://resources/new-project/"
  }'

POST /api/v1/fs/mkdir

{
  "uri": "viking://resources/new-project/"
}

Parameters

uri · string · required

Viking URI for the new directory (must end with /)

Response

status · string

Operation status (ok on success)

result · object

Result object containing the created directory URI

Show properties

uri · string

Viking URI of the created directory

time · number

Execution time in seconds

{
  "status": "ok",
  "result": {
    "uri": "viking://resources/new-project/"
  },
  "time": 0.1
}

CLI

openviking mkdir viking://resources/new-project/

Notes

• The URI should end with a trailing slash (/) to indicate it’s a directory
• Parent directories are created automatically if they don’t exist
• If the directory already exists, the operation succeeds without error