Userorbit Skill/Announcements
Announcements & Changelog
Publish product updates the moment the deploy goes green.
Announcements are Userorbit's changelog: categorized product updates users see in-app and on your public changelog page. The skill lets your agent draft an announcement from a diff or PR description, attach a CTA, and publish or schedule it — all without leaving the terminal.
Announcements live in collections (categories), support scheduling via scheduledAt, pinning, and optional email broadcast on publish.
This guide covers the agent skill and API. For the full product, see Userorbit announcements.
Ask your agent
- Publish a changelog entry for the dark mode feature we just merged
- Draft an announcement for the v2 API, schedule it for Monday 9am
- Pin the pricing update announcement
Endpoints
All endpoints are POST https://api.userorbit.com/api/v1/<endpoint> with a Bearer API key and x-team-id header.
| Endpoint | What it does |
|---|---|
announcements.create | Create (collectionId, title, text, meta); publish: true to go live |
announcements.list / info / search | Browse and search entries |
announcements.update | Edit, publish/unpublish, schedule, email broadcast |
announcements.pin / unpin | Pin to the top |
announcements.archive / restore / delete | Lifecycle management |
collections.* | Manage announcement categories |
document-comments.* | Comments on announcements |
Example
curl -s -X POST "https://api.userorbit.com/api/v1/announcements.create" \
-H "Authorization: Bearer $USERORBIT_API_KEY" \
-H "Content-Type: application/json" \
-H "x-team-id: $USERORBIT_TEAM_ID" \
-d '{"collectionId": "<id>", "title": "Dark mode is here", "text": "...", "meta": {}, "publish": true}'Full request and response schemas: references/api.md.