Edit

POST Cancel Confirmed Item

Allows the partner to cancel a previously purchased (confirmed) item. Rokt will call the relevant provider to make a cancellation and relay back its response.

Description

Sample request:

POST /v1/confirmation/cancel
{
    "itemReservationId": "rokt_item_reservation_id.63a94103-75da-4d71-8c14-84674d286b98"
}

Request

Path

POST /v1/Confirmation/cancel

Parameters

Name	Type	In	Description	Required	Example
rokt-api-key		header	API authentication key	true	skeletonkey
Content-Type		header	Media type of request, 'application/json' is the only supported value at the moment		application/json
Accept		header	Expected media type of response, 'application/json' is the only supported value at the moment		application/json
Accept-Language		header	Expected locale of the consumer. This can be the full locale including language and country, or a neutral locale which only has the language. When locale is specified only placements and offers that match the locale are included for consideration.		en-US

Request Body

Example Value

Schema

{
  "itemReservationId": "string"
}

Object {

itemReservationId: String

}

Response

200 OK

Error

400 BadRequest

Example Value

Schema

{
  "description": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "value": {}
    }
  ]
}

Object {

description: String

errors: Array [

Object {

code: String

message: String

value: Object {}

}

]

}

401 Unauthorized

403 Forbidden

Example Value

Schema

{
  "description": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "value": {}
    }
  ]
}

Object {

description: String

errors: Array [

Object {

code: String

message: String

value: Object {}

}

]

}

422 UnprocessableEntity

Example Value

Schema

{
  "description": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "value": {}
    }
  ]
}

Object {

description: String

errors: Array [

Object {

code: String

message: String

value: Object {}

}

]

}

500 InternalServerError

Example Value

Schema

{
  "description": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "value": {}
    }
  ]
}

Object {

description: String

errors: Array [

Object {

code: String

message: String

value: Object {}

}

]

}

504 GatewayTimeout

Example Value

Schema

{
  "description": "string",
  "errors": [
    {
      "code": "string",
      "message": "string",
      "value": {}
    }
  ]
}

Object {

description: String

errors: Array [

Object {

code: String

message: String

value: Object {}

}

]

}