Storyden
Events

Event Create

Create a new event. When an event is created, a thread is also created which provides the means for discussion via the thread and reply APIs.

Create a new event. When an event is created, a thread is also created which provides the means for discussion via the thread and reply APIs.

POST/events

Authorization

storyden-session<token>

In: cookie

Request Body

nameEventName
slug?EventSlug
description?EventDescription
contentPostContent

The body text of a post within a thread. The type is either a string or an object, depending on what was used during creation. Strings can be used for basic plain text or markdown content and objects are used for more complex types such as Slate.js editor documents.

time_rangeEventTimeRange

A time range for an event, which may span multiple days or times of day.

primary_image_asset_id?Identifier

A unique identifier for this resource.

Formatxid
participation_policyEventParticipationPolicy
Value in"open" | "closed" | "invite_only"
visibilityVisibility
Value in"draft" | "unlisted" | "review" | "published"
location?EventLocation

An event location can be either physical or virtual. A physical location may have an address or coordinates. A virtual location may have a link.

A physical location for an event, such as a venue, a park, a street address, etc. This location may have a name, address, and coordinates. A URL may also be added for a Google maps link etc.

location_typeEventLocationType
Value in"physical" | "virtual"
namestring
address?string
latitude?number
longitude?number
url?string

A virtual location for an event, such as a URL, a video conference link, a Discord server, etc. This location may have a URL.

location_typeEventLocationType
Value in"physical" | "virtual"
namestring
url?string
capacity?EventCapacity

The maximum number of attendees that can attend the event.

thread_category_idIdentifier

A unique identifier for this resource.

Formatxid
meta?Metadata

Arbitrary metadata for the resource.

Empty Object

Response Body

curl -X POST "https://loading/api/events" \  -H "Content-Type: application/json" \  -d '{    "name": "Friday beers, coding and design hack night",    "content": "string",    "time_range": {      "start": "2019-08-24T14:15:22Z",      "end": "2019-08-24T14:15:22Z"    },    "participation_policy": "open",    "visibility": "draft",    "thread_category_id": "cc5lnd2s1s4652adtu50"  }'
{
  "id": "cc5lnd2s1s4652adtu50",
  "createdAt": "2019-08-24T14:15:22Z",
  "updatedAt": "2019-08-24T14:15:22Z",
  "deletedAt": "2019-08-24T14:15:22Z",
  "misc": {},
  "name": "Friday beers, coding and design hack night",
  "slug": "friday-beers-coding-design-hack-night",
  "description": "Join us for a night of coding, design and beers!",
  "time_range": {
    "start": "2019-08-24T14:15:22Z",
    "end": "2019-08-24T14:15:22Z"
  },
  "primary_image": {
    "id": "cc5lnd2s1s4652adtu50",
    "filename": "string",
    "path": "string",
    "mime_type": "string",
    "width": 0,
    "height": 0,
    "parent": {
      "id": "cc5lnd2s1s4652adtu50",
      "filename": "string",
      "path": "string",
      "mime_type": "string",
      "width": 0,
      "height": 0,
      "parent": {}
    }
  },
  "participants": [
    {
      "profile": {
        "id": "cc5lnd2s1s4652adtu50",
        "joined": "2019-08-24T14:15:22Z",
        "suspended": "2019-08-24T14:15:22Z",
        "handle": "Southclaws",
        "name": "Barnaby Keene"
      },
      "role": "attendee",
      "status": "requested"
    }
  ],
  "participation_policy": "open",
  "visibility": "draft",
  "location": {
    "location_type": "physical",
    "name": "string",
    "address": "string",
    "latitude": 0,
    "longitude": 0,
    "url": "string"
  },
  "capacity": 0,
  "meta": {},
  "thread": {
    "id": "cc5lnd2s1s4652adtu50",
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z",
    "deletedAt": "2019-08-24T14:15:22Z",
    "misc": {},
    "title": "Hello world!",
    "description": "string",
    "slug": "cc5lnd2s1s4652adtu50-top-10-movies-thread",
    "author": {
      "id": "cc5lnd2s1s4652adtu50",
      "joined": "2019-08-24T14:15:22Z",
      "suspended": "2019-08-24T14:15:22Z",
      "handle": "Southclaws",
      "name": "Barnaby Keene"
    },
    "assets": [
      {
        "id": "cc5lnd2s1s4652adtu50",
        "filename": "string",
        "path": "string",
        "mime_type": "string",
        "width": 0,
        "height": 0,
        "parent": {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {}
        }
      }
    ],
    "reacts": [
      {
        "id": "cc5lnd2s1s4652adtu50",
        "emoji": "string",
        "author": {
          "id": "cc5lnd2s1s4652adtu50",
          "joined": "2019-08-24T14:15:22Z",
          "suspended": "2019-08-24T14:15:22Z",
          "handle": "Southclaws",
          "name": "Barnaby Keene"
        }
      }
    ],
    "collections": {
      "in_collections": 0,
      "has_collected": true
    },
    "likes": {
      "likes": 0,
      "liked": true
    },
    "meta": {},
    "body": "string",
    "body_links": [
      {
        "id": "cc5lnd2s1s4652adtu50",
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z",
        "deletedAt": "2019-08-24T14:15:22Z",
        "misc": {},
        "url": "string",
        "slug": "github-com-southclaws-storyden",
        "domain": "github.com",
        "title": "The Open Graph Protocol",
        "description": "The Open Graph protocol enables any web page to become a rich object in a social graph.",
        "favicon_image": {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {
            "id": "cc5lnd2s1s4652adtu50",
            "filename": "string",
            "path": "string",
            "mime_type": "string",
            "width": 0,
            "height": 0,
            "parent": {}
          }
        },
        "primary_image": {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {
            "id": "cc5lnd2s1s4652adtu50",
            "filename": "string",
            "path": "string",
            "mime_type": "string",
            "width": 0,
            "height": 0,
            "parent": {}
          }
        }
      }
    ],
    "pinned": true,
    "visibility": "draft",
    "read_status": {
      "last_read_at": "2019-08-24T14:15:22Z",
      "replies_since": 0
    },
    "reply_status": {
      "replies": 0,
      "replied": 0
    },
    "category": {
      "id": "cc5lnd2s1s4652adtu50",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "deletedAt": "2019-08-24T14:15:22Z",
      "misc": {},
      "name": "string",
      "slug": "string",
      "description": "string",
      "colour": "string",
      "sort": 0,
      "parent": "cc5lnd2s1s4652adtu50",
      "cover_image": {
        "id": "cc5lnd2s1s4652adtu50",
        "filename": "string",
        "path": "string",
        "mime_type": "string",
        "width": 0,
        "height": 0,
        "parent": {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {}
        }
      },
      "children": [
        {
          "id": "cc5lnd2s1s4652adtu50",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "deletedAt": "2019-08-24T14:15:22Z",
          "misc": {},
          "name": "string",
          "slug": "string",
          "description": "string",
          "colour": "string",
          "sort": 0,
          "parent": "cc5lnd2s1s4652adtu50",
          "cover_image": {
            "id": "cc5lnd2s1s4652adtu50",
            "filename": "string",
            "path": "string",
            "mime_type": "string",
            "width": 0,
            "height": 0,
            "parent": {
              "id": "cc5lnd2s1s4652adtu50",
              "filename": "string",
              "path": "string",
              "mime_type": "string",
              "width": 0,
              "height": 0,
              "parent": {}
            }
          },
          "children": [],
          "meta": {},
          "postCount": 0
        }
      ],
      "meta": {}
    },
    "link": {
      "id": "cc5lnd2s1s4652adtu50",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "deletedAt": "2019-08-24T14:15:22Z",
      "misc": {},
      "url": "string",
      "slug": "github-com-southclaws-storyden",
      "domain": "github.com",
      "title": "The Open Graph Protocol",
      "description": "The Open Graph protocol enables any web page to become a rich object in a social graph.",
      "favicon_image": {
        "id": "cc5lnd2s1s4652adtu50",
        "filename": "string",
        "path": "string",
        "mime_type": "string",
        "width": 0,
        "height": 0,
        "parent": {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {}
        }
      },
      "primary_image": {
        "id": "cc5lnd2s1s4652adtu50",
        "filename": "string",
        "path": "string",
        "mime_type": "string",
        "width": 0,
        "height": 0,
        "parent": {
          "id": "cc5lnd2s1s4652adtu50",
          "filename": "string",
          "path": "string",
          "mime_type": "string",
          "width": 0,
          "height": 0,
          "parent": {}
        }
      }
    },
    "tags": [
      {
        "name": "string",
        "colour": "string",
        "item_count": 0
      }
    ],
    "last_reply_at": "2019-08-24T14:15:22Z",
    "recomentations": [
      {
        "kind": "post",
        "ref": {
          "id": "cc5lnd2s1s4652adtu50",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "deletedAt": "2019-08-24T14:15:22Z",
          "misc": {},
          "title": "Hello world!",
          "description": "string",
          "slug": "cc5lnd2s1s4652adtu50-top-10-movies-thread",
          "author": {
            "id": "cc5lnd2s1s4652adtu50",
            "joined": "2019-08-24T14:15:22Z",
            "suspended": "2019-08-24T14:15:22Z",
            "handle": "Southclaws",
            "name": "Barnaby Keene"
          },
          "assets": [
            {
              "id": "cc5lnd2s1s4652adtu50",
              "filename": "string",
              "path": "string",
              "mime_type": "string",
              "width": 0,
              "height": 0,
              "parent": {
                "id": "cc5lnd2s1s4652adtu50",
                "filename": "string",
                "path": "string",
                "mime_type": "string",
                "width": 0,
                "height": 0,
                "parent": {}
              }
            }
          ],
          "reacts": [
            {
              "id": "cc5lnd2s1s4652adtu50",
              "emoji": "string",
              "author": {
                "id": "cc5lnd2s1s4652adtu50",
                "joined": "2019-08-24T14:15:22Z",
                "suspended": "2019-08-24T14:15:22Z",
                "handle": "Southclaws",
                "name": "Barnaby Keene"
              }
            }
          ],
          "collections": {
            "in_collections": 0,
            "has_collected": true
          },
          "likes": {
            "likes": 0,
            "liked": true
          },
          "meta": {},
          "body": "string",
          "body_links": [
            {
              "id": "cc5lnd2s1s4652adtu50",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "deletedAt": "2019-08-24T14:15:22Z",
              "misc": {},
              "url": "string",
              "slug": "github-com-southclaws-storyden",
              "domain": "github.com",
              "title": "The Open Graph Protocol",
              "description": "The Open Graph protocol enables any web page to become a rich object in a social graph.",
              "favicon_image": {
                "id": "cc5lnd2s1s4652adtu50",
                "filename": "string",
                "path": "string",
                "mime_type": "string",
                "width": 0,
                "height": 0,
                "parent": {
                  "id": "cc5lnd2s1s4652adtu50",
                  "filename": "string",
                  "path": "string",
                  "mime_type": "string",
                  "width": 0,
                  "height": 0,
                  "parent": {}
                }
              },
              "primary_image": {
                "id": "cc5lnd2s1s4652adtu50",
                "filename": "string",
                "path": "string",
                "mime_type": "string",
                "width": 0,
                "height": 0,
                "parent": {
                  "id": "cc5lnd2s1s4652adtu50",
                  "filename": "string",
                  "path": "string",
                  "mime_type": "string",
                  "width": 0,
                  "height": 0,
                  "parent": {}
                }
              }
            }
          ]
        }
      }
    ],
    "replies": {
      "page_size": 0,
      "results": 0,
      "total_pages": 0,
      "current_page": 0,
      "next_page": 0,
      "replies": [
        {
          "id": "cc5lnd2s1s4652adtu50",
          "createdAt": "2019-08-24T14:15:22Z",
          "updatedAt": "2019-08-24T14:15:22Z",
          "deletedAt": "2019-08-24T14:15:22Z",
          "misc": {},
          "title": "Hello world!",
          "description": "string",
          "slug": "cc5lnd2s1s4652adtu50-top-10-movies-thread",
          "author": {
            "id": "cc5lnd2s1s4652adtu50",
            "joined": "2019-08-24T14:15:22Z",
            "suspended": "2019-08-24T14:15:22Z",
            "handle": "Southclaws",
            "name": "Barnaby Keene"
          },
          "assets": [
            {
              "id": "cc5lnd2s1s4652adtu50",
              "filename": "string",
              "path": "string",
              "mime_type": "string",
              "width": 0,
              "height": 0,
              "parent": {
                "id": "cc5lnd2s1s4652adtu50",
                "filename": "string",
                "path": "string",
                "mime_type": "string",
                "width": 0,
                "height": 0,
                "parent": {}
              }
            }
          ],
          "reacts": [
            {
              "id": "cc5lnd2s1s4652adtu50",
              "emoji": "string",
              "author": {
                "id": "cc5lnd2s1s4652adtu50",
                "joined": "2019-08-24T14:15:22Z",
                "suspended": "2019-08-24T14:15:22Z",
                "handle": "Southclaws",
                "name": "Barnaby Keene"
              }
            }
          ],
          "collections": {
            "in_collections": 0,
            "has_collected": true
          },
          "likes": {
            "likes": 0,
            "liked": true
          },
          "meta": {},
          "body": "string",
          "body_links": [
            {
              "id": "cc5lnd2s1s4652adtu50",
              "createdAt": "2019-08-24T14:15:22Z",
              "updatedAt": "2019-08-24T14:15:22Z",
              "deletedAt": "2019-08-24T14:15:22Z",
              "misc": {},
              "url": "string",
              "slug": "github-com-southclaws-storyden",
              "domain": "github.com",
              "title": "The Open Graph Protocol",
              "description": "The Open Graph protocol enables any web page to become a rich object in a social graph.",
              "favicon_image": {
                "id": "cc5lnd2s1s4652adtu50",
                "filename": "string",
                "path": "string",
                "mime_type": "string",
                "width": 0,
                "height": 0,
                "parent": {
                  "id": "cc5lnd2s1s4652adtu50",
                  "filename": "string",
                  "path": "string",
                  "mime_type": "string",
                  "width": 0,
                  "height": 0,
                  "parent": {}
                }
              },
              "primary_image": {
                "id": "cc5lnd2s1s4652adtu50",
                "filename": "string",
                "path": "string",
                "mime_type": "string",
                "width": 0,
                "height": 0,
                "parent": {
                  "id": "cc5lnd2s1s4652adtu50",
                  "filename": "string",
                  "path": "string",
                  "mime_type": "string",
                  "width": 0,
                  "height": 0,
                  "parent": {}
                }
              }
            }
          ],
          "root_id": "cc5lnd2s1s4652adtu50",
          "root_slug": "cc5lnd2s1s4652adtu50-top-10-movies-thread",
          "reply_to": "cc5lnd2s1s4652adtu50"
        }
      ]
    }
  }
}
Empty
{
  "error": "string",
  "message": "string",
  "suggested": "string",
  "metadata": {}
}
Edit on GitHub

Datagraph Search GET GET

Query and search content.

Event Delete DELETE DELETE

Delete an event.