Validate launch

Checks whether the launch can be published. Returns valid plus, per campaign, the missing required assets and the structural errors on each campaign, ad set and ad, each with an inputId and message. Changes nothing.

GET

/v1/brands/{brandId}/launches/{launchId}/validation

Authorization

bearerAuth

headerAuthorizationBearer <token>

An organization API key (koast_sk_…) with the API surface enabled, or an OAuth access token issued by Koast (koast_at_…) whose audience covers this API. REST access requires an active Agency plan.

Path Parameters

brandId*integer

The brand the request acts on. Every brand-scoped resource lives under its brand.

launchId*string

The campaign launch (batch) id.

Response Body

Validate launch

application/json

response

valid*boolean

results*array<>

[key: string]?unknown

curl -X GET "https://example.com/v1/brands/0/launches/string/validation" \  -H "Authorization: Bearer koast_sk_..."

{  "valid": true,  "results": [    {      "campaignId": "string",      "errors": {        "campaignErrors": [          {            "inputId": "string",            "message": "string",            "property1": null,            "property2": null          }        ],        "adsetErrors": {          "property1": [            {              "inputId": "string",              "message": "string",              "property1": null,              "property2": null            }          ],          "property2": [            {              "inputId": "string",              "message": "string",              "property1": null,              "property2": null            }          ]        },        "adErrors": {          "property1": [            {              "inputId": "string",              "message": "string",              "property1": null,              "property2": null            }          ],          "property2": [            {              "inputId": "string",              "message": "string",              "property1": null,              "property2": null            }          ]        },        "invariantErrorCount": 0,        "property1": null,        "property2": null      },      "property1": null,      "property2": null    }  ],  "property1": null,  "property2": null}

Required scope: read. CLI: koast validate-launch, see Launches commands. Authentication, headers, errors and pagination work the same on every operation. See Conventions.