POST /v1/projects/:projectId/ads/:platform/creatives/:adsContentId/unlock
Unlock a previously-flagged creative so it can be retried.
POST
/v1/projects/:projectId/ads/{platform}/creatives/:adsContentId/unlockPhase 1stable
- Auth
- Bearer
- Scope
- ads:write:creative
A creative previously flagged by Layers' safety pass (ads.creative.flagged webhook fires with flagged_reason) is locked from further push attempts. This endpoint releases the lock so the creative can re-enter rotation.
The lock exists because re-running an already-rejected creative wastes platform-side reviews and can pattern-flag the customer's ad account. Partners should inspect flagged_reason and remediate (re-render the creative, edit the caption) before unlocking — re-pushing an unfixed creative typically gets re-flagged by Meta / TikTok at the platform's own review.
Body
Body (optional)
commentstringoptionalFree-form note for the audit log explaining why the creative is being unlocked.
Response
{
"adsContentId": "adc_6f5d4c3b...",
"unlockedAt": "2026-05-08T17:32:11Z",
"verdictId": "ver_01HZX9..."
}The matching ads.creative.unlocked webhook fires.
Errors
| Code | When |
|---|---|
NOT_FOUND | Creative not flagged or already unlocked. |
FORBIDDEN_SCOPE | Key lacks ads:write:creative. |