File reads and location objects¶
Times are Unix seconds; size is in bytes. Metadata describes the file itself, while an association location describes its reference within a volume. Zero-valued scalars may be omitted. Source conversation/task/call/tool information is read back according to current identity visibility.
Workspace file metadata¶
Field |
Type |
Description |
|---|---|---|
|
string |
File ID. |
|
string |
Original file name. |
|
string |
Content digest. |
|
integer |
File size in bytes. |
|
integer |
Current reference count. |
|
integer |
Creation time in Unix seconds. |
|
string |
Creator ID. |
|
integer |
Update time in Unix seconds. |
|
string |
Source category. |
|
string |
Source conversation ID, returned according to visibility. |
|
string |
Source task ID, returned according to visibility. |
|
string |
Source call ID, returned according to visibility. |
|
string |
Saved content type. |
|
string |
Source tool identifier, returned according to visibility. |
|
string |
Storage mode. |
|
string |
External connector ID, when applicable. |
|
string |
External object URI, when applicable. |
Volume file association location¶
Field |
Type |
Description |
|---|---|---|
|
integer |
Volume file association record ID. |
|
integer |
Associated volume ID. |
|
string |
File ID. |
|
string |
File name at this location. |
|
string |
Relative path within the volume. |
|
integer |
Creation time in Unix seconds. |
|
string |
Creator ID. |
|
integer |
Update time in Unix seconds. |
|
string |
Updater ID. |
|
string |
Original file name. |
|
string |
Content digest. |
|
integer |
File size in bytes. |
|
integer |
Current reference count. |
|
integer |
Association location revision. |
|
string |
Source category. |
|
string |
Source conversation ID, returned according to visibility. |
|
string |
Source task ID, returned according to visibility. |
|
string |
Source call ID, returned according to visibility. |
|
string |
Saved content type. |
|
string |
Source tool identifier, returned according to visibility. |
|
string |
Sandbox mount path. |
Private volume upload location¶
Field |
Type |
Description |
|---|---|---|
|
string |
Workspace ID. |
|
integer |
Associated volume ID. |
|
string |
File ID. |
|
string |
Path within the volume. |
|
string |
Association name. |
|
integer |
File size in bytes. |
|
string |
Content digest. |