Skip to main content

Behavior

Use this endpoint when an app is stuck in error or provisioning status, or is missing provider infrastructure (e.g. an active fullstack app whose background backend provisioning failed). It checks which provider links are missing and re-provisions them. It is safe to call on a healthy app:
  • No hosting project linked → creates the hosting project, seeds NEXT_PUBLIC_APP_URL, and links it.
  • Fullstack with no backend linked → starts backend provisioning in the background and returns immediately. This call does not wait for the Supabase project. The supabase object appears on GET /v1/apps/:id once it is linked.
  • Nothing to retrystatus: "noop", not an error. Retrying a healthy app is safe and idempotent.
  • Already-linked infrastructure is left untouched.
The app moves to provisioning for the duration. It becomes active when this call finishes, unless the backend is still being provisioned in the background — in that case the background job sets active on success or error on failure. Poll GET /v1/apps/:id to find out which.

Response Fields

supabase: "provisioning" is not a success signal. The backend is not usable until GET /v1/apps/:id shows the supabase object. Until then POST /v1/apps/:id/db/query answers job_not_ready (409).

Errors

501
409
502