Video analyses API returns 410 video_analysis_retired: fix

If POST /v1/video-analyses returns 410 video_analysis_retired, you are calling Sume's dest environment, where creating an analysis is switched off. It is not a production outage. Move new work to POST /v1/video-inspect, which the docs name as the default clip inspection on dest and prod.

Why do I get a 410?

The video analyses docs say create is retired on dest, and that production keeps accepting it for now. MCP wrappers named video-analyses_* are also delisted from the tool list on dest. The page tells you not to start new work on this surface.

Can I still read old analyses?

Yes. Stored vana_ rows stay readable through GET /v1/video-analyses/:id and GET /v1/video-analyses in both environments, so existing results are not lost.

What do I use instead?

Video inspect probes one media.sume.com clip, samples stills and can transcribe. Probe and stills are unbilled; the default is mode: sync, which waits up to 30 seconds. It does not return typed scenes, so it is not a drop-in swap for scenes[].

curl -X POST https://api.sume.com/v1/video-inspect \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: inspect-migrate-001" \
  -d '{
    "video_url": "https://media.sume.com/artifacts/artf_demo/ad.mp4",
    "frames": { "fps": 1 }
  }'

What if I need semantic questions about the video?

The docs mention video_analyze and video_segment on dest only when those names appear in the tool list, and say they are not for production. Check the tool list rather than assuming they exist.