Draft

Beta: Create a draft slot

post

Create a new draft slot for a specific site. The slot will be created in draft state without a zone or scheduled times.

Draft slots allow you to:

• Pre-register a booking before scheduling
• Add notes and references
• Include custom fields

Authorizations

ApiKeyAuth

AuthenticationstringRequired

Authentication is token based. You can issue a token for your API request from the 'API' section of the settings menu. The token MUST be sent in a Authorization header with each request.

Example of authenticated request

$ curl -X GET -H "Authorization: Token <your token>" "https://api.dashdoc.eu/api/v4/"

Path parameters

site-slugstringRequired

The slug identifier of the site

Body

application/json

notestring · nullableOptional

Optional note for the slot (can be blank or null)

Responses

201

Draft slot created successfully

application/json

400

Bad request - validation error

application/json

404

Site not found

application/json

post

/flow/sites/{site-slug}/slots/draft/

HTTPcURLJavaScriptPython

POST /api/v4/flow/sites/{site-slug}/slots/draft/ HTTP/1.1
Host: api.dashdoc.eu
Authentication: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 35

{
  "company": {
    "remote_id": "COMP789"
  }
}

Minimal requestWith noteWith referencesComplete with custom fields

{
  "uid": "550e8400-e29b-41d4-a716-446655440000",
  "company": {
    "pk": 123,
    "remote_id": "COMP789",
    "name": "Acme Corporation"
  },
  "state": "draft",
  "note": "Special delivery instructions",
  "fields": {
    "references": [
      "ORDER123",
      "SHIPMENT456"
    ],
    "Order Number": "12345",
    "Delivery Instructions": "Use back door"
  }
}