POST news/set

POST /api/v2/news/set

Creates a new news item or updates an existing one for a given event.


Authentication

Authorization: Bearer <your_api_key>

Endpoint

POST /api/v2/news/set

Content-Type: multipart/form-data


Create vs Update

  • Create: Omit id. event_id, title, text, short, and author are required

  • Update: Pass the id of the existing news item. Other fields are optional


Body Parameters

Required on create

Parameter

Type

Description

event_id

integer

The event this news item belongs to

title

string

News headline (max 255 chars)

text

string

Full article body

short

string

Short teaser / excerpt (max 200 chars)

author

string

Author name (max 255 chars)

Optional

Parameter

Type

Description

id

integer

When provided, updates the matching news item

status

string

APPROVED (default), ON_APPROVAL, REJECTED, or SIBLING_EDIT

published

integer/boolean

1 or true to publish. Automatically forced to true when status=APPROVED

img

file or URL

Main article image (image/png, image/jpeg)

headerimg

file or URL

Header image

public_date

string or integer

Publication date — Unix timestamp or date string

exhibitor_id

integer

Links the news item to an exhibitor

tags

string

Comma-separated tag names

product_categories

string

Comma-separated product category IDs


Cross-entity dependency

exhibitor_id — use GET /api/v2/exhibitor/getList or GET /api/v2/exhibitors/{eventId}/list to retrieve valid exhibitor IDs.


Error Responses

HTTP Code

Condition

Error Message

400

event_id missing or invalid

Invalid Exhibition ID

400

Required field missing

Missing required parameter: {field}

403

Missing or invalid API key

Forbidden