Skip to content

Action Database CRUD

Performs reads, creations, updates, or deletes (CRUD) on the API-backed database collections.

Inputs: 1 · Outputs: Then

Settings

SettingTypeRequiredDefaultDescription
OperationSelectYesGetThe CRUD action to perform: Get, Create, Update, or Delete.
Collection NameStringYesThe database collection to query or mutate (e.g. forumUser or forumSession).
Entry IDStringNoThe direct entry ID for targeted operations. Strongly recommended for update or delete.
Query JSONMultilineNoOptional JSON filter to locate entries by fields instead of entry ID.
Payload JSONMultilineYesJSON body written on create or merged into the existing entry on update.
LimitSliderNo1Maximum number of entries to return when reading by query.
SkipNumberNo0Number of entries to skip before returning results.
Upsert When MissingBooleanNofalseIf enabled during an update, a new entry is created if no matching entry exists.

Query and Payload Formats

Get Entries by Field Query

  • Operation: Get
  • Query JSON: {"minecraftUuid":"%player.uuid%"}
  • Limit: 1

Create a New Entry

  • Operation: Create
  • Payload JSON: {"minecraftUuid":"%player.uuid%","forumUserId":"%forum_user_id%","registeredAt":"%date%"}

Update an Entry with Upsert

  • Operation: Update
  • Query JSON: {"minecraftUuid":"%player.uuid%"}
  • Payload JSON: {"lastActive":"%date%","loginCount": 1}
  • Upsert When Missing: Enabled

Oasis Admin Editor Documentation