Mutations

The mutation type defines GraphQL operations that change data on the server.

About mutations

Every GraphQL schema has a root type for both queries and mutations. The mutation type defines GraphQL operations that change data on the server. It is analogous to performing HTTP verbs such as POST, PATCH, and DELETE.

For more information, see Form calls with GraphQL.

createEvent

Create a new event.

Type: CreateEventPayload!

Arguments for createEvent

NameDescription
input (CreateEventInput!)

Input data for creating the event.

createTopic

Create a new topic on the platform.

Type: CreateTopicPayload!

Arguments for createTopic

NameDescription
input (CreateTopicInput!)

Input data for creating the topic.

deleteEvent

Delete an existing event.

Type: DeleteEventPayload!

Arguments for deleteEvent

NameDescription
input (DeleteEventInput!)

Input data for deleting the event.

deleteTopic

Delete an existing topic.

Type: DeleteTopicPayload!

Arguments for deleteTopic

NameDescription
input (DeleteTopicInput!)

Input data for deleting the topic.

stagedUploadsCreate

Creates staged upload targets for file uploads such as images, videos, and documents.

The stagedUploadsCreate mutation is the first step in Open Social's secure two-step upload process:

Step 1: Create staged upload targets (this mutation)

  • Generate secure, temporary upload URLs for your files.

Step 2: Upload files and create assets

  • Upload your files directly to the provided URLs using the tus specification.
  • Use the returned finalizationToken as the originalSource in subsequent mutations like topicCreate.

This approach provides support for large files, handles network interruptions gracefully, and ensures secure file transfers to Open Social's storage infrastructure.

Type: StagedUploadsCreatePayload!

Arguments for stagedUploadsCreate

NameDescription
input (StagedUploadsCreateInput!)

updateEvent

Update an existing event.

Type: UpdateEventPayload!

Arguments for updateEvent

NameDescription
input (UpdateEventInput!)

Input data for updating the event.

updateTopic

Update an existing topic.

Type: UpdateTopicPayload!

Arguments for updateTopic

NameDescription
input (UpdateTopicInput!)

Input data for updating an existing topic.