Data Types - Semple Developer Docs

Because Semple modules are dynamically created by users, the SDK expects your JavaScript/TypeScript payloads to match the exact field configurations. When you create or update a record using the fields object, the values you provide must align with the underlying Semple Data Type as defined in the core allocator.

Text Types

Semple Type ID	TypeScript Type	Description & Example Payload
`string`	`string`	Single line text. `{ "Job Title": "Engineer" }`
`longtext`	`string`	Multi-line long text. `{ "Notes": "Very long..." }`
`email`	`string`	Validated email string. `{ "Contact": "jane@example.com" }`
`url`	`string`	Validated URL string. `{ "Website": "https://trize.com" }`

Number Types

Semple Type ID	TypeScript Type	Description & Example Payload
`smallint`	`number`	Small number / Integer. `{ "Count": 5 }`
`number`	`number`	Standard number. `{ "Age": 25 }`
`decimal`	`number`	Floating point number. `{ "Multiplier": 1.25 }`
`currency`	`number`	Currency value. `{ "Price": 9.99 }`

Boolean & Dates

Semple Type ID	TypeScript Type	Description & Example Payload
`boolean`	`boolean`	True/False checkbox. `{ "Is Active": true }`
`date`	`string`	Date string. `{ "Birthdate": "1990-01-01" }`
`timestamp`	`string`	ISO-8601 Date and time. `{ "Created": "1990-01-01T00:00:00Z" }`
`duration`	`number`	Duration value (e.g., seconds/minutes). `{ "Time Taken": 300 }`

Advanced Types

Semple Type ID	TypeScript Type	Description & Example Payload
`tags`	`string[]`	Array of strings for tagging. `{ "Tags": ["vip", "beta"] }`
`multiselect`	`string[]`	Multiple select from predefined options. `{ "Options": ["A", "B"] }`
`number_array`	`number[]`	Array of numbers. `{ "Scores": [95, 87, 100] }`
`uuid`	`string`	A valid UUID v4 string. `{ "External ID": "123e4567-e89b-12d3-a456-426614174000" }`
`json`	`object`	Arbitrary JSON object. `{ "Metadata": { "key": "value" } }`

Relation & Files

Semple Type ID	TypeScript Type	Description & Example Payload
`relation`	`string`	The unique `id` of a record in a target module. `{ "Company": "rec_01H9Z..." }`
`file`	`string`	The ID or URL of a single uploaded file. `{ "Avatar": "file_123" }`
`files`	`string[]`	Array of file IDs/URLs. `{ "Documents": ["file_123", "file_456"] }`

Strict Type Enforcement

If you attempt to pass a string to a number field, or a misformatted date string to a timestamp field, the Semple API (and by extension, the SDK) will reject the mutation with an invalid_argument error.

AI Agent Rules for Types

If you are an AI generating payloads:

Always parse numbers to raw number primitives. Do not send "10".
Ensure timestamp values are formatted correctly using .toISOString().
When populating relation fields, ensure the value is the rec_... ID of the related record, not its name or a nested object.