Announcements — publicAnnouncements | Bifrost Developer Center

POSThttps://api.dev.bifrostgaming.com/v1/graphql

publicAnnouncements

Retrieves all active announcements that have been marked for public web JSON feed distribution. No authentication required.

Operation Type

Query

Important usage notes

No authentication required - this is a public endpoint.
Only returns announcements where publishToJsonFeed = true, isActive = true, and expiryDate is null or in the future.
Results are ordered by publishedDate descending (newest first).

Code Examples

curl -X POST https://api.dev.bifrostgaming.com/v1/graphql \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query { publicAnnouncements { id title body authorName bannerImageUrl attachments { id fileName fileUrl fileSize fileType } publishedDate publishToJsonFeed categories expiryDate isActive createdAt updatedAt } }"
  }'

Postman Collection

Download a ready-to-use Postman collection for this endpoint. Import it into Postman to start testing immediately.

How to import into Postman

Open Postman and click Import (top-left)
Drag and drop the downloaded .json file, or click Upload Files and select it
Click Import to confirm
The collection appears in your sidebar — expand it and select the request
In the Body tab, update the placeholder values (your-partner-id, etc.) with your actual credentials
Click Send

The collection uses Postman's GraphQL body type, which provides syntax highlighting and variable editing. Make sure your Postman version is 7.2+ for GraphQL support.

Success Response200

{
  "data": {
    "publicAnnouncements": [
      {
        "id": "ann-001",
        "title": "API v1 Now Available",
        "content": "The Bifrost GraphQL API v1 is now available for all guild partners.",
        "createdAt": "2025-01-10T08:00:00Z",
        "expiresAt": "2025-02-10T08:00:00Z"
      }
    ]
  }
}

Error Responses

Response Fields

Field	Type	Required	Description
`id`	String	Optional	Unique announcement identifier
`title`	String	Optional	Announcement title/headline
`body`	String	Optional	Full announcement content/text
`authorName`	String	Optional	Name of announcement author
`bannerImageUrl`	String	Optional	URL to banner/header image (optional)
`attachments`	Array	Optional	Array of file attachments (id, fileName, fileUrl, fileSize, fileType)
`publishedDate`	String	Optional	Date/time when announcement was published
`categories`	String[]	Optional	Array of category tags
`expiryDate`	String	Optional	Date/time when announcement expires (null if no expiry)
`isActive`	Boolean	Optional	Whether announcement is currently active
`createdAt`	String	Optional	Date/time when announcement was created
`updatedAt`	String	Optional	Date/time when announcement was last updated

In partnership with

Brilliant game servers for communities large and small.

Get yours today!

A Shrapnelworks product