Sign in

v1

latestOpenAPI 3.1.02026-07-2615426267.4 KB
Threads

Create Contest

Create a new contest.

Required scopes:

  • post
post/contests

Request body

post_bodystring required

Content of the new contest.

titlestring

Thread title. Can be skipped if title_en set.

title_enstring

Thread english title. Can be skipped if title set.

contest_type'by_finish_date' required

Contest type.

length_valueinteger

Giveaway duration value. The maximum duration is 3 days. Required if contest_type is by_finish_date.

length_option'minutes' | 'hours' | 'days'

Giveaway duration type. The maximum duration is 3 days. Required if contest_type is by_finish_date.

prize_type'money' | 'upgrades' required

Prize type.

count_winnersinteger

Winner count (prize count). Optional if prize_type is money.

prize_data_moneynumber

How much money will each winner receive. Optional if prize_type is money.

is_money_placesboolean

Enable the distribution of money prizes by places. Optional if prize_type is money.

prize_data_placesnumber[]

How much money will receive each place. Required if is_money_places is 1.

prize_data_upgrade1 | 6 | 12 | 14 | 17 | 19 | 20 | 21 | 22

Which upgrade will each winner receive. Required if prize_type is upgrades.

require_like_countinteger required

Sympathies for this week.

require_total_like_countinteger required

Sympathies for all time.

secret_answerstring

Secret answer of your account.

tagsstring[]

Thread tags.

reply_group0 | 2 | 21 | 22 | 23 | 60 | 351

Allow to reply only users with chosen or higher group.

comment_ignore_groupboolean

Allow commenting if user can't post in thread.

dont_alert_followersboolean

Don't alert followers about thread creation.

hide_contactsboolean

Hide contacts.

allow_ask_hidden_contentboolean

Allow ask hidden content.

schedule_datestring

Date to schedule thread creation (format: DD-MM-YYYY).

schedule_timestring

Time to schedule thread creation (format: HH:MM).

watch_thread_stateboolean

Watch thread state.

watch_threadboolean

Receive forum notifications of new posts in this thread.

watch_thread_emailboolean

Receive email notifications of new posts in this thread.

Response

Successful Response.