Troubleshooting · Developer docs

Troubleshooting

Grouped by symptom, never by module, because the person with the problem does not know which module has it. One hundred questions across ten pages, each answered with the causes in the order they usually turn out to be true.

Answer API requests

Custom fields look lost after a write

Usually they are not: the answer to the write leaves them out. A write's answer lists the custom field rows as that request left them, so a field emptied in the request, and every row a customFieldValues list did not name, is missing from it while still stored. Read the record again to see what it holds.

Two cases do lose data:

  • Products, product categories and people take a customFieldValues list as the complete set, and delete the rows it leaves out.
  • null for a field empties it.

Writing by name avoids both: {"customFields": {"fieldName": value}} changes the fields named and nothing else, on every type that has custom fields.

See Custom fields and Sync values from another system into custom fields.

In the API reference: Edit a menu element.

More in API requests

  1. "Could not find the referenced record with id 0"
  2. A custom URL is set after creating the record, and cleared with an empty string
  3. My DELETE timed out: did it go through?
  4. My OAuth token stopped working after four hours: 403 "Token doesn't exist or is not valid"
  5. GraphQL answers 500 "Currently, only Query GraphQL requests are supported by this API"

Was this page helpful?

Your answer goes to the docs team.