Announcements

...

Announcement object

Announcements have the following fields

Field	Details
idx string	A unique identifier for the announcement
name string	Name of the announcement
slug string	The URL slug of the idea
excerpt string	Short textual description of the announcement
content string	Content of the announcement (as Markdown)
reaction_count object	Reactions to the announcement
is_published boolean	Indicates if the announcement is published or not
published_at string	The date & time the announcement was published (UTC timezone) or null if still in draft
created_at string	The date & time the announcement was created (UTC timezone)
author object	Author of this announcement
categories array	Categories associated with this announcement
ideas array	Ideas associated with this announcement

Endpoints

You can use the following endpoints to manage Announcements

List announcements

Returns a list of announcements

GEThttps://api.frill.co/v1/announcements

Query parameters

Response

200400

Returned a list of Announcements

Body

application/json

dataarray of Announcement (object)

paginationPagination (object)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/announcements', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "idx": "announcement_abcd1234",
      "name": "New feature release",
      "slug": "new-announcement",
      "excerpt": "text",
      "content": "We've released some awesome new features ...",
      "is_published": false,
      "published_at": "text",
      "created_at": "text",
      "updated_at": "text",
      "author": {
        "idx": "user_abcd1234",
        "name": "John Smith",
        "avatar": "https://example.com/example.jpg"
      },
      "categories": [
        {
          "idx": "category_abcd1234",
          "name": "Improvement",
          "color": "#ff00ff"
        }
      ],
      "ideas": [
        {
          "idx": "idea_abcd1234",
          "name": "New idea"
        }
      ]
    }
  ],
  "pagination": {
    "total": 10,
    "before": "before-cursor",
    "after": "after-cursor"
  }
}

Get an announcement

Get a Announcement

GEThttps://api.frill.co/v1/announcements/{announcementIdx}

Query parameters

Response

200400

Returns Annoucement

Body

application/json

dataAnnouncement (object)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/announcements/{announcementIdx}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "idx": "announcement_abcd1234",
    "name": "New feature release",
    "slug": "new-announcement",
    "excerpt": "text",
    "content": "We've released some awesome new features ...",
    "is_published": false,
    "published_at": "text",
    "created_at": "text",
    "updated_at": "text",
    "author": {
      "idx": "user_abcd1234",
      "name": "John Smith",
      "avatar": "https://example.com/example.jpg"
    },
    "categories": [
      {
        "idx": "category_abcd1234",
        "name": "Improvement",
        "color": "#ff00ff"
      }
    ],
    "ideas": [
      {
        "idx": "idea_abcd1234",
        "name": "New idea"
      }
    ]
  }
}

Create a announcement

Create a new announcement

POSThttps://api.frill.co/v1/announcements

Body

application/json

namestring

Title of the Announcement

author_idxstring

IDX of the author of the Annoucement

contentstring

Announcement content in Markdown format

published_atstring

Date announcement is published (ISO 8601 format) or null for draft

idea_idxsarray of string

IDXs of Ideas to associate with the Announcement

category_idxsarray of string

IDXs of Categories to associate with the Announcement

Response

200400

Returns Annoucement

Body

application/json

dataAnnouncement (object)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/announcements', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "data": {
    "idx": "announcement_abcd1234",
    "name": "New feature release",
    "slug": "new-announcement",
    "excerpt": "text",
    "content": "We've released some awesome new features ...",
    "is_published": false,
    "published_at": "text",
    "created_at": "text",
    "updated_at": "text",
    "author": {
      "idx": "user_abcd1234",
      "name": "John Smith",
      "avatar": "https://example.com/example.jpg"
    },
    "categories": [
      {
        "idx": "category_abcd1234",
        "name": "Improvement",
        "color": "#ff00ff"
      }
    ],
    "ideas": [
      {
        "idx": "idea_abcd1234",
        "name": "New idea"
      }
    ]
  }
}

Update a announcement

Update a Announcement

POSThttps://api.frill.co/v1/announcements/{announcementIdx}

Query parameters

Body

application/json

namestring

Title of the Announcement

author_idxstring

IDX of the author of the Annoucement

contentstring

Announcement content in Markdown format

published_atstring

Date announcement is published (ISO 8601 format) or null for draft

idea_idxsarray of string

IDXs of Ideas to associate with the Announcement

category_idxsarray of string

IDXs of Categories to associate with the Announcement

Response

200400

Returns Annoucement

Body

application/json

dataAnnouncement (object)

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/announcements/{announcementIdx}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

{
  "data": {
    "idx": "announcement_abcd1234",
    "name": "New feature release",
    "slug": "new-announcement",
    "excerpt": "text",
    "content": "We've released some awesome new features ...",
    "is_published": false,
    "published_at": "text",
    "created_at": "text",
    "updated_at": "text",
    "author": {
      "idx": "user_abcd1234",
      "name": "John Smith",
      "avatar": "https://example.com/example.jpg"
    },
    "categories": [
      {
        "idx": "category_abcd1234",
        "name": "Improvement",
        "color": "#ff00ff"
      }
    ],
    "ideas": [
      {
        "idx": "idea_abcd1234",
        "name": "New idea"
      }
    ]
  }
}

Delete a announcement

Delete a Announcement

DELETEhttps://api.frill.co/v1/announcements/{announcementIdx}

Query parameters

Response

200400

Request was successful

Body

application/json

successboolean

messagestring

Request

JavaScriptCurl

const response = await fetch('https://api.frill.co/v1/announcements/{announcementIdx}', {
    method: 'DELETE',
    headers: {},
});
const data = await response.json();

Response

{
  "success": false,
  "message": "Request was successful"
}