OAG · Schema

PatchFlightInfoAlertsAlertsRequest

CompanyAviationDataAnalyticsTravel

Properties

Name Type Description
alertId string Alphanumeric characters generated on the creation of the alert.
name string Some text assigning a name to the alert.
description string Some text describing the purpose of the alert.
iataCarrierCode string A two-character code assigned by the IATA to international airlines. Optional unless updating an alert to alertType "Carrier", in which case iataCarrierCode and/or icaoCarrierCode must be supplied.
icaoCarrierCode string A three-character code assigned by the ICAO to international airlines. Optional unless updating an alert to alertType "Carrier", in which case iataCarrierCode and/or icaoCarrierCode must be supplied.
flightNumber integer A numeric part (up to four digits) of a flight designator.
fromFlight integer A numeric part (up to four digits) of a flight designator.
toFlight integer A numeric part (up to four digits) of a flight designator.
departureAirport string A Three-letter code assigned by the IATA to an airport location representing the departure airport. Optional unless updating an alert to alertType "Port", in which case departureAirport and/or arrival
arrivalAirport string A Three-letter code assigned by the IATA to an airport location representing the arrival airport. Optional unless creating an alert to alertType "Port", in which case departureAirport and/or arrivalAi
alertType string The type of alert being configured. Accepted values are "Global", "Carrier" or "Port".
active boolean A true/false value to enable/disable the alert.
content string If the string "seats, changeindicator" is specified, seat and change indicator data will be included in the alert output.
departureDate string A date in the format yyyy-MM-dd for flight departures.
arrivalDate string A date in the format yyyy-MM-dd for flight arrivals.
schedules boolean A true/false value to enable/disable the inclusion of schedules flight updates in the event feed.
status boolean A true/false value to enable/disable the inclusion of status flight updates in the event feed.
gaFlights boolean A true/false value to enable/disable the inclusion of GA flight updates in the event feed.
unscheduledFlights boolean A true/false value to enable/disable the inclusion of unscheduled flight updates in the event feed.
codeshare boolean A true/false value to enable/disable the inclusion of marketing flight updates in the event feed. Defaults to true.
estimatedArrivalTimeThreshold integer Positive or negative threshold for estimated arrival time.
estimatedDepartureTimeThreshold integer Positive or negative threshold for estimated departure time.
statusChangeFilters object Filters for specific status changes.
statusChangeFilters.baggage boolean If value is "false", will ignore flight updates that only have a change in baggage.
statusChangeFilters.aircraftRegistrationNumber boolean If value is "false", will ignore flight updates that only have a change in aircraftRegistrationNumber.
statusChangeFilters.gates boolean If value is "false", will ignore flight updates that only have a change in gates.
statusChangeFilters.terminal boolean If value is "false", will ignore flight updates that only have a change in terminal.
statusChangeFilters.seats boolean If value is "false", will ignore flight updates that only have a change in seats.
statusChangeFilters.aircraftType boolean If value is "false", will ignore flight updates that only have a change in aircraftType.
View JSON Schema on GitHub

JSON Schema

oag-patch-flight-info-alerts-alerts-request-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/oag/main/json-schema/oag-patch-flight-info-alerts-alerts-request-schema.json",
  "title": "PatchFlightInfoAlertsAlertsRequest",
  "x-generated": "2026-09-23",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/oag-openapi-generated.yml#/components/schemas/PatchFlightInfoAlertsAlertsRequest",
  "type": "object",
  "properties": {
    "alertId": {
      "type": "string",
      "description": "Alphanumeric characters generated on the creation of the alert."
    },
    "name": {
      "type": "string",
      "description": "Some text assigning a name to the alert."
    },
    "description": {
      "type": "string",
      "description": "Some text describing the purpose of the alert."
    },
    "iataCarrierCode": {
      "type": "string",
      "description": "A two-character code assigned by the IATA to international airlines. Optional unless updating an alert to alertType \"Carrier\", in which case iataCarrierCode and/or icaoCarrierCode must be supplied."
    },
    "icaoCarrierCode": {
      "type": "string",
      "description": "A three-character code assigned by the ICAO to international airlines. Optional unless updating an alert to alertType \"Carrier\", in which case iataCarrierCode and/or icaoCarrierCode must be supplied."
    },
    "flightNumber": {
      "type": "integer",
      "description": "A numeric part (up to four digits) of a flight designator."
    },
    "fromFlight": {
      "type": "integer",
      "description": "A numeric part (up to four digits) of a flight designator."
    },
    "toFlight": {
      "type": "integer",
      "description": "A numeric part (up to four digits) of a flight designator."
    },
    "departureAirport": {
      "type": "string",
      "description": "A Three-letter code assigned by the IATA to an airport location representing the departure airport. Optional unless updating an alert to alertType \"Port\", in which case departureAirport and/or arrivalAirport must be supplied."
    },
    "arrivalAirport": {
      "type": "string",
      "description": "A Three-letter code assigned by the IATA to an airport location representing the arrival airport. Optional unless creating an alert to alertType \"Port\", in which case departureAirport and/or arrivalAirport must be supplied."
    },
    "alertType": {
      "type": "string",
      "description": "The type of alert being configured. Accepted values are \"Global\", \"Carrier\" or \"Port\"."
    },
    "active": {
      "type": "boolean",
      "description": "A true/false value to enable/disable the alert."
    },
    "content": {
      "type": "string",
      "description": "If the string \"seats, changeindicator\" is specified, seat and change indicator data will be included in the alert output."
    },
    "departureDate": {
      "type": "string",
      "description": "A date in the format yyyy-MM-dd for flight departures."
    },
    "arrivalDate": {
      "type": "string",
      "description": "A date in the format yyyy-MM-dd for flight arrivals."
    },
    "schedules": {
      "type": "boolean",
      "description": "A true/false value to enable/disable the inclusion of schedules flight updates in the event feed."
    },
    "status": {
      "type": "boolean",
      "description": "A true/false value to enable/disable the inclusion of status flight updates in the event feed."
    },
    "gaFlights": {
      "type": "boolean",
      "description": "A true/false value to enable/disable the inclusion of GA flight updates in the event feed."
    },
    "unscheduledFlights": {
      "type": "boolean",
      "description": "A true/false value to enable/disable the inclusion of unscheduled flight updates in the event feed."
    },
    "codeshare": {
      "type": "boolean",
      "description": "A true/false value to enable/disable the inclusion of marketing flight updates in the event feed. Defaults to true."
    },
    "estimatedArrivalTimeThreshold": {
      "type": "integer",
      "description": "Positive or negative threshold for estimated arrival time."
    },
    "estimatedDepartureTimeThreshold": {
      "type": "integer",
      "description": "Positive or negative threshold for estimated departure time."
    },
    "statusChangeFilters": {
      "type": "object",
      "description": "Filters for specific status changes."
    },
    "statusChangeFilters.baggage": {
      "type": "boolean",
      "description": "If value is \"false\", will ignore flight updates that only have a change in baggage."
    },
    "statusChangeFilters.aircraftRegistrationNumber": {
      "type": "boolean",
      "description": "If value is \"false\", will ignore flight updates that only have a change in aircraftRegistrationNumber."
    },
    "statusChangeFilters.gates": {
      "type": "boolean",
      "description": "If value is \"false\", will ignore flight updates that only have a change in gates."
    },
    "statusChangeFilters.terminal": {
      "type": "boolean",
      "description": "If value is \"false\", will ignore flight updates that only have a change in terminal."
    },
    "statusChangeFilters.seats": {
      "type": "boolean",
      "description": "If value is \"false\", will ignore flight updates that only have a change in seats."
    },
    "statusChangeFilters.aircraftType": {
      "type": "boolean",
      "description": "If value is \"false\", will ignore flight updates that only have a change in aircraftType."
    }
  },
  "required": [
    "alertId"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/oag-patch-flight-info-alerts-alerts-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.