Create a new news item.

Authentication: JWT token required Access: ADMIN and SUPERADMIN only

Request Body:

{
  "title": "New Feature Released",
  "message": "We're excited to announce...",
  "link_url": "https://docs.trends.earth/feature",
  "link_text": "Read more",
  "publish_at": "2025-01-15T10:00:00Z",
  "expires_at": "2025-02-15T10:00:00Z",
  "target_platforms": "app,webapp",
  "target_roles": "USER,ADMIN",
  "min_version": "2.0.0",
  "max_version": null,
  "is_active": true,
  "priority": 10,
  "news_type": "info"
}

Required Fields: title, message Optional Fields: All others (see schema above) target_roles: Comma-separated list of roles (USER, ADMIN, SUPERADMIN). Empty or null means visible to all users.

Response: Created news item object

Error Responses:

  • 400 Bad Request: Missing required fields
  • 401 Unauthorized: JWT token required
  • 403 Forbidden: Not authorized (ADMIN+ required)
post/api/v1/admin/news

Request body

object required

Response

Success

object required

Changes

No recorded changes to this endpoint across all 1 revision of this API.