Flavours API
Advertisement

Update Advertisement

POST
/api/v2/advertisements/{advertisementId}

Update a specific advertisement by its ID.

AuthorizationBearer <token>

You can retrieve your token by logging in.

In: header

Path Parameters

advertisementId*string

Header Parameters

X-API-Version*string

API contract version to target. See the Changelog for what changed in each version.

Default"2.0.0"
Value in"2.3.0" | "2.2.0" | "2.1.0" | "2.0.0"

Request Body

application/json

type?|

Advertisement type.

Value in"BANNER" | "SMS" | "WHATSAPP"
status?|

Advertisement status.

Value in"PROCESS" | "ACCEPTED" | "REJECTED" | "SUCCESS"
content?|

Advertisement content.

notes?|

Internal notes.

receiver_ids*array<>

Must match an existing stored value.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.flavours.sa/dev/api/v2/advertisements/ut" \  -H "X-API-Version: 2.3.0" \  -H "Content-Type: application/json" \  -d '{    "receiver_ids": [      "numquam"    ]  }'
{
  "meta": {
    "code": 200,
    "status": "success",
    "message": "Update Success"
  },
  "data": {
    "id": "1248c00e-58d2-4c66-95f0-a4e2d244ea32",
    "market_id": "848aa3f5-fc3d-42d3-8cc9-4c6edd0140d0",
    "type": "BANNER",
    "status": "PROCESS",
    "content": "https://via.placeholder.com/640x480.png/00dd33?text=tempore",
    "notes": "Magnam recusandae voluptatem illum animi qui.",
    "approved_by": "e479e18b-0ddc-4d1c-b052-d37174127f8e",
    "start_at": 1787446676172,
    "close_at": 1787533076172,
    "created_at": 1787446674747,
    "updated_at": 1787446678064
  }
}
{
  "meta": {
    "code": 401,
    "status": "error",
    "message": "Unauthenticated."
  },
  "data": null
}
{
  "meta": {
    "code": 403,
    "status": "error",
    "message": "Unauthorized."
  },
  "data": null
}
{
  "meta": {
    "code": 404,
    "status": "error",
    "message": "Resource not found."
  },
  "data": null
}
{
  "meta": {
    "code": 422,
    "status": "error",
    "message": "The selected type is invalid. (and 1 more error)"
  },
  "data": [
    {
      "code": 0,
      "message": "The selected type is invalid.",
      "field": "type"
    },
    {
      "code": 0,
      "message": "The selected status is invalid.",
      "field": "status"
    }
  ]
}
{
  "meta": {
    "code": 500,
    "status": "error",
    "message": "Internal server error."
  },
  "data": null
}