AirHub API
  1. LAANC SDSP
AirHub API
  • Introduction
  • Authorization
    • Overview
    • Get Oauth Token
      POST
  • Advisories
    • Advisory
      POST
    • Get Advisories BBox
      GET
    • Get Advisories GeoJSON
      POST
  • Briefing
    • Overview
    • B4UFLY
      • What Is B4UFLY
      • The API Basics
      • Location vs Area
      • v1
        • B4UFLY Briefing by Area v1
        • B4UFLY Briefing by Location v1
      • v2
        • What's New in v2
        • B4UFLY Briefing by Area v2
        • B4UFLY Briefing by Location v2
  • LAANC SDSP
    • Overview
    • ASL Operations
      • List Operations
      • Create Operation
      • Get Operation
      • Delete Operation
      • Update Operation
    • LAANC Operations
      • Get Operation
      • Delete Operation
      • Create Operation
      • Update Operation
    • LAANC Authorizations
      • Rescinded and Invalid Operations
      • Submit Authorization
      • Get Authorization
      • Cancel Authorization
      • Cancel Invalid Authorization
      • Close Authorization
      • Acknowledge Rescinded Authorization
    • Operation v2
      POST
    • Create Ephemeral Operations
      POST
  • Risk
    • Get Hazard
      POST
    • Get Hazard Ground Type
      POST
    • Get Hazard Ground Risk
      POST
  • Aviation
    • Aviation
      POST
  • Surface
    • Suitability
      POST
    • Classification Surface
      POST
    • Surface v2 GeoJSON
      POST
    • Surface v2 Hexbin
      POST
  • Route
    • Route v2
  • Check
    • Check Airspace
    • Get Status
  • Elevation - NEW
    • Elevation
  • Map Vector Tiles - NEW
    • Overview
    • Styled Tiles
    • Vector Tile
  1. LAANC SDSP

Create Ephemeral Operations

Sandbox
https://airhub-api-sandbox.airspacelink.com
Sandbox
https://airhub-api-sandbox.airspacelink.com
POST
/v1/operations/ephemeral
Ephemeral Operations
Last modified:2024-10-17 12:02:49
Scope: operation:create
This method will create a new Ephemeral Operation.

Request

Body Params application/json
name
string 
required
The name for this operation
flightType
enum<string> 
required
Allowed values:
FLIGHT_TYPE_UNSPECIFIEDFLIGHT_TYPE_RECREATIONALFLIGHT_TYPE_COMMERCIAL
Default:
FLIGHT_TYPE_UNSPECIFIED
maxAltitude
integer <int32>
required
The max altitude for the flight volume. Must be greater than or equal to min altitude.
fixedAltitude
boolean 
optional
Whether this operation will fly at a fixed altitude throughout its entirety
callbackUrl
string 
optional
URL that will recieve notifications when this operation has a status change
timezoneName
string 
required
The timezone in which this operation will take place in IANA Time Zone format. Used only as a display helper in client applications.
startTime
string <date-time>
required
The start time for this operation in RFC 3339 UTC format
duration
integer <int32>
required
Duration of this operation in minutes
boundary
object 
required
The geographic boundary for this operation represented in GeoJSON Polygon format
Example
{
    "boundary": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    -78.55714924875102,
                    38.15773996731016
                ],
                [
                    -78.55714924875102,
                    38.121934862230276
                ],
                [
                    -78.51075174761395,
                    38.121934862230276
                ],
                [
                    -78.51075174761395,
                    38.15773996731016
                ],
                [
                    -78.55714924875102,
                    38.15773996731016
                ]
            ]
        ]
    },
    "name": "Operation 97",
    "flightType": "FLIGHT_TYPE_RECREATIONAL",
    "maxAltitude": 200,
    "fixedAltitude": false,
    "callbackUrl": "https://myurl.com/operation/1234",
    "timezoneName": "America/New_York",
    "startTime": "2024-08-23T20:25:00.000Z",
    "duration": 55
}

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://airhub-api-sandbox.airspacelink.com/v1/operations/ephemeral' \
--header 'Content-Type: application/json' \
--data-raw '{
    "boundary": {
        "type": "Polygon",
        "coordinates": [
            [
                [
                    -78.55714924875102,
                    38.15773996731016
                ],
                [
                    -78.55714924875102,
                    38.121934862230276
                ],
                [
                    -78.51075174761395,
                    38.121934862230276
                ],
                [
                    -78.51075174761395,
                    38.15773996731016
                ],
                [
                    -78.55714924875102,
                    38.15773996731016
                ]
            ]
        ]
    },
    "name": "Operation 97",
    "flightType": "FLIGHT_TYPE_RECREATIONAL",
    "maxAltitude": 200,
    "fixedAltitude": false,
    "callbackUrl": "https://myurl.com/operation/1234",
    "timezoneName": "America/New_York",
    "startTime": "2024-08-23T20:25:00.000Z",
    "duration": 55
}'

Responses

🟢200OK
application/json
A successful response.
Body
url
string 
required
URL that can be used to claim the Ephemeral Operation at a later time
Example
{
    "url": "https://portal.airspacelink.com/plan/operations/81042622-4f02-4e85-a896-172edd5381b6/claim"
}
🟠403Forbidden
🟠404Record Not Found
🔴500Server Error
Previous
Operation v2
Next
Get Hazard
Built with