GET /api/v2/ads/launches/{id}
Needs the ads:read scope.
- Auth: API key (Authorization: Bearer)
- Key scope needed:
ads:read - Raw spec: https://app.diffusr.ai/api/v2/openapi.json
Path
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | The job id from a make call. |
Example
curl "https://app.diffusr.ai/api/v2/ads/launches/LAUNCH_ID" \ -H "Authorization: Bearer $DIFFUSR_KEY"Response
200 ApiAdsLaunch
The launch and where it stands.
| Name | Type | Required | Description |
|---|---|---|---|
id | string | yes | |
status | string | yes | |
step | string | null | yes | |
error | string | null | yes | |
platform | string | yes | |
account | string | yes | |
name | string | yes | |
daily_budget | number | yes | |
currency | string | yes | |
review_url | string | null | yes | |
open_url | string | null | yes | |
live_at | string | null | yes | |
next | string | yes |
Errors
Every error body is { error, code, request_id, ... }. All codes and what to do.
- 401: Missing, wrong, revoked or expired API key (code UNAUTHORIZED, KEY_REVOKED, KEY_EXPIRED).
- 403: The key may not do this (SCOPE_DENIED, MODEL_NOT_ALLOWED, TEST_MODE_UNSUPPORTED, ACCOUNT_BLOCKED, allowance_exceeded).
- 404: No such id, or it is not yours, or it belongs to the other key mode (NOT_FOUND).
- 429: Too many requests or jobs (RATE_LIMITED, CONCURRENCY_LIMIT, UPLOAD_QUOTA, …). Wait Retry-After seconds, then retry.
- 500: Our fault (INTERNAL_ERROR). Quote request_id to support.
- 503: Paused or busy (API_PAUSED, MODEL_PAUSED, PROVIDER_PAUSED, PROVIDER_BUSY, UNAVAILABLE). Wait Retry-After seconds, then retry.
Charges
Free. No credits are spent.