Sume schedule slug rules: 2-64 characters, and runs is reserved
A Sume schedule slug is lowercase alphanumerics with single hyphens, 2 to 64 characters, unique in your account. The word runs is reserved. See the vanity path.

A schedule slug is lowercase letters and digits with single hyphens as separators. It is 2 to 64 characters and unique within your account, and runs is reserved because it is the next path segment of the run endpoint (API trigger). With a slug you can call a schedule at /v1/actions/{handle}/{slug}/runs instead of the opaque aut_ path.
Quick checks
A schedule made before slugs existed has slug: null. Call it by its aut_ id.
| Slug | Valid? |
|---|---|
weekly-teaser | Yes |
a | No: under 2 characters |
Weekly-Teaser | No: not lowercase |
weekly--teaser | No: double hyphen |
runs | No: reserved |
Which path to store
Both paths run the same pipeline, and action.id in the receipt is always the opaque id. Store aut_... in your own system. A renamed handle or slug changes the vanity path, and an old handle resolves for 90 days as a migration window, not a guarantee.
curl -sS -X POST "https://api.sume.com/v1/actions/acme/weekly-teaser/runs" \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: weekly-teaser-2026-w41" \
-d '{}'Sources
Related posts
More in Agents
- trending-research_search MCP tool: Reels and TikTok trends, $0.10
The hosted MCP tool trending-research_search finds trending Instagram Reels and TikTok videos for a niche at about $0.10 per search. YouTube is not supported.
- Trim pauses from ten clips: inspect segments, then one timeline render
Rough-cut apps trim pauses in their own editor. For a batch by API, inspect each clip for sentence segments, keep the speech, and render one timeline.
- Weekly video: Agent Completion, Format or schedule on Sume?
A weekly video fits a Format or a schedule, not a fresh Agent Completion each time. How to choose among the three Sume surfaces for a recurring job.
- Run the Sume video agent from your backend with Agent Completions
POST /v1/agent/completions runs the same agent as the Sume Agents chat, with tools and media generation, and returns an async run receipt you poll or webhook.
Written by Sume