Wiki Navigation

API Reference
CRUD Operations

Instances API

Manage your DayZ server instances programmatically. Create, read, update, and delete instances along with their associated configurations and resources.

Authentication required: All endpoints require a valid Bearer token. See Authentication for details.

GET

List Instances

Retrieve a paginated list of all your instances.

Endpoint

GET /api/instance

Query Parameters

page integer

Page number for pagination. Defaults to 1.

amount integer

Number of items per page. Defaults to 30.

like string

Filter instances by name using partial match.

Response

{
  "current_page": 1,
  "data": [
    {
      "id": 1,
      "sid": "abc123",
      "name": "My DayZ Server",
      "map_id": 1,
      "ip": "192.168.1.1",
      "port": 2302,
      "query_port": 27016
    }
  ],
  "per_page": 30,
  "total": 1
}
GET

Get Instance

Retrieve details of a specific instance by its SID.

Endpoint

GET /api/instance/{instance_sid}

URL Parameters

instance_sid
string required

The unique SID identifier of the instance.

Response

{
  "id": 1,
  "sid": "abc123",
  "name": "My DayZ Server",
  "map_id": 1,
  "ip": "192.168.1.1",
  "port": 2302,
  "query_port": 27016,
  "hostname": "example.com",
  "connection_port": 21,
  "username": "ftpuser",
  "is_sftp": false,
  "dir": "/dayz",
  "use_vanilla_classnames": true,
  "use_types_config": true,
  "map": {
    "id": 1,
    "name": "Chernarus",
    "name_short": "cherno"
  }
}
POST

Create Instance

Create a new server instance with the specified configuration.

Endpoint

POST /api/instance

Request Body

name
string required

Name of the instance

map_id
integer required

ID of the map

ip string

Server IP address

port integer

Game port (default: 2302)

query_port integer

Query port for server status

hostname string

FTP/SFTP hostname

is_sftp boolean

Use SFTP instead of FTP

dir string

Server directory path

PATCH

Update Instance

Update an existing instance. Include only the fields you want to change.

Endpoint

PATCH /api/instance/{instance_sid}

URL Parameters

instance_sid
string required

The unique SID identifier of the instance to update.

Request body accepts the same fields as Create Instance. Only include fields you want to update.

DELETE

Delete Instance

Permanently delete an instance and all associated data. This action cannot be undone.

Endpoint

DELETE /api/instance/{instance_sid}

URL Parameters

instance_sid
string required

The unique SID identifier of the instance to delete.

Warning: Deleting an instance removes all associated classnames, types, categories, and configurations permanently.

Pro Tips

Use the like parameter to search for instances by name when managing multiple servers. Store instance SIDs in your application for quick access to specific servers without listing all instances first.