Agency Black Friday: a team-owned Format needs a workspace key
A personal API key cannot run a Format that a team workspace owns. Sume answers 403 workspace_key_required, so issue the key inside the team before launch.
If a team workspace owns the Format, a personal key will not work. The error is 403 workspace_key_required, and details.workspace_id names the workspace whose key you need.
Three key problems that look alike
| Symptom | Cause | Fix |
|---|---|---|
| 403 insufficient_scope | Key lacks formats:write or formats:read | Mint a new key; scopes cannot be added |
| 403 insufficient_scope with service_account_format_runs_unsupported | Service-account key | Use a user key |
| 403 workspace_key_required | Personal key, team Format | Create the key in the team workspace |
What stays the same
The Format address, the body and the bulk endpoint are unchanged. The run, its media and its spend belong to the key that made the call, and team runs count against the team's generation concurrency. For an agency, that means one key per client workspace, kept on your server, not one shared key.
Before launch day
- Create the keys a week early and run one tiny call per client.
- Check the
GET /v1/formatslist for each key: a Format outside the key's workspace answers404 format_not_found, which can look like a typo. - Do not ship these keys to a browser.
Sources
Related posts
More in Developers
- Get the edited image URL as a named field from an Agent Completion
Attach the photo and an output_schema in one POST /v1/agent/completions call. Sume parses output into your own fields, such as edited_url and changes.
- Agent Completion output_schema shaped like a Clef or Decider answer
Map Clef and Strands Decider answer types (yes/no, choice, score) onto a Sume output_schema with enum and integer bounds, and see what it does not check.
- Agent Completion result: read output.videos, images, audio and files
A completed Agent Completion puts its last text in output.text and generated media in output.images, videos, audio and files, as durable media.sume.com URLs.
- Agent quoted $13.31 for a 13-cent Sume job: the micros divisor
Divide billable_amount_usd_micros by 1,000,000 for dollars. Dividing by 10,000 gives cents and overstates spend 100x. Sume MCP flags this as usd_unit_mismatch.
Written by Sume