Get news entry
get_newsRead the full OpenProject news entry, including markdown body and metadata, by providing its numeric ID. Ideal after a summary, to access complete content and edit permissions.
Instructions
Read one news entry in full, including the markdown body.
Use it after list_news when the summary is not enough — this adds description,
the announcement's complete text as markdown (html is dropped), plus updated_at.
Returns {id, title, summary, description, project, author, created_at, updated_at, can_manage}. author is the account that published the entry and cannot be
changed; can_manage says whether editing or deleting it would be permitted.
Pitfalls: a 404 here means "no such entry, or you may not read news in its project" — the news module is enabled per project, so a missing entry is not always a wrong id. Comments people left on the announcement are not exposed by API v3 and are not included.
Cross-references: list_news produces the id; update_news changes the text;
delete_news removes the entry for good.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| news_id | Yes | Numeric news id from list_news. It is the same id as in the UI's /news/{id} URL; the headline is not an id. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | News id — what get_news, update_news and delete_news consume. | |
| title | No | Headline of the announcement. | |
| author | No | User who published it ({id, name}); set by the server. | |
| project | No | Project the announcement belongs to ({id, name}). | |
| summary | No | Short teaser OpenProject shows under the headline; may be empty. The full body is NOT here — read it with get_news(news_id=...). | |
| can_manage | No | True when this account may change or delete this entry (OpenProject renders the update/delete links only with the 'manage news' permission). False means update_news and delete_news would fail with 403. | |
| created_at | No | ISO 8601 UTC publication timestamp. | |
| updated_at | No | ISO 8601 UTC timestamp. | |
| description | No | The announcement body as markdown (raw); html is dropped. Empty string when the entry has only a headline and summary. |