Boost a resource (e.g., gym or training service) using a selected boost plan.
| Permission | Description |
|---|---|
payments.boost_own | Boost your own resources |
payments.boost_all | Boost any resource |
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
| boostable_type | string | Yes | Type of resource to boost (gym, training_service) | "gym" |
| boostable_id | int | Yes | ID of the resource to boost | 42 |
| plan | string | Yes | Name of the boost plan | "premium" |
Use /prices to get available plans and prices.
{
"boostable_type": "gym",
"boostable_id": 42,
"plan": "premium"
}
Returns the created marketing boost resource.
{
"id": 101,
"boostable_type": "App\\Models\\Gym",
"boostable_id": 42,
"plan": "premium",
"status": "active",
"starts_at": "2024-01-01T00:00:00Z",
"ends_at": "2024-01-31T23:59:59Z"
}
For a full schema, see Marketing Boost Resource.
| Status | Description | Example/Reference |
|---|---|---|
| 400 | Already have a boost | { "error": "You already have a boost" } |
| 400 | Insufficient balance | { "error": "Insufficient balance" } |
| 404 | Plan not found | { "error": "Plan not found" } |
| 422 | Validation error | Validation error |
| 500 | Purchase failed | { "error": "Purchase failed" } |
| 401 | Unauthorized | Authentication error |
| 403 | Forbidden (no permission) | Permission error |