Skip to content

Steam Workshop API

Prefix: /api/steam/workshop

Manages Steam Workshop items — browsing subscribed items, publishing, and local mod management.

INFO

Steam Workshop features require the Steam client to be running and the Steamworks SDK to be initialized.

Items

GET /api/steam/workshop/subscribed-items

Get all subscribed Steam Workshop items.

GET /api/steam/workshop/item/{item_id}

Get details for a specific Workshop item.

POST /api/steam/workshop/publish

Publish a new item to Steam Workshop.

Body: Item metadata. Required fields: title, content_folder, visibility (plus other optional metadata such as description, tags).

WARNING

Publishing uses a serialized lock to prevent concurrent publish operations.

Configuration

GET /api/steam/workshop/config

Get Workshop configuration (Workshop root path, metadata).

Workshop metadata

Workshop items store character card metadata in .workshop_meta.json files within their directories. This includes:

  • Character personality data
  • Model bindings
  • Voice configuration
  • Publication metadata

Path traversal protection is enforced on all file operations.

Released under the MIT License.