Skip to navigation

List data types

View as Markdown
Returns every data type in your organization as a JSON array. Unset fields come back as empty values, and secrets come back redacted.

Authentication

AuthorizationBearer

JWT bearer token authentication. Include the Configuration API key in the Authorization header as ‘Bearer <token>’.

Response

The data types in your organization
idstringOptionalRead-only
Unique identifier of the data type, assigned by the server. Cannot be changed.
namestringOptionalRead-onlyformat: "^u_[A-Z][A-Za-z0-9]+$"5-32 characters

Type name derived from friendly_name on create, in the format u_PascalCase (for example, Purchase Order becomes u_PurchaseOrder). Read-only.

friendly_namestringOptional3-64 characters

User-friendly display name for the data type (3 to 64 characters).

descriptionstringOptional3-256 characters

Description of what the data type represents (3 to 256 characters).

schemaobjectOptional
JSON schema for one instance of the data type. Required.
resolution_strategyobjectOptional
Default resolution strategy used to resolve values of this data type. Required.
system_usage_configobjectOptional
Controls which fields the assistant sees and uses for citations and identification.
updated_timedatetimeOptionalRead-only
When the configuration was last updated.
updated_bystringOptionalRead-only
Who last updated the configuration.
versionobjectOptional
Document version. On update, send back the num from your last read.
type_idstringOptionalRead-only
Value other resources store to reference this data type, such as a slot's type.custom. Assigned by the server and different in each tenant.

Errors

401
Unauthorized Error
403
Forbidden Error
429
Too Many Requests Error
500
Internal Server Error