News
News publishes customer-facing updates (deals, events, news posts, articles, and jobs). Install News under Team settings → Apps, then open News in the sidebar (product route label: Updates). Solo pricing highlights shop updates and deals.
Installing News unlocks the Updates UI. MCP update tools are gated by Board (usually already installed) — News alone does not add a separate MCP gate.
Overview
- Create updates with title, body, images, optional link, and schedule window
- Types: deal, event, news, article, job
- Statuses: draft, published, archived
- Published updates can surface on the storefront (including store events listings) and brand Sites where configured
In the app
- Install News
- Open News / Updates
- Create an update — pick type and status
- Add media, link URL, and start/end times when relevant (events / deals)
- Publish when ready; archive when finished
- Review the overview list (status badges)
Types
| Type | Typical use |
|---|---|
| deal | Promotions and offers |
| event | Time-bound happenings (use starts / ends) |
| news | General announcements |
| article | Longer marketing or blog posts |
| job | Open positions and hiring posts |
Statuses
Job metadata
Jobs use the normal update fields plus optional string props:
| Prop | Use |
|---|---|
jobLocation | Place, e.g. Hollabrunn |
jobWorkplaceType | onsite, hybrid, or remote |
jobEmploymentType | full-time, part-time, contract, internship, temporary, volunteer, other; comma-separate multiple |
jobSalaryMin, jobSalaryMax | Gross salary amount |
jobSalaryUnit | hour, day, week, month, year |
jobSalaryCurrency | ISO currency, default EUR |
jobStartDate | ISO date when the role starts |
jobApplyEmail | Optional application email |
Use linkUrl for the canonical job/apply page, startsAt for the posting date, and endsAt for the application deadline.
Statuses
| Status | Meaning |
|---|---|
| draft | Not public |
| published | Live on configured public surfaces |
| archived | Hidden from active feeds |
Public surfaces
Published updates appear on store.joai.ai team pages (catalog / events areas) and other brand surfaces when those apps are installed. See Public surfaces and Shop.
For agents (MCP)
Update tools are gated by the Board app in MCP:
list_updates, create_update, update_update, delete_update, get_update_stats
list_updates mirrors @joai/sdk client.updates.list:
tags(e.g.example-city) — city-wide public feed across teams;teamnot requiredteam— scope to one team slug- Optional:
type(deal|event|news|article|job),status,active(default true),with(e.g.["team"])
Install Board (usually already present) and call these tools, or manage updates in the News UI.
Live schemas: tools/list. See MCP.