Create or update a wait-time alert

Creates an alert, or updates the threshold if the key owner already has one for the airport. Requires a user-scoped key. The airport must have a live wait-time feed. Thresholds are 1 to 240 minutes. Each user can hold up to 20 alerts.

Access: User-scoped key (MCP OAuth or developer key).

POST

https://flightqueue.com/api/v1/alerts

Authorization

BearerAuth
optional
HTTP

ApiKeyAuth
optional
API key in header

Request body JSON required

airportCode
string
required
Three-letter IATA code of an airport with a live wait-time feed.

pattern: ^[A-Za-z]{3}$
thresholdMinutes
integer
required
Wait time in minutes that triggers the alert.

maximum: 240 · minimum: 1
direction
optional
above
or
below
Trigger when the wait is above or below the threshold.

default: "above"

Returns

200

Success

JSON

success
boolean
required
data
object
required
- alert
  object
  required
  id
  string
  required
  airportCode
  string
  required
  pattern: ^[A-Z]{3}$
  thresholdMinutes
  integer
  required
  maximum: 9007199254740991 · minimum: -9007199254740991
  direction
  above
  or
  below
  required
  createdAt
  string
  required
  ISO 8601 timestamp in UTC.
  
  format: date-time · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
}
meta
object
required
- requestId
  string
  required
  Unique ID for this request. Quote it when you contact support.
  
  format: uuid · pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
- timestamp
  string
  required
  ISO 8601 timestamp in UTC.
  
  format: date-time · pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
}

400

Bad request

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}

401

Unauthorized

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}

429

Too many requests

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}

500

Server error

JSON

success
boolean
required
error
object
required
- code
  MISSING_API_KEY
  or
  INVALID_API_KEY
  or
  RATE_LIMIT_EXCEEDED
  or
  PREMIUM_REQUIRED
  or
  ENTERPRISE_REQUIRED
  or
  INVALID_AIRPORT
  +5 more
  required
  Machine-readable error code.
- message
  string
  required
  Human-readable explanation.
}