Daptics GraphQL API

Table of Contents * [Query](#query) * [Mutation](#mutation) * [Objects](#objects) * [Analytics](#analytics) * [AnalyticsFileInfo](#analyticsfileinfo) * [ApiParameters](#apiparameters) * [AuthenticationToken](#authenticationtoken) * [CampaignInfo](#campaigninfo) * [CategorizedError](#categorizederror) * [DataFrame](#dataframe) * [ExperimentalSpace](#experimentalspace) * [ExperimentalSpaceTemplate](#experimentalspacetemplate) * [Experiments](#experiments) * [GenerateTaskResult](#generatetaskresult) * [HaltSessionResult](#haltsessionresult) * [Loadavg](#loadavg) * [PasswordChanged](#passwordchanged) * [Server](#server) * [Session](#session) * [SessionAuth](#sessionauth) * [SessionParameters](#sessionparameters) * [SessionSummary](#sessionsummary) * [SimulateTaskResult](#simulatetaskresult) * [SpaceTaskResult](#spacetaskresult) * [Task](#task) * [TaskProgress](#taskprogress) * [TaskSummary](#tasksummary) * [TokenSent](#tokensent) * [Transaction](#transaction) * [UpdateTaskResult](#updatetaskresult) * [User](#user) * [UserCreated](#usercreated) * [UserProfile](#userprofile) * [UserSummary](#usersummary) * [Inputs](#inputs) * [AdditionalParameterInput](#additionalparameterinput) * [ChangePasswordInput](#changepasswordinput) * [DataFrameInput](#dataframeinput) * [ExperimentsInput](#experimentsinput) * [NewSessionInput](#newsessioninput) * [NewUserInput](#newuserinput) * [SessionParametersInput](#sessionparametersinput) * [SpaceInput](#spaceinput) * [TaskInput](#taskinput) * [UserProfileInput](#userprofileinput) * [Scalars](#scalars) * [Boolean](#boolean) * [DateTime](#datetime) * [Float](#float) * [Int](#int) * [String](#string)

Query (RootQueryType)

Field Argument Type Description
currentTask Task

Get the progress (if not completed) or the result (if completed) of the last un-archived task in the session. For non-admin users, returns information only if the session is owned by the user.

sessionId String!

The session's id.

taskId String

If provided, only returns information if the task's id matches.

type String

If provided, only returns information if the task's type ('space', 'generate', 'update', or 'simulate') matches.

experiments Experiments

Get the designed or completed experiments for the current or a previous generation. For non-admin users, returns information only if the session is owned by the user.

designOnly Boolean!

If this argument is true, return only the designed experiments, not any extra experiments, and without responses.

gen Int

(optional) The generation number to fetch. Use zero to get any initial experiments. Return the latest designed generation (without responses) if omitted.

sessionId String!

The session's id.

experimentsHistory [Experiments]

Get the experiments and responses for all generations. For non-admin users, returns information only if the session is owned by the user.

sessionId String!

The session's id.

server Server

Get the server by id. Admin-level users only.

serverId String!

The server's id (unique name, like 'localhost').

servers [Server]

Search all servers. Admin-level users only.

q String

A string to filter search on. If provided, will limit the response to matches on a server's name or url.

status String

Status to filter search on ('up' or 'down'). If provided, will limit the response to matches on a server's current runtime status.

session Session

Get PDT session information. For admin-level user, get the session by id. For non-admin user, get the session only if it is owned by the user.

sessionId String!

The session's id.

sessionParameters SessionParameters

Get the experimental space and project parameters for a given session. For non-admin users, returns information only if the session is owned by the user.

sessionId String!

The session's id.

sessions [SessionSummary]

Search sessions. For Admin-level users, returns search over all sessions.

q String

A string to filter search on. If provided, will limit the response to matches on session's id, tag, name or description.

userId String

If provided, list only the sessions for this user.

tasks [Task]

Get list of all, or just un-archived tasks in the session. For non-admin users, returns information only if the session is owned by the user.

includeArchivedTasks Boolean!

If false, limits the response to tasks that have not completed.

sessionId String!

The session's id.

transaction Transaction

Get the transaction by id. Admin-level users only.

txnId String!

The transaction's id.

transactions [Transaction]

Search transactions. For Admin-level users, returns search over all transactions.

q String

A string to filter search on. If provided, will limit the response to matches on the transaction's memo.

sessionId String

If provided, list only the transactions for this session.

txnKind String

If provided, list only the transactions matching this kind.

txnStatus String

If provided, list only the transactions matching this status.

txnType String

If provided, list only the transactions matching this type.

userId String

If provided, list only the transactions for this user.

user User

For admin-level user, get a user by id. For non-admin user, return the currently logged-in user if the user_id matches.

userId String!

The user's id (a generated base-36 hash).

users [UserSummary]

For admin-level user, search all users. For non-admin user, returns a list containing just the currently logged-in user.

q String

A string to filter search on. If provided, will limit the response to matches on a user's first name, last name or email address.

Mutation (RootMutationType)

Field Argument Type Description
changePassword PasswordChanged

Change a user's password, authenticating via header or password change token.

input ChangePasswordInput!

The data used to authenticate and set the new password.

userId String

The user's id, required if not authenticating via token.

createAnalytics Analytics

Generate a list of analytics files for all generations in the session.

sessionId String!

The session's id.

createSession Session

Create and start a new PDT session on a server, installing and initializing required application and user data files on the server.

session NewSessionInput!

The target server, the session's name and description, and whether this is a demo or regular session.

createUser UserCreated

Create an unverified user account. The account's email address must be verified before it is activated.

createToken Boolean

If true, an email message with a verification link will be mailed to the user.

promotionCode String

If present, the promotion code that will be applied to the new user.

user NewUserInput!

The first name, last name, email address and password for the new user.

generateDesign Task

Start a 'generate' task using initial, extra and/or generated experiment responses.

gen Int!

The generation number of the previously validated experiments and responses.

sessionId String!

The session's id.

haltSession HaltSessionResult

Disconnect from a previously created PDT session.

sessionId String!

The sesssion's id as returned by the createSession mutation.

login AuthenticationToken

Log in a user by email and password. Use the returned token to authenticate other requests. Use the returned user_id to create new sessions.

email String!

The user's email address.

password String!

The user's password (in cleartext).

logout AuthenticationToken

Log out a user, by revoking the access token. Returns information about the revoked token.

token String!

The access token to revoke.

putExperimentalParameters Task

Validate and start a 'space' task to save a session's experimental space parameters (space type, population size, replicates, total volume and experimental parameter definitions).

params SessionParametersInput!

The experimental space parameters to use for the session.

sessionId String!

The session's id.

putExperiments Experiments

Validate initial, extra and/or generated experiment responses.

experiments ExperimentsInput!

The experiments and responses to validate and save.

sessionId String!

The session's id.

restartSession Session

Restart a previously created PDT session, re-initializing application and user data files.

sessionId String!

The sesssion's id as returned by the createSession mutation.

runSimulation Task

Validate and start a 'simulate' task to process several design generations.

ngens Int!

The number of design generations to attempt.

params SessionParametersInput!

The experimental space parameters to use for the session.

sessionId String!

The session's id.

sendToken TokenSent

Create and send a new verification or password reset token to a user.

email String!

The user's email address.

tokenType String!

The type of token requested (verify or reset).

simulateResponses Experiments

Generate simulated experiment responses for the current generation.

experiments DataFrameInput

(Optional) The experiments for which responses will be generated, including initial or extra experiments.

sessionId String!

The session's id.

updateTask Task

Update, cancel or archive a task. For advanced users only!

sessionId String!

The session's id.

task TaskInput!

The task id and disposition.

updateUserProfile UserProfile

Update the user's profile.

profile UserProfileInput!

The first name, last name, email address and other information about the user.

userId String!

The user's id.

verifyUser UserProfile

Verify and activate an inactive user account. If successful (token matches and has not expired and user account is inactive), return the user account profile. Normally, verification tokens are sent to a non-API endpoint, but this mutation can also be used.

token String!

The verification token that was emailed to the user.

Objects

Analytics

Information about the analytics files available for the specified generation in a session.

Field Argument Type Description
files [AnalyticsFileInfo] The list of available file titles and locations.
gen Int! The last completed generation number.
sessionId String! The session's id.

AnalyticsFileInfo

Information about a single analytics file (PDF).

Field Argument Type Description
filename String! The file's name, like 'RespSortBarplotSequence.pdf'.
title String! The file's title, like 'Response Barplot Time Series'.
url String! The file's url, like 'http://localhost:4041/session/sess_id/analytics/gen/1/RespSortBarplotSequence.pdf'.

ApiParameters

Parameters that a session must use to access other resources.

Field Argument Type Description
apiBaseUri String! The URL for the session user to use to access the API.
apiKey String! The 'API key' for the session user to use to authenticate to the API.
loginUri String! The URL for the session user to use to log in.

AuthenticationToken

A user access (a JWT encoded and signed) token, used to authenticate to the API.

Field Argument Type Description
claims String! All the claims stored in the token.
createdAt DateTime! The date and time that the token was created.
expiresAt DateTime! The date and time that the token will expire.
status String! The status of the the token ('active' or 'revoked').
token String! The token. Use this as the 'Bearer' value for the HTTP authorization header.
type String! The type of token ('access').
user UserProfile The user account associated with this token.

CampaignInfo

Information on current and remaining generations.

Field Argument Type Description
completed Boolean! True if the campaign has completed (no additional experiments can be generated).
gen Int! The generation number for the last-designed generation. -1 means experimental space parameters have not been validated.
remaining Int The number of remaining generations in the session, if available.

CategorizedError

An error encountered while processing a query or mutation.

Field Argument Type Description
category String The type of error.
fatalError Boolean True if the error is fatal.
message String! A description of the error.
systemError Boolean True if the error is an internal system error.

DataFrame

A representation of a data table (similar to a CSV file). Numerical data is converted to strings, and NULL data is converted to empty strings.

Field Argument Type Description
colHeaders [String]! The header row for the table.
data [[String]!]! A list of rows containing data. Each row in turn is a list of strings.
index [String] If returned, the row names for table.

ExperimentalSpace

The definition for a session's experimental space.

Field Argument Type Description
spaceSize Int The number of possible or explorable parameter combinations.
table DataFrame! The table of experimental parameters.
totalUnits Int For mixture spaces, the total number of volume units.
type String! The space's type ('factorial' or 'mixture').

ExperimentalSpaceTemplate

A system-defined template for an experimental space.

Field Argument Type Description
name String! The type of template, ('factorial-default', 'mixture-default', 'factorial-demo-default', or 'mixture-demo-default').
template ExperimentalSpace! The experimental space parameters for this template.

Experiments

Information about initial or subsequent experiments in a session.

Field Argument Type Description
designRows Int The number of experiments generated by the system.
gen Int! The generation number for the experiments.
hasResponses Boolean True if the experiment data in the associated table contains responses.
table DataFrame The experiment inputs (and possible responses) for the experiments.
validated Boolean True if the experiment data for this generation has been validated.

GenerateTaskResult

Result of a validate experiments task.

Field Argument Type Description
campaign CampaignInfo! Generation information.
errors [CategorizedError] Errors encountered when validating the experiments.
experiments Experiments Designed experiments for current generation.
params SessionParameters! Current validated experimental space parameters.
sessionId String! The session's id.
taskId String! The task's id.
type String! The task's type ('generate').

HaltSessionResult

Information about a session that was disconnected.

Field Argument Type Description
action String! The action taken to halt the session.
sessionId String! The session's id.
status String! The current connection status of the session.

Loadavg

Process loadavg statistics for a linux server.

Field Argument Type Description
load1 Float 1 minute loadavg.
load15 Float 15 minute loadavg.
load5 Float 5 minute loadavg.

PasswordChanged

Confirming information for a password change.

Field Argument Type Description
updatedAt DateTime! The time that the password was updated.

Server

Information about a PDT server.

Field Argument Type Description
bindir String! The server's filesystem path to basic executable scripts (deprecated).
cores Int The number of cores reported for the server.
cost Float The last calulated cost metric for the server.
host String! The server's fully qualified hostname.
loadavg Loadavg The last reported loadavg statistics for the server.
procs Int The last reported number of processes running on the server.
serverId String! The server's id (a unique nickname or unqualified hostname).
sshHost String! The server's SSH hostname (deprecated).
status String! The server's current runtime status ('up' or 'down').
updatedAt DateTime! The date and time that the data for the server was last updated.
url String! The server's root URL.

Session

Complete information about a session.

Field Argument Type Description
active Boolean! True if this is an active (non-archived) session.
api ApiParameters! API location and key information.
auth SessionAuth Authorization information, if available.
campaign CampaignInfo! Generation information.
demo Boolean! True if this was created as a demo session.
description String! The session's description.
didCrash Boolean! True if this session crashed.
didRestart Boolean! True if this session was restarted.
experiments Experiments Designed experiments for current generation.
host String! The id for the server associated with the session.
latestCompletedExperiments Experiments Completed experiments from the previous generation.
name String! The session's name (unique for the associated user).
params SessionParameters! Current unvalidated or validated experimental space parameters.
path String! The filesytem path on the server associated with the session that contains the session's system and user data files.
platformMode String! Settings for the runtime platform (`development`, `test` or `production`).
restartedAt DateTime The date and time that this session was last restarted.
sessionId String! The session's id.
spaceTemplates [ExperimentalSpaceTemplate!]! Experimental space parameter templates that can be used as examples.
startedAt DateTime True if the campaign has completed (no additional experiments can be generated).
tag String! The session's (unique) tag.
tasks [TaskSummary] Non-archived tasks, active or completed, in this session.
user UserProfile The user profile associated with the session.
version String The build version for the session, if available.

SessionAuth

Information about the access token for the session.

Field Argument Type Description
expirationTime Int (TBD)
message String (TBD)
status String! The status of the the token ('active' or 'revoked').
token String! The token.

SessionParameters

Information about the experimental space parameters for a PDT session.

Field Argument Type Description
designCost Int If the experimental space has been validated, the cost in PDT credits for each design generation.
populationSize Int! The experimental space's population size.
replicates Int! The number of replicates for the experimental space.
space ExperimentalSpace! The experimental space type and parameters.
validated Boolean! True if the session parameters (including the space) were validated.

SessionSummary

Summary information about a session.

Field Argument Type Description
active Boolean! True if this is an active (non-archived) session.
campaign CampaignInfo Generation information, if available.
demo Boolean! True if this was created as a demo session.
description String! The session's description.
host String! The id for the server associated with the session.
name String! The session's name (unique for the associated user).
params SessionParameters Current unvalidated or validated experimental space parameters, if available.
path String! The filesytem path on the server associated with the session that contains the session's system and user data files.
sessionId String! The session's id.
tag String! The session's (unique) tag.
user UserProfile The user profile associated with the session.
version String The build version for the session, if available.

SimulateTaskResult

Result of a simulate experiments task.

Field Argument Type Description
campaign CampaignInfo! Information on the last generation.
errors [CategorizedError] Errors encountered when validating the experimental space.
experimentsHistory [Experiments] Experiments and responses for all generations.
params SessionParameters! Current validated experimental space parameters.
sessionId String! The session's id.
taskId String! The task's id.
type String! The task's type ('simulate').

SpaceTaskResult

Result of a validate experimental space parameters task.

Field Argument Type Description
campaign CampaignInfo! Generation information.
errors [CategorizedError] Errors encountered when validating the experimental space.
params SessionParameters! Current validated experimental space parameters.
sessionId String! The session's id.
taskId String! The task's id.
type String! The task's type ('space').

Task

Information on a long-running task in a daptics session.

Field Argument Type Description
archived Boolean! True if the task is no longer active and has been flagged as archived.
description String The task's description.
errors [CategorizedError] Errors returned by a failed or canceled task.
progress TaskProgress Progress message reported by a currently executing task.
result TaskResult The validated session parameters or generated experimental design result returned by a completed task.
sessionId String! The session's id.
startedAt DateTime The date and time the task was started.
status String! The task's status ('new', 'running', 'success', 'error', or 'canceled').
taskId String! The task's id.
type String! The task's type ('space', 'generate', 'update', or 'simulate').

TaskProgress

Progress information about a currently executing task.

Field Argument Type Description
message String! A description of the last activity returned by the task.
percent Int (TBD)
phase String (TBD)

TaskSummary

Summary information on a long-running task in a daptics session.

Field Argument Type Description
description String The task's description.
sessionId String! The session's id.
startedAt DateTime The date and time the task was started.
status String! The task's status ('new', 'running', 'success', 'error', or 'canceled').
taskId String! The task's id.
type String! The task's type ('space', 'generate', 'update', or 'simulate').

TokenSent

Confirming information returned when a verification code was sent to an unverified user.

Field Argument Type Description
sentAt DateTime! The time when the code was delivered.
sentTo [String!]! The email address(es) the code was delivered to.
tokenType String! The type of token sent to the user.

Transaction

Information about a single pending, posted, or canceled financial transaction.

Field Argument Type Description
amountInCents Int! The amount of the transaction (debit as negative, credit as positive), in cents.
amountInPdt Int! The amount of the transaction (debit as negative, credit as positive), in PDT credits.
createdAt DateTime! The date and time that the transaction was created.
gatewayTransactionId String The payment processor's transaction id, if any.
memo String! A description of the transacation.
promotionCode String The promotion code, if any.
refTxnId String The transaction id of the original transaction if this is transaction is a refund.
remainingBalanceInCents Int The user account's remaining available balance, in cents, after this transaction.
remainingBalanceInPdt Int The user account's remaining available balance, in PDT credits, after this transaction.
sessionId String The id of the associated session, if any.
taskId String The id of the ('generate') task associated with the transaction, if any.
txnAuthor String! The user id of the user who created the transaction.
txnId String! The transaction's id (a generated hash).
txnKind String! The kind of the transaction. (`pdt_charge`, `sale`, `refund`, `sign_up`, `coupon`, or `bonus`).
txnStatus String! The status of the transaction (`authorized`, `posted`, or `canceled`).
txnType String! The type of the transaction. (`session`, `braintree`, `promotion` or `admin`).
updatedAt DateTime! The date and time that the transaction was last updated.
user UserProfile! Profile and activity information for the associated user's account.

UpdateTaskResult

Result of a save experiments task.

Field Argument Type Description
campaign CampaignInfo! Generation information.
errors [CategorizedError] Errors encountered when validating the experiments.
experiments Experiments Validated experiments saved in current generation.
params SessionParameters! Current validated experimental space parameters.
sessionId String! The session's id.
taskId String! The task's id.
type String! The task's type ('update').

User

Full information for a user account.

Field Argument Type Description
addr String The first line of the user's address.
addr2 String The second line of the user's address.
addr3 String The third line of the user's address.
city String The user's city.
company String The user's company.
country String The user's country code (4 characters maximum).
currentBalanceInCents Int! The currently available balance for the user's account, in cemts.
currentBalanceInPdt Int! The currently available balance for the user's account, in PDT credits.
email String! The user's email address.
firstName String! The user's first name.
lastLoginAt DateTime The date and time that the user account last logged into a PDT session.
lastName String! The user's last name.
phone String The user's telephone number.
regDate DateTime! The date and time that the user's account was created.
sessions [SessionSummary]! The sessions owned by the user.
state String The user's state or province code (3 characters maximum).
status String! The user's account status ('unverified', 'active', or 'disabled').
suffix String The user's suffix (`Jr.`, etc.).
title String The user's title (`Mr.`, etc.).
updatedAt DateTime! The date and time that data in the user's account was last updated.
userId String! The user's id.
userLevel String! The user's permission level.
zip String The user's postal code.

UserCreated

Confirming information returned when a user account was successfully created.

Field Argument Type Description
email String The new user's email address.
firstName String The new user's first name.
lastName String The new user's last name.
promotionCode String The promotion code applied to the new user account.
regDate DateTime! The date and time that the new user's account was created.

UserProfile

Profile information for a user account.

Field Argument Type Description
addr String The first line of the user's address.
addr2 String The second line of the user's address.
addr3 String The third line of the user's address.
city String The user's city.
company String The user's company.
country String The user's country code (4 characters maximum).
email String! The user's email address.
firstName String! The user's first name.
lastName String! The user's last name.
phone String The user's telephone number.
regDate DateTime! The date and time that the user's account was created.
state String The user's state or province code (3 characters maximum).
suffix String The user's suffix (`Jr.`, etc.).
title String The user's title (`Mr.`, etc.).
userId String! The user's id.
zip String The user's postal code.

UserSummary

Profile and activity information for a user account.

Field Argument Type Description
addr String The first line of the user's address.
addr2 String The second line of the user's address.
addr3 String The third line of the user's address.
city String The user's city.
company String The user's company.
country String The user's country code (4 characters maximum).
currentBalanceInCents Int! The currently available balance for the user's account, in cemts.
currentBalanceInPdt Int! The currently available balance for the user's account, in PDT credits.
email String! The user's email address.
firstName String! The user's first name.
lastLoginAt DateTime The date and time that the user account last logged into a PDT session.
lastName String! The user's last name.
phone String The user's telephone number.
regDate DateTime! The date and time that the user's account was created.
state String The user's state or province code (3 characters maximum).
status String! The user's account status ('unverified', 'active', or 'disabled').
suffix String The user's suffix (`Jr.`, etc.).
title String The user's title (`Mr.`, etc.).
updatedAt DateTime! The date and time that data in the user's account was last updated.
userId String! The user's id.
userLevel String! The user's permission level.
zip String The user's postal code.

Inputs

AdditionalParameterInput

An advanced experimental space parameter.

Field Type Description
jsonValue String! The parameter's value, encoded as a JSON string.
name String! The parameter name.

ChangePasswordInput

Input fields for changing the password on a user account.

Field Type Description
email String The user's email address, required if changing via token authentication.
password String! The cleartext password for the user account.
passwordConfirmation String! The cleartext password, again, for the user account.
token String The password change token, required if changing via token authentication.

DataFrameInput

Table data for experimental parameters or experimental responses (similar to a CSV file).

Field Type Description
colHeaders [String!]! Column headers for the table.
data [[String]!]! Data rows for the table. Each row is a list of strings. Numerical data must be expressed as a string, and a NULL value must be expressed as an empty string.
index [String!] Row names for the table (ignored).

ExperimentsInput

Input fields for submitting experimental responses to be validated to then to create the next design gneration.

Field Type Description
gen Int! The current generation number. Use zero to submit initial experiments or just to proceed to the first design generation without any initial experiments.
table DataFrameInput The experiments and their responses. Required if gen is greater than zero.
type String! The type of experiments being submitted, 'initial', 'designed', or 'final'.

NewSessionInput

Input fields for create a new PDT session.

Field Type Description
demo Boolean! True if this is a demo session.
description String! A description for the session.
location String If provided, the id of the server on which the session will be created.
name String! The name of the session (unique for the user).
userId String! The id for the associated user account.

NewUserInput

Input fields for creating a new user account.

Field Type Description
email String! The user's email address.
firstName String! The user's first name.
lastName String! The user's last name.
password String! The cleartext password for the user account.
passwordConfirmation String! The cleartext password, again, for the user account.

SessionParametersInput

Input fields for validating a session's experimental space parameters.

Field Type Description
additionalParams [AdditionalParameterInput] Additional advanced parameters for modeling and sampling.
populationSize Int! The population size.
replicates Int! The number of replicates (zero or greater).
space SpaceInput! The space type and definition of experimental parameters.
willResetCampaign Boolean True to discard all experiments and reset any existing validated experimental space parameters.

SpaceInput

Input fields for validating an experimental space.

Field Type Description
table DataFrameInput! The experimental parameters, in a table.
totalUnits Int If a mixture space, the total number of volume units.
type String! The space type, 'factorial' or 'mixture'.

TaskInput

Input fields for updating or archiving a task.

Field Type Description
archived Boolean To archive this task, set the `archived` field to true.
status String To cancel this task, set the `status` field to 'canceled'.
taskId String! The task's id.

UserProfileInput

Profile information for a user account.

Field Type Description
addr String The first line of the user's address.
addr2 String The second line of the user's address.
addr3 String The third line of the user's address.
city String The user's city.
company String The user's company.
country String The user's country code (4 characters maximum).
email String The user's email address.
firstName String The user's first name.
lastName String The user's last name.
phone String The user's telephone number.
state String The user's state or province code (3 characters maximum).
suffix String The user's suffix (`Jr.`, etc.).
title String The user's title (`Mr.`, etc.).
zip String The user's postal code.

Scalars

Boolean

The Boolean scalar type represents true or false.

DateTime

The DateTime scalar type represents a date and time in the UTC timezone. The DateTime appears in a JSON response as an ISO8601 formatted string, including UTC timezone ("Z"). The parsed date and time string will be converted to UTC and any UTC offset other than 0 will be rejected.

Float

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Int

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^53 - 1) and 2^53 - 1 since it is represented in JSON as double-precision floating point numbers specified by IEEE 754.

String

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.