Delete Special Keywords

Delete Special Keywords (SK) from an existing booking. This endpoint removes previously added Special Keywords that are no longer needed or were added in error.

---

Endpoint

• URL: /api/v1/flight/deleteSK
• Method: POST
• Auth Required: Yes (Bearer Token/X-API-KEY)
• Content-Type: application/json

---

Authentication

This endpoint requires a valid JWT Bearer token in the Authorization header:

Authorization: Bearer <access_token>

Obtain tokens via /api/v1/sign-in (POST) with your credentials.

---

Request Structure

Field	Type	Required	Description
system	string	No	Booking system code (e.g., VN, VJ, 1A)
bookingCode	string	No	Booking code (PNR)
sKs	array	No	List of Special Keyword IDs to delete

Example Request:

{
  "system": "VN",
  "bookingCode": "ABC123",
  "sKs": [
    "SK001",
    "SK002"
  ]
}

---

Request Constraints & Business Rules

• Only bookings that exist and are eligible for update can have Special Keywords deleted.
• The bookingCode must match an existing booking.
• Special Keyword IDs must reference existing SK entries within the booking.
• Some SK entries may not be deletable depending on their origin or importance.
• System-generated SK entries may have different deletion rules than user-added entries.
• All changes are auditable via trackingId and trackingTime.

---

Response Structure

Field	Type	Nullable	Description
system	string	Yes	System name (e.g., VN, VJ, 1A)
status	boolean	No	true if successful, false if failed
error	object	Yes	Error details (if any)
description	string	Yes	Error description (if any)
trackingId	string	Yes	Tracking ID for request logs
trackingTime	string	Yes	Time for request tracking (ISO 8601 format)

Error Object

Field	Type	Nullable	Description
id	integer	No	Error code ID
message	string	Yes	Error message

Example Response:

{
  "system": "VN",
  "status": true,
  "error": null,
  "description": null,
  "trackingId": "abc-123",
  "trackingTime": "2024-06-01T12:00:00Z"
}

---

Error Codes

See Error Codes for details on possible error responses.

---

Security & Validation

• All input is validated for type and required fields.
• Only authenticated users can access this endpoint.
• Special Keyword IDs are validated against existing SK entries in the booking.
• All actions are logged and traceable.

---

Validation Questions

• How do you retrieve Special Keyword IDs from a booking to know which ones to delete?
• Are there restrictions on which SK entries can be deleted (system vs. user-created)?
• What happens if an SK ID doesn't exist in the booking?
• How are partial failures handled (some SK entries deleted, others not)?

---

For integration support, see Contact Support.