curl --request POST \
  --url https://api.qontext.ai/v1/folders \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "/projects/reports"
}
'

import requests

url = "https://api.qontext.ai/v1/folders"

payload = { "path": "/projects/reports" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({path: '/projects/reports'})
};

fetch('https://api.qontext.ai/v1/folders', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "folder",
  "id": "dir_9f2k1x8b3m7q0v",
  "name": "reports",
  "parentId": "dir_4k1n8p2v5m7q0x",
  "parentPath": "/projects",
  "path": "/projects/reports",
  "protected": true,
  "createdAt": "2026-07-01T09:12:00.000Z",
  "updatedAt": "2026-08-01T14:03:00.000Z"
}

{
  "type": "https://docs.qontext.ai/errors/invalid-request",
  "title": "Invalid request",
  "status": 400,
  "code": "invalid_request",
  "detail": "The request could not be accepted as sent.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b",
  "errors": [
    {
      "code": "out_of_range",
      "pointer": "/limit",
      "detail": "limit must not be greater than 1000"
    }
  ]
}

{
  "type": "https://docs.qontext.ai/errors/unauthenticated",
  "title": "Unauthenticated",
  "status": 401,
  "code": "unauthenticated",
  "detail": "The API key is missing or not valid.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b"
}

{
  "type": "https://docs.qontext.ai/errors/forbidden",
  "title": "Not permitted",
  "status": 403,
  "code": "forbidden",
  "detail": "This key is not allowed to do that.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b"
}

{
  "type": "https://docs.qontext.ai/errors/folder-not-found",
  "title": "Folder not found",
  "status": 404,
  "code": "folder_not_found",
  "detail": "No folder at that path, or none this key is allowed to read.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b"
}

{
  "type": "https://docs.qontext.ai/errors/path-already-exists",
  "title": "Path already exists",
  "status": 409,
  "code": "path_already_exists",
  "detail": "Something already exists at that path.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b"
}

{
  "type": "https://docs.qontext.ai/errors/internal-error",
  "title": "Internal error",
  "status": 500,
  "code": "internal_error",
  "detail": "An unexpected error occurred.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b"
}

{
  "type": "https://docs.qontext.ai/errors/service-unavailable",
  "title": "Temporarily unavailable",
  "status": 503,
  "code": "service_unavailable",
  "detail": "This workspace is temporarily unavailable.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b"
}