Skip to main content
POST
Create a file node (before uploading)

Authorizations

Authorization
string
header
required

An aik_… programmatic API key (app.atako.ai → Settings → API keys) or a Supabase session JWT.

Body

application/json
name
string
required
Minimum string length: 1
parentId
string<uuid>
agentTag
string<uuid>
fileSize
integer

Size of the file about to be uploaded, in bytes. When sent, a file above the drive limit (50 MiB) is refused with 413 before any node is created.

Required range: 0 <= x <= 52428800

Response

id
string<uuid>
required
clientId
string<uuid>
required
type
enum<string>
required
Available options:
folder,
file
name
string
required
createdAt
string<date-time>
required
parentId
string<uuid> | null
storagePath
string | null
mimeType
string | null
fileSize
integer | null
agentTag
string<uuid> | null
uploadSource
enum<string> | null
Available options:
client,
agent
updatedAt
string<date-time>