API Tara: announcements
Announcements from PhillipCLI (maintenance, incidents, news) shown as banners in the Portal and printed by ph
This page is generated from
openapi.yamlbynpm run gen, so do not edit it by hand. Authentication is described on the overview page.
/v1/announcementsActive announcements for the current organization
Announcements from PhillipCLI that are active now, aimed at the caller's organization (by plan or by organization), without the ones this user dismissed. The organization is the one of the session, token or CLI login; org (a slug the caller belongs to) picks another one for a Portal session. Plain text; links are written as plain https:// addresses.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
org | query | string | Organization slug (the caller must be a member; otherwise 404) |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Active announcements, most severe first, then newest | application/json · object |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found | application/problem+json · object |
Example response
{
"items": [
{
"id": "string",
"title": "string",
"body": "string",
"severity": "info",
"dismissible": false,
"startsAt": "2026-11-01T00:00:00Z"
}
]
}Call with curl
curl "https://tara.phillipcli.cloud/v1/announcements" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/announcements/{id}/dismissDismiss an announcement for the signed-in user
Only announcements marked dismissible; 409 otherwise. Dismissing again is fine.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
id | path | string | yes |
Responses
| Code | Description | Type |
|---|---|---|
| 204 | Dismissed | |
| 401 | Not signed in | application/problem+json · object |
| 404 | Not found, or not active for this organization | application/problem+json · object |
| 409 | The announcement cannot be dismissed | application/problem+json · object |
Call with curl
curl -X POST "https://tara.phillipcli.cloud/v1/announcements/<id>/dismiss" \
-H "Authorization: Bearer $TARA_TOKEN"