Update References

Beta: Update slot references

post

Updates slot references and custom fields. The custom fields (e.g., custom_field_1, custom_field_2) depend on the custom fields defined in the zone related to the updated slot. This endpoint allows partial updates to slot references and custom fields without affecting other slot properties.

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

referencesstring[] · nullableRequired

List of reference strings for the slot

custom_field_1stringOptional

Value for the first custom field (if defined in the zone)

custom_field_2stringOptional

Value for the second custom field (if defined in the zone)

Responses

200

Slot references updated successfully

application/json

uidstringRequired

Unique identifier for the slot

start_timestring · date-timeRequired

Start time of the slot in ISO 8601 format

end_timestring · date-timeRequired

End time of the slot in ISO 8601 format

statestring · enumRequired

Current state of the slot

Possible values:

notestringOptional

Optional note for the slot

400

Bad request - invalid input. Structural validation errors are returned as a single non_field_errors umbrella with code: ["invalid_input"] and one detail entry per offending field, formatted as "<dotted-loc>: <message>" (e.g. "references: Field required" or "references[0]: String should have at most 128 characters"). Custom-field-vs-zone-specs errors keep a per-field response shape.

application/json

post/flow/sites/{site-slug}/slots/{slot-uid}/update-references/

HTTPcURLJavaScriptPython

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

{
  "references": [
    "text"
  ],
  "custom_field_1": "text",
  "custom_field_2": "text"
}

{
  "uid": "text",
  "zone": {
    "uid": "text",
    "name": "text"
  },
  "company": {
    "pk": 456,
    "remote_id": "CARRIER_123",
    "name": "Transporteur A"
  },
  "start_time": "2026-07-11T02:55:44.294Z",
  "end_time": "2026-07-11T02:55:44.294Z",
  "state": "draft",
  "note": "text",
  "fields": {
    "references": [
      "value1",
      "value2"
    ],
    "custom_field_1": "value",
    "custom_field_2": "value"
  }
}