Portable skill bundle for AI agents to automate Po Once through the agent API.
Setup
Create an API key in Po Once and run:
./scripts/po-once.cjs setup --api-key po_once_org_<secret>
Default base URL:
https://dynamic-lapwing-647.convex.site
Override it if needed:
./scripts/po-once.cjs setup \
--api-key po_once_org_<secret> \
--base-url https://your-other-convex-host.convex.site
Commands
| Command | Description |
|---|---|
./scripts/po-once.cjs setup --api-key <token> |
Save credentials |
./scripts/po-once.cjs config |
Show resolved config |
./scripts/po-once.cjs accounts |
List connected accounts |
./scripts/po-once.cjs upload --file ./clip.mp4 |
Upload media |
./scripts/po-once.cjs content:create --caption "..." --post-type video --storage-key <key> --size-bytes 1234 |
Create content |
./scripts/po-once.cjs post --content-id <id> --accounts profile1,profile2 --mode scheduled --schedule 2026-04-17T09:00:00Z --timezone UTC |
Create post batch |
./scripts/po-once.cjs publish --file ./clip.mp4 --caption "..." --accounts profile1,profile2 --mode direct |
Upload, create content, and create post |
./scripts/po-once.cjs posts --limit 20 --status scheduled |
List posts |
./scripts/po-once.cjs posts:get --id <post_id> |
Get one post |
./scripts/po-once.cjs posts:delete --id <post_id> |
Delete eligible post |
API Surface
The helper script wraps these endpoints:
GET /api/agent/v1/accountsPOST /api/agent/v1/media/create-upload-urlPOST /api/agent/v1/contentsGET /api/agent/v1/postsPOST /api/agent/v1/postsGET /api/agent/v1/posts/:idDELETE /api/agent/v1/posts/:id
Recommended Agent Workflow
- Call
accountsto get valid profile IDs. - Draft content and confirm whether the user wants direct or scheduled posting.
- Use
publishfor the normal end-to-end path. - Use
postsorposts:getto confirm status. - Only use
posts:deletewhen the user explicitly wants a scheduled post removed.
Safety Notes
- Treat the API token like a password.
- Prefer scheduled posting unless the user clearly wants immediate publishing.
- Results are scoped to the organization tied to the token.
- Some posts cannot be deleted once processing has started.