Convert File Endpoint

curl --request POST \
  --url https://backend.overtenai.com/api/v1/files/{file_id}/convert \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-API-Key: <api-key>' \
  --data 'format=<string>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

public

Convert File Endpoint

Convert a previously-uploaded file into a different format.

Uses the same conversion pipeline as POST /runs/{run_id}/export but targets files the caller uploaded via POST /files — useful when the caller wants to normalise their own .docx/.xlsx/ .pptx without running them through an agent first.

Responses:

200 with {"format", "download_url", "expires_at"} on success.
400 for an unsupported (source, target) pair.
404 if the file_id isn’t visible to the caller.
502 if the conversion fails mid-run.

POST

files

{file_id}

convert

Convert File Endpoint

curl --request POST \
  --url https://backend.overtenai.com/api/v1/files/{file_id}/convert \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'X-API-Key: <api-key>' \
  --data 'format=<string>'

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

X-API-Key

string

header

required

Send X-API-Key: sk_live_<your_key>. Keys are issued via POST /signup or via the dashboard. Legacy callers may also use Authorization: Bearer sk_live_<your_key>.

Path Parameters

file_id

string

required

Body

application/x-www-form-urlencoded

format

string

required

Target extension (e.g. pdf, html, txt).

Response

Successful Response

Delete Image Endpoint List All