Storyden
Events

Event Update

Update an event. If the content field is updated, this is stored on the thread associated with the event, rather than the event itself. It's possible to update that thread directly using `threads` operations.

Update an event. If the content field is updated, this is stored on the thread associated with the event, rather than the event itself. It's possible to update that thread directly using threads operations.

PATCH/events/{event_mark}

Authorization

storyden-session<token>

In: cookie

Path Parameters

event_markstring

Either:

  • The unique event ID.
  • The unique event slug.
  • A string of the form -
Formatxid-prefixed-kebab-case-string

Request Body

name?EventName
slug?EventSlug
description?EventDescription
content?PostContent

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_range?EventTimeRange

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_policy?EventParticipationPolicy
Value in"open" | "closed" | "invite_only"
visibility?Visibility
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.

meta?Metadata

Arbitrary metadata for the resource.

Empty Object

Response Body

curl -X PATCH "https://loading/api/events/cc5lnd2s1s4652adtu50-top-10-movies-thread" \  -H "Content-Type: application/json" \  -d '{}'
{
  "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
Empty
{
  "error": "string",
  "message": "string",
  "suggested": "string",
  "metadata": {}
}
Edit on GitHub

Event Participant Update PUT PUT

Add a participant to an event or change an existing participant's state. If the requesting account is an admin or holds MANAGE_EVENTS permission, they can change the participation properties of any account. Otherwise, they can only change their own participation properties. For non-managing members (i.e. not an admin and not a host) this will follow a stricter state machine for the participation status. If the participation status is not set (no participation record is present) or set to "declined", the member may only set their status to "requested" if the event policy is set to "invite_only". Otherwise, they may set it to "attending". If the member is already set to one of these states, they may change it to "declined". A non-managing member cannot change their role and the default is "attendee", only managing members can change participant roles. If the event participation policy is set to "invite_only" then members can only set their status to "requested" or delete their participation. If the event participation policy is set to "closed", it's a no-op. Requests to this resource are idempotent given identical request bodies. It acts as a create-or-update action as participation is account-unique.