Files

Upload, download, and manage files.

Upload File

post

Upload a file scoped to a specific workspace. The file's lifetime is tied to the organization. This is the preferred endpoint for new file uploads.

Authorizations

BearerAuth

AuthorizationstringRequired

Personal Access Token.

Path parameters

organization_idstringRequired

workspace_idstringRequired

Body

multipart/form-data

Message that represents an arbitrary HTTP body. It should only be used for payload formats that can't be represented as JSON, such as raw binary or an HTML page.

This message can be used both in streaming and non-streaming API methods in the request as well as the response.

It can be used as a top-level request field, which is convenient if one wants to extract parameters from either the URL or HTTP template into the request fields and also want access to the raw HTTP body.

Example:

message GetResourceRequest {
  // A unique request id.
  string request_id = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

Example with streaming methods:

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

Use of this type only changes how the request and response bodies are handled, all other features will continue to work unchanged.

content_typestringOptional

The HTTP Content-Type header value specifying the content type of the body.

datastring · byteOptional

The HTTP request/response body as raw binary.

Responses

200

A successful response.

application/json

201

File uploaded successfully

application/json

Responseany

default

An unexpected error response.

application/json

post/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files:upload

HTTPcURLJavaScriptPython

POST /api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files:upload HTTP/1.1
Host: app.us-1.kognitos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 110

{
  "content_type": "text",
  "data": "Ynl0ZXM=",
  "extensions": [
    {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
  ]
}

No content

Download File

get

Authorizations

BearerAuth

AuthorizationstringRequired

Personal Access Token.

Path parameters

organization_idstringRequired

workspace_idstringRequired

filestringRequired

Responses

200

File content

application/octet-stream

Responsestring · binary

default

An unexpected error response.

application/octet-stream

get/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}:download

HTTPcURLJavaScriptPython

GET /api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}:download HTTP/1.1
Host: app.us-1.kognitos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

binary

Get File Metadata

get

Authorizations

BearerAuth

AuthorizationstringRequired

Personal Access Token.

Path parameters

organization_idstringRequired

workspace_idstringRequired

filestringRequired

Responses

200

A successful response.

application/json

namestringRead-onlyOptional

filenamestringRequired

mime_typestringRead-onlyOptional

size_bytesstring · int64Read-onlyOptional

create_timestring · date-timeRead-onlyOptional

default

An unexpected error response.

application/json

get/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}/metadata

HTTPcURLJavaScriptPython

GET /api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}/metadata HTTP/1.1
Host: app.us-1.kognitos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "name": "text",
  "filename": "text",
  "mime_type": "text",
  "size_bytes": "text",
  "create_time": "2026-07-10T11:30:23.379Z"
}

Delete File

delete

Authorizations

BearerAuth

AuthorizationstringRequired

Personal Access Token.

Path parameters

organization_idstringRequired

workspace_idstringRequired

filestringRequired

Responses

200

A successful response.

application/json

objectOptional

default

An unexpected error response.

application/json

delete/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}

HTTPcURLJavaScriptPython

DELETE /api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file} HTTP/1.1
Host: app.us-1.kognitos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{}

Generate Upload Url

post

Authorizations

BearerAuth

AuthorizationstringRequired

Personal Access Token.

Path parameters

organization_idstringRequired

workspace_idstringRequired

Body

application/json

If no expiration duration is provided, the default is 1 hour.

expire_durationstringOptional

Responses

200

A successful response.

application/json

upload_uristringOptional

default

An unexpected error response.

application/json

post/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files:generateUploadUrl

HTTPcURLJavaScriptPython

POST /api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files:generateUploadUrl HTTP/1.1
Host: app.us-1.kognitos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "expire_duration": "text"
}

{
  "upload_uri": "text"
}

Generate Download Url

post

Authorizations

BearerAuth

AuthorizationstringRequired

Personal Access Token.

Path parameters

organization_idstringRequired

workspace_idstringRequired

filestringRequired

Body

application/json

If no expiration duration is provided, the default is 1 hour.

expire_durationstringOptional

Responses

200

A successful response.

application/json

download_uristringOptional

default

An unexpected error response.

application/json

post/api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}:generateDownloadUrl

HTTPcURLJavaScriptPython

POST /api/v1/organizations/{organization_id}/workspaces/{workspace_id}/files/{file}:generateDownloadUrl HTTP/1.1
Host: app.us-1.kognitos.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "expire_duration": "text"
}

{
  "download_uri": "text"
}