Create a file

curl --request POST \
  --url https://api.qontext.ai/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "/support/policies/refunds.md",
  "content": "# Refunds\n\nRefunds are processed within 14 days."
}
'

import requests

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

payload = {
    "path": "/support/policies/refunds.md",
    "content": "# Refunds

Refunds are processed within 14 days."
}
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: '/support/policies/refunds.md',
    content: '# Refunds\n\nRefunds are processed within 14 days.'
  })
};

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

{
  "object": "file",
  "id": "doc_9f2k1x8b3m7q0v",
  "path": "/support/policies/refunds.md",
  "name": "refunds.md",
  "parentId": "dir_4k1n8p2v5m7q0x",
  "parentPath": "/support/policies",
  "protected": true,
  "lastChangeId": "chg_7t4p2w9c1n6s8k",
  "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/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/content-too-large",
  "title": "Content too long",
  "status": 422,
  "code": "content_too_large",
  "detail": "The content is longer than this API accepts.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b",
  "errors": [
    {
      "code": "too_long",
      "pointer": "/content",
      "detail": "61440 characters; the limit is 51200."
    }
  ]
}

{
  "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"
}

POST

files

Create a file

curl --request POST \
  --url https://api.qontext.ai/v1/files \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "path": "/support/policies/refunds.md",
  "content": "# Refunds\n\nRefunds are processed within 14 days."
}
'

import requests

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

payload = {
    "path": "/support/policies/refunds.md",
    "content": "# Refunds

Refunds are processed within 14 days."
}
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: '/support/policies/refunds.md',
    content: '# Refunds\n\nRefunds are processed within 14 days.'
  })
};

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

{
  "object": "file",
  "id": "doc_9f2k1x8b3m7q0v",
  "path": "/support/policies/refunds.md",
  "name": "refunds.md",
  "parentId": "dir_4k1n8p2v5m7q0x",
  "parentPath": "/support/policies",
  "protected": true,
  "lastChangeId": "chg_7t4p2w9c1n6s8k",
  "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/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/content-too-large",
  "title": "Content too long",
  "status": 422,
  "code": "content_too_large",
  "detail": "The content is longer than this API accepts.",
  "requestId": "3f9c2b7e4d1a48c0b6e5f2a19d7c3e8b",
  "errors": [
    {
      "code": "too_long",
      "pointer": "/content",
      "detail": "61440 characters; the limit is 51200."
    }
  ]
}

{
  "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"
}

Authorizations

Authorization

string

header

required

Workspace-scoped API key, sent as a bearer token. The recommended header. The workspace is implicit in the key and never appears in a URL.

Body

application/json

Create by path
Create in a folder

Create the file at an absolute path. Missing parent folders are created on the way.

path

string

required

Where to create the file. Absolute, and ends in .md. A path already holding a file is a conflict, never an overwrite.

Example:

"/support/policies/refunds.md"

content

string

required

Markdown or plain text.

Maximum string length: 51200

Example:

"# Refunds\n\nRefunds are processed within 14 days."

Response

Created. The file is in the live files.

object

enum<string>

required

Type discriminator. Always file.

Available options:

file

string

required

Stable id. Survives a rename or a move.

Example:

"doc_9f2k1x8b3m7q0v"

path

string

required

Live file location. Changes when the file moves.

Example:

"/support/policies/refunds.md"

name

string

required

Leaf name, including its extension, without any part of the path.

Example:

"refunds.md"

parentId

string | null

required

The containing folder, or null when the file sits at the root. Send it back to move a file.

Example:

"dir_4k1n8p2v5m7q0x"

parentPath

string

required

Path of the containing folder. / at the root.

Example:

"/support/policies"

protected

boolean

required

When true, a change to this file goes to review instead of being accepted automatically.

lastChangeId

string

required

The last change to this file (update, rename or move). Pass it back as baseChangeId on a write.

Example:

"chg_7t4p2w9c1n6s8k"

createdAt

string<date-time>

required

When the file was created.

Example:

"2026-07-01T09:12:00.000Z"

updatedAt

string<date-time>

required

When the file last changed, including a rename or a move.

Example:

"2026-08-01T14:03:00.000Z"

Get started

Using the API

Files

Folders

Search

Create a file

Authorizations

Body

Response