Skip to content
  1. Home
  2. API errors
  3. This request needs an Idempotency-Key

This request needs an Idempotency-Key

IDEMPOTENCY_KEY_REQUIRED · HTTP 400

What it means

This operation only runs with an Idempotency-Key header. Firmary keeps a successful response for 24 hours. During that time, send the identical request with the same key and credential to get the saved response, while you still have access. That way the change is made only once.

What to do next

  • Make a new random key (a UUID is fine), send it in the Idempotency-Key header, and send the same key if you retry the same change.
  • For writes, firmary generates a key when you don’t supply one. If it gives you a retry key, pass it with --request-key.

Getting help

If you need help, email [email protected] and include the request ID if one is shown.

All API errors