Home/Cloud/Data Structures

Cloud Data Structures

Field definitions for key objects returned by Cloud APIs.

ID Format

Resources use prefixed public IDs (for example deal_..., inv_..., form_..., ak_...).

Folder object

Object representing a folder.

Fields

Name	Type	Required	Description
id	string	Required	Folder ID
object	string	Required	Object type (`cloud.folder`)
organization_id	string	Required	Organization ID
name	string	Required	Folder name
parent_id	string \| null	Optional	Parent folder ID
created_at	string	Required	Created at (ISO 8601)
updated_at	string	Required	Updated at (ISO 8601)

{
  "id": "folder_01JQ3KABC",
  "object": "cloud.folder",
  "organization_id": "org_01HZXYZ",
  "name": "Project Documents",
  "parent_id": null,
  "created_at": "2026-01-05T09:00:00Z",
  "updated_at": "2026-02-18T14:00:00Z"
}

File object

Object representing a file.

Fields

Name	Type	Required	Description
id	string	Required	File ID
object	string	Required	Object type (`cloud.file`)
organization_id	string	Required	Organization ID
name	string	Required	File name
folder_id	string \| null	Optional	Folder ID
mime_type	string	Required	MIME type
size	number	Required	File size (bytes)
created_at	string	Required	Created at (ISO 8601)
updated_at	string	Required	Updated at (ISO 8601)

{
  "id": "file_01JQ3KDEF",
  "object": "cloud.file",
  "organization_id": "org_01HZXYZ",
  "name": "proposal.pdf",
  "folder_id": "folder_01JQ3KABC",
  "mime_type": "application/pdf",
  "size": 1048576,
  "created_at": "2026-02-15T11:00:00Z",
  "updated_at": "2026-02-15T11:00:00Z"
}