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 content change to this file. A rename or a move does not advance it. 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