requestLoginOtp

Public: no authentication required.

Emails a one-time sign-in code, valid for 5 minutes, to a staff account. It returns true whether or not an account matches, so the response does not reveal which email addresses have accounts. Rate-limited per IP address. No sign-in needed.

Errors: a failed call returns a GraphQL errors entry, not a field on the result, and data may be null or partial. Read the entry's extensions.code and message; every shape and code is in the Error reference.

Example:

GraphQL

mutation RequestLoginOtp($requestOtpInput: RequestOtpInput!) {
  requestLoginOtp(requestOtpInput: $requestOtpInput)
}

cURL

curl -X POST "https://<api-host>/graphql" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  --data @- <<'EOF'
{
  "query": "mutation RequestLoginOtp($requestOtpInput: RequestOtpInput!) {\n  requestLoginOtp(requestOtpInput: $requestOtpInput)\n}",
  "variables": {
    "requestOtpInput": {
      "email": "string"
    }
  }
}
EOF

Variables:

{
  "requestOtpInput": {
    "email": "string"
  }
}

Response:

{
  "data": {
    "requestLoginOtp": true
  }
}

requestLoginOtp(
  requestOtpInput: RequestOtpInput!
): Boolean!

Arguments

requestLoginOtp.requestOtpInput ● RequestOtpInput! non-null input

The email address and the organization subdomain. When the subdomain is omitted, the request host decides the organization.

Type

Boolean scalar

The Boolean scalar type represents true or false.