CustomField

A model for defining custom fields on a record.

CustomField

Table

Property	Type	Required	Description
name	string	Yes	Name of the custom field
fieldType	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

Formats

A JSON example of this model.

{
  "name": "eligibilityType",
  "fieldType": "array",
  "value": [
    "nonprofit",
    "academic"
  ],
  "description": "Types of eligible organizations"
}

The JSON Schema for this model.

$schema: https://json-schema.org/draft/2020-12/schema
$id: CustomField.yaml
type: object
properties:
  name:
    type: string
    description: Name of the custom field
  fieldType:
    $ref: CustomFieldType.yaml
    description: The JSON schema type to use when de-serializing the `value` field
  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
  - fieldType
  - value
unevaluatedProperties:
  not: {}
examples:
  - name: eligibilityType
    fieldType: array
    value:
      - nonprofit
      - academic
    description: Types of eligible organizations
  - name: programArea
    fieldType: string
    value: Healthcare Innovation
    description: Primary focus area of the grant program
    schema: https://example.com/program-areas.json
description: A custom field on a model

The TypeSpec code for this model.

@doc("A custom field on a model")
@Versioning.added(CommonGrants.Versions.v0_1)
model CustomField {
  /** Name of the custom field */
  name: string;

  /** The JSON schema type to use when de-serializing the `value` field */
  fieldType: 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;
}

The Python code for this model.

V = te.TypeVar("V", default=Any)


class CustomField(CommonGrantsBaseModel, Generic[V]):
    """A custom field with type information and a typed value.

    Generic over its value type ``V`` (default ``Any``): the bare ``CustomField``
    keeps the protocol's untyped-value behavior, while ``CustomField[int]`` (or a
    Pydantic model) gives plugin authors and consumers a concrete, inspectable
    ``value`` type. ``populate_by_name`` plus ``validation_alias``/
    ``serialization_alias`` keep JSON I/O camelCase (``fieldType``) while
    snake_case field-name construction (``CustomField(field_type=...)``) type-checks.
    """

    model_config = ConfigDict(populate_by_name=True)

    name: str = Field(
        ...,
        description="Name of the custom field",
        min_length=1,
    )
    field_type: CustomFieldType = Field(

The TypeScript code for this model.

export const CustomFieldSchema = z.object({
  /** Name of the custom field */
  name: z.string(),

  /** The JSON schema type */
  fieldType: CustomFieldTypeEnum,

  /** Link to the full JSON schema */
  schema: z.string().url().nullish(),

  /** Value of the custom field */
  value: z.unknown(),

  /** Description of the custom field's purpose */
  description: z.string().nullish(),
});

Changelog

Version	Changes	Schema
0.1.0	Added `CustomField` model	CustomField.yaml

CustomFieldType

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

Options

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