V2 Files

Upload file (v2)

post

Uploads exactly one file using a multipart part named file. The backend generates the fileId and returns it for later record references.

Body

multipart/form-data

objectOptional

Responses

200

File uploaded successfully

application/json

fileIdstring · uuidOptional

400

Missing or invalid multipart file part

application/json

401

Unauthorized

application/json

post

/api/v2/files

HTTPcURLJavaScriptPython

POST /api/v2/files HTTP/1.1
Host: api-z2.zinkee.com
Content-Type: multipart/form-data
Accept: */*
Content-Length: 2

{}

{
  "fileId": "d290f1ee-6c54-4b01-90e6-d701748f0851"
}

Get file storage info (v2)

get

Returns the storage quota and current usage for the active workspace. Both values are expressed in bytes.

Responses

200

Storage information retrieved successfully

application/json

maxSizeinteger · int64Optional

usedSizeinteger · int64Optional

401

Unauthorized

application/json

get

/api/v2/files/storage-info

HTTPcURLJavaScriptPython

GET /api/v2/files/storage-info HTTP/1.1
Host: api-z2.zinkee.com
Accept: */*

{
  "maxSize": 10737418240,
  "usedSize": 2147483648
}

Download file (v2)

get

Downloads the raw file bytes for one fileId. Use this when an agent needs the binary content itself rather than just a reference.

Path parameters

fileIdstring · uuidRequired

Responses

200

File downloaded successfully

application/octet-stream

string · binaryOptional

401

Unauthorized

application/octet-stream

404

File not found

application/octet-stream

get

/api/v2/files/{fileId}

HTTPcURLJavaScriptPython

GET /api/v2/files/{fileId} HTTP/1.1
Host: api-z2.zinkee.com
Accept: */*

binary

Delete file (v2)

delete

Deletes one file from workspace storage. Any record fields still referencing that fileId will keep the stale reference until updated separately.

Path parameters

fileIdstring · uuidRequired

Responses

200

File deleted successfully

application/json

fileIdstring · uuidOptional

deletedbooleanOptional

401

Unauthorized

application/json

404

File not found

application/json

delete

/api/v2/files/{fileId}

HTTPcURLJavaScriptPython

DELETE /api/v2/files/{fileId} HTTP/1.1
Host: api-z2.zinkee.com
Accept: */*

{
  "fileId": "123e4567-e89b-12d3-a456-426614174000",
  "deleted": true
}