Create a post - Sqabl APIs

Request

Header Params

Authorization

string

required

Example:

Bearer some-random-token

Body Params multipart/form-data

arenaId

string

required

ID of the arena, in which the user is trying to create the post.

type

enum<string>

required

The type of the post, must be "debate | poll | question".

Allowed values:

debatepollquestion

imageFile

file

optional

question

string

optional

This is required if the post type = "question".

title

string

optional

This is required if the post type = "debate".

description

string

optional

pollContent

string

optional

This is required if the post type = "poll".

pollOptions[]

string

optional

An array of strings (option values) and this is required if the post type = "poll".

duration

number

optional

Duration of a post in seconds.

Example:

3600

scheduledStartTime

string

optional

Must be in date-time-string format.
For instance, "2024-10-05T18:50:00+01:00";
where
year = 2024
month = 10
day = 05
time-part separator = T
hh = 18
mm = 50
ss = 00
timezone = +01:00

Example:

2024-10-05T18:50:00+01:00

Request samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST 'https://api.sqabl.com/v1/posts/create' \
--header 'Authorization: Bearer some-random-token' \
--form 'arenaId=""' \
--form 'type=""' \
--form 'imageFile=@""' \
--form 'question=""' \
--form 'title=""' \
--form 'description=""' \
--form 'pollContent=""' \
--form 'pollOptions[]=""' \
--form 'duration="3600"' \
--form 'scheduledStartTime="2024-10-05T18:50:00+01:00"'

Responses

🟢200Success

application/json

Body

object {0}

Example

{
    "success": true,
    "statusCode": 200,
    "data": {
        "id": "cm1z66sxy0000u4v311cjcpzo",
        "type": "poll",
        "dateCreated": "2024-10-07 15:31:43.751Z",
        "owner": {
            "id": "cm1n5ubk200008ov3f8907ugy",
            "displayName": "Hiseous Hiseous",
            "imageSrc": "https://lh3.googleusercontent.com/a/ACg8ocICrDCtTUBH6BWXwWnRJkBHknyk9iHBfjupK_mhZrdj13z0EQ=s96-c"
        },
        "arena": {
            "id": "cm1xknwrc000008jp5hnu84m0",
            "name": "United for life"
        },
        "closed": true,
        "closingDate": "2024-10-07T16:10:43.000Z",
        "pollOptions": [
            {
                "text": "Some option text"
            },
            {
                "text": "Some option text"
            }
        ],
        "pollContent": "Some poll content."
    }
}