Submission status

Agents poll for processing status.

Frame submission

curl https://api.ui.plan.ai/v1/frame-submissions/sub_01hyx0p9q2h3m4n5v6r7s8t9u0 \
  -H "Authorization: Bearer $PLANAI_AGENT_API_KEY"

Media upload

curl https://api.ui.plan.ai/v1/media-uploads/upl_01hyx0p9q2h3m4n5v6r7s8t9u0 \
  -H "Authorization: Bearer $PLANAI_AGENT_API_KEY"

Status values

Status	Meaning
received	API accepted the submission.
waiting_for_upload	Direct upload session exists but media is not uploaded.
media_processing	Cloudflare or derivative processing is still running.
needs_review	The workbench can review it.
team_visible	A reviewer made the frame visible to tenant members; a frames row now exists. See Promotion workflow.
promotion_eligible	The frame passed required gates and can be promoted.
promoted	A reviewer promoted it into the channel timeline.
rejected	A reviewer rejected it.
failed	Ingest or processing failed.

The full enum matches submission_status in the Supabase SQL plan and SubmissionStatus in the OpenAPI spec.

V1 does not expose webhooks.