The Mod API allows you to manage mods for your DayZ server instances. Mods are used to track which game modifications items belong to.
Note: All API requests require authentication. See the Authentication page for details.
Retrieve a paginated list of mods for a specific instance.
GET /api/instance/{instance_sid}/mod
Parameter | Type | Description |
---|---|---|
instance_sid
|
string | The SID of the instance |
Parameter | Type | Description |
---|---|---|
page
|
integer | Page number for pagination (default: 1) |
amount
|
integer | Number of items per page (default: 30) |
like
|
string | Filter mods by name (partial match) |
{ "current_page": 1, "data": [ { "sid": "abc123", "name": "Vanilla", "url": null, "is_vanilla": true }, { "sid": "def456", "name": "CUP Weapons", "url": "https://steamcommunity.com/sharedfiles/filedetails/?id=123456789", "is_vanilla": false } ], "first_page_url": "http://example.com/api/instance/xyz789/mod?page=1", "from": 1, "last_page": 1, "last_page_url": "http://example.com/api/instance/xyz789/mod?page=1", "links": [ { "url": null, "label": "« Previous", "active": false }, { "url": "http://example.com/api/instance/xyz789/mod?page=1", "label": "1", "active": true }, { "url": null, "label": "Next »", "active": false } ], "next_page_url": null, "path": "http://example.com/api/instance/xyz789/mod", "per_page": 30, "prev_page_url": null, "to": 2, "total": 2 }
Retrieve details of a specific mod.
GET /api/instance/{instance_sid}/mod/{mod_sid}
Parameter | Type | Description |
---|---|---|
instance_sid
|
string | The SID of the instance |
mod_sid
|
string | The SID of the mod |
{ "id": 1, "sid": "abc123", "instance_id": 1, "name": "Vanilla", "url": null, "is_vanilla": true, "created_at": "2023-05-01T12:00:00.000000Z", "updated_at": "2023-05-01T12:00:00.000000Z" }
Create a new mod for an instance.
POST /api/instance/{instance_sid}/mod
Parameter | Type | Description |
---|---|---|
instance_sid
|
string | The SID of the instance |
Parameter | Type | Required | Description |
---|---|---|---|
name
|
string | Required | Name of the mod |
url
|
string | Optional | URL to the mod (e.g., Steam Workshop link) |
is_vanilla
|
boolean | Optional | Whether this is the vanilla (base game) mod |
{ "id": 2, "sid": "def456", "instance_id": 1, "name": "CUP Weapons", "url": "https://steamcommunity.com/sharedfiles/filedetails/?id=123456789", "is_vanilla": false, "created_at": "2023-05-01T12:00:00.000000Z", "updated_at": "2023-05-01T12:00:00.000000Z" }
Update an existing mod.
PATCH /api/instance/{instance_sid}/mod/{mod_sid}
Parameter | Type | Description |
---|---|---|
instance_sid
|
string | The SID of the instance |
mod_sid
|
string | The SID of the mod |
Parameter | Type | Required | Description |
---|---|---|---|
name
|
string | Optional | New name of the mod |
url
|
string | Optional | New URL to the mod |
is_vanilla
|
boolean | Optional | Whether this is the vanilla (base game) mod |
{ "id": 2, "sid": "def456", "instance_id": 1, "name": "CUP Weapons and Vehicles", "url": "https://steamcommunity.com/sharedfiles/filedetails/?id=123456789", "is_vanilla": false, "created_at": "2023-05-01T12:00:00.000000Z", "updated_at": "2023-05-01T12:30:00.000000Z" }
Delete a mod.
Warning: Deleting a mod will also delete all classnames associated with it. This action cannot be undone.
DELETE /api/instance/{instance_sid}/mod/{mod_sid}
Parameter | Type | Description |
---|---|---|
instance_sid
|
string | The SID of the instance |
mod_sid
|
string | The SID of the mod |
{ "result": true }