String

Represents textual data as UTF-8 character sequences. This type is most often used by GraphQL to represent free-form human-readable text.

String formats

A few common types are represented as Strings throughout the API. They have a specific format.

Date Values

Date values are represented in YYYY-MM-DD format.

Date / Time Values

Date / Time values are represented in ISO-8601 format. That is, they take the form YYYY-MM-DDTHH:MM:SS.mmmZ.

Universal Resource Locators

Urls returned by the api are always absolute.

Expressions

When updating data, some fields can accept either a literal value, or an expression. In that case, the value should be in one of the following formats:

  1. ` `: An empty value clears out the existing value.
  2. =expression: Update the value dynamically based on the given expression.
  3. 'literal value: Update the value with the given literal value.
  4. literal value: If none of the other formats match, treat the string as a literal value.

To escape a leading ' in the input string, use two apostrophes: ''.

Updated on September 9, 2025

Related Articles