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": "`sensors` must be an array of UUID strings. Omit the field to export all sensors in the team.",
    "param": "sensors",
    "doc_url": "https://docs.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 (e.g. state=closed when the allowed set is firing|acked|resolved|all).
  • 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.