Files

Manage team files (knowledge base).

get

List files for the current team.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Responses

200

Default Response

application/json

401

Default Response

application/json

500

Default Response

application/json

get

/v1/files

HTTPcURLJavaScriptPython

GET /v1/files HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "files": [
    {
      "id": "text",
      "name": "text",
      "path": "text",
      "created_at": "text",
      "updated_at": "text",
      "metadata": {
        "mimetype": "text",
        "size": 1
      }
    }
  ]
}

patch

Rename a file in team storage.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Body

application/json

relativePathstring · min: 1Required

Current path of the file relative to the team's storage root

newFilenameOnlystring · min: 1Required

New file name (no extension; the existing extension is preserved)

Responses

200

Default Response

application/json

successbooleanRequired

True if the operation succeeded

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

patch

/v1/files

HTTPcURLJavaScriptPython

PATCH /v1/files HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 48

{
  "relativePath": "text",
  "newFilenameOnly": "text"
}

{
  "success": true
}

post

Generate a signed URL for uploading a file directly to GCS.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Body

application/json

fileNamestring · min: 1Required

Name of the file to upload

contentTypestring · min: 1Required

MIME type of the file

Responses

200

Default Response

application/json

signedUrlstring · uriRequired

The signed URL for uploading

expiresAtstring · date-timeRequired

When the URL expires

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

filePathstringRequired

The path where the file will be stored

400

Default Response

application/json

401

Default Response

application/json

500

Default Response

application/json

post

/v1/files/create-upload-url

HTTPcURLJavaScriptPython

POST /v1/files/create-upload-url HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 40

{
  "fileName": "text",
  "contentType": "text"
}

{
  "signedUrl": "https://example.com",
  "expiresAt": "2026-05-20T03:18:39.233Z",
  "filePath": "text"
}

delete

Delete a file from team storage.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

*string · min: 1Required

Path of the file to delete relative to the team's storage root

Responses

200

Default Response

application/json

successbooleanRequired

True if the operation succeeded

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

delete

/v1/files/{*}

HTTPcURLJavaScriptPython

DELETE /v1/files/{*} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "success": true
}

get

Generate a signed download URL for a file.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

*string · min: 1Required

Path of the file relative to the team's storage root

Responses

200

Default Response

application/json

urlstring · uriRequired

Signed download URL

expiresAtstring · date-timeRequired

ISO 8601 timestamp when the URL expires

Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/files/download-url/{*}

HTTPcURLJavaScriptPython

GET /v1/files/download-url/{*} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "url": "https://example.com",
  "expiresAt": "2026-05-20T03:18:39.233Z"
}

get

Get the content of a text file.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

*string · min: 1Required

Path of the file relative to the team's storage root

Responses

200

Default Response

application/json

contentstringRequired

UTF-8 decoded contents of the file

pathstringRequired

Relative path of the file

contentTypestringOptional

MIME content type inferred from the file extension

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

get

/v1/files/content/{*}

HTTPcURLJavaScriptPython

GET /v1/files/content/{*} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "content": "text",
  "path": "text",
  "contentType": "text"
}

put

Update the content of a text file.

Authorizations

bearerAuth

AuthorizationstringRequired

API key authentication. Get your API key from the Duvo dashboard.

Path parameters

*string · min: 1Required

Path of the file relative to the team's storage root

Body

application/json

contentstringRequired

New UTF-8 text content for the file

Responses

200

Default Response

application/json

successbooleanRequired

True if the operation succeeded

400

Default Response

application/json

401

Default Response

application/json

404

Default Response

application/json

500

Default Response

application/json

put

/v1/files/content/{*}

HTTPcURLJavaScriptPython

PUT /v1/files/content/{*} HTTP/1.1
Host: api.duvo.ai
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 18

{
  "content": "text"
}

{
  "success": true
}