Skip to main content

Documentation Index

Fetch the complete documentation index at: https://dev.1st.app/llms.txt

Use this file to discover all available pages before exploring further.

HTTP status: 400

Message

Generic; the specific message and the param field tell you which input was rejected. Example:
{
  "error": {
    "type": "invalid_request_error",
    "code": "validation_failed",
    "message": "`devices` must be a comma-separated list of device UUIDs.",
    "param": "devices",
    "doc_url": "https://dev.1st.app/errors/validation_failed",
    "request_id": "req_abc"
  }
}

Common cause

  • Wrong type for a body field (sent a string where an array was expected).
  • Unknown enum value.
  • Missing required body field.

Fix

Read the message field, it contains the FIX inline. If the param field is set, that’s the offending input.