Sign in
News

Create News

Creates a new news post.

post/v1/news

Request body

datestring date

The date of the news

tagsstring required

The tags of the news, separated by commas

order_idinteger

The order ID of the news

category'bugfix' | 'company_news' | 'event' | 'maintenance' | 'update' required
published_atinteger

The published date of the news

datetimeinteger required

The date of the news

video_urlstring uri

The URL of the video for the news

is_featuredboolean

Whether the news is featured, which shows its card in large size

collection_idstring

The collection ID this news belongs to

is_pinnedboolean

Whether the news is pinned, which puts it into the article slider

pin_scope'global' | 'collection'

How far a pinned article or page reaches.

  • global: the pin also acts on views spanning sibling collections
  • collection: the pin acts only among the articles of its own collection

An unset scope is read as GLOBAL.

button_textstring

Text for the news card button

slugstring required

The slug of the news

titlestring required

The title of the news

descriptionstring required

The description of the news

textstring required

The text of the news

htmlstring

The html content of the news

Response

Successful Response

datestring date

The date of the news

tagsstring required

The tags of the news, separated by commas

order_idinteger

The order ID of the news

category'bugfix' | 'company_news' | 'event' | 'maintenance' | 'update' required
published_atinteger

The published date of the news

datetimeinteger required

The date of the news

video_urlstring uri

The URL of the video for the news

is_featuredboolean

Whether the news is featured, which shows its card in large size

collection_idstring

The collection ID this news belongs to

is_pinnedboolean

Whether the news is pinned, which puts it into the article slider

pin_scope'global' | 'collection'

How far a pinned article or page reaches.

  • global: the pin also acts on views spanning sibling collections
  • collection: the pin acts only among the articles of its own collection

An unset scope is read as GLOBAL.

button_textstring

Text for the news card button

idstring required

The unique identifier of the news

slugstring required

The slug of the news

titlestring required

The title of the news

descriptionstring

The description of the news

textstring required

The text of the news

htmlstring

The html content of the news

Changes

Changed in 2 of the 28 revisions of this API.117

  • 1816e2044c0713See the full diff
    • ●

      added the new function enum value to the /// response property for the response status

      response-property-enum-value-added

    • ○

      added the new optional request property /

      new-optional-request-property

    • ○

      added the new function enum value to the request property ///

      request-property-enum-value-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    This revision also has 4 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 5e18ab67333214See the full diff
    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the new optional request property

      new-optional-request-property

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    • ○

      added the optional property to the response with the status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog