CustomField

A model for defining custom fields on a record.

Data model

Table

Property	Type	Required	Description
name	string	Yes	Name of the custom field
type	CustomFieldType	Yes	The JSON schema type to use when de-serializing the value
schema	url	No	Link to the full JSON schema for this custom field
value	any	Yes	Value of the custom field
description	string	No	Description of the custom field’s purpose

JSON Schema

$schema: https://json-schema.org/draft/2020-12/schema
$id: CustomField.yaml
type: object
properties:
  name:
    type: string
    description: Name of the custom field
  type:
    $ref: CustomFieldType.yaml
    description: The JSON schema type to use when de-serializing the value
  schema:
    type: string
    format: uri
    description: Link to the full JSON schema for this custom field
  value:
    description: Value of the custom field
  description:
    type: string
    description: Description of the custom field's purpose
required:
  - name
  - type
  - value
description: A custom field on a model

TypeSpec

@doc("A custom field on a model")
model CustomField {
  /** Name of the custom field */
  name: string;

  /** The JSON schema type to use when de-serializing the `value` field */
  type: CustomFieldType;

  /** Link to the full JSON schema for this custom field */
  schema?: url;

  /** Value of the custom field */
  value: unknown;

  /** Description of the custom field's purpose */
  description?: string;
}

Example

{
  "name": "programArea",
  "type": "string",
  "value": "Healthcare Innovation",
  "description": "Primary focus area of the grant program",
  "schema": "https://example.com/program-areas.json"
}

CustomFieldType

The set of JSON schema types supported by a custom field.

Options

Value	Description
string	Text values
number	Numeric values
boolean	True/false values
object	Structured data objects
array	Lists of values

JSON Schema

$schema: https://json-schema.org/draft/2020-12/schema
$id: CustomFieldType.yaml
type: string
enum:
  - string
  - number
  - boolean
  - object
  - array
description: The set of JSON schema types supported by a custom field

TypeSpec

/** The set of JSON schema types supported by a custom field */
enum CustomFieldType {
  string,
  number,
  boolean,
  object,
  array,
}