Update Flights

This lets you update flights.

Why Update Flights?

Occasionally you may find it useful to update an existing flight in your campaign to reflect changes in your campaign strategy. For example, you may wish to optimize your campaign by changing your GoalType or PriorityId to determine whether these changes positively impact the overall performance of the campaign.

📘

Note

You may update any flight field except id.

API Syntax

When using the Update Flight API, it is important to understand the syntax required to make the request. Because the Kevel API is a RESTful API, there is a specific request format that must be followed to ensure the endpoint can process the request. The format is:

PUT https://api.kevel.co/v1/flight/{flightId}

Where:

  • PUT - the type of API request being made.
  • https://api.kevel.co - the URL for the request.
  • v1 - the API version.
  • flight - the API endpoint being called.
  • flightId - the ID of the specific flight you wish to update.

Flight Fields

There are a number of fields that can be used when creating a flight. These fields are described in detail in the Flight Fields documentation.


Path Params
int32
required

This is the ID of the Flight

Query Params
boolean
Defaults to false

If true, the endpoint returns only the flight metadata without ad objects

Body Params
int32
required

The ID of the Flight

string
required

The name of the Flight

string
required

Start date in ISO 8601 format: YYYY-MM-DDTHH:MM:SS.SSSSSSS. You can also just use YYYY-MM-DD

string

End date in ISO 8601 format: YYYY-MM-DDTHH:MM:SS.SSSSSSS. You can also just use YYYY-MM-DD

boolean

If flight has no specified End Date, set to true

int32
required

The ID of the campaign

int32
required

The ID of the Priority

int32
required

This is the metric that Kevel uses to pace the ads so it hits the desired goal by the end date.  Key follows: 1 = Impressions 2 = Percentage 3 = Click 7 = Conversion 8 = Revenue 9 = Daily Revenue 10 = Monthly Revenue. Instructions are here

int32
required

The Goal Amount

boolean
required

Active/inactive state of the flight

boolean

If want to delete, set to true

boolean
Defaults to false

Specifies whether flight is archived.

BidModifiers
array of objects

See Bid Modifiers documentation for example usage.

BidModifiers
Response

Language
Credentials
Header
LoadingLoading…
Response
Choose an example:
application/json