> For the complete documentation index, see [llms.txt](https://developer.dashdoc.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.dashdoc.com/docs/api-reference/flow-beta.md).

# Flow (beta)

## POST /flow/sites/{site-slug}/companies/

> Beta: Create a company

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"FlowCompanyRequest":{"properties":{"remote_id":{"description":"The ID of the company in your system","type":"string"},"name":{"description":"Company name","type":"string"},"address":{"$ref":"#/components/schemas/FlowCompanyRequest_address"}},"required":["address","name","remote_id"],"type":"object"},"FlowCompanyRequest_address":{"properties":{"address":{"description":"Address","type":"string"},"postcode":{"description":"Postal code","type":"string"},"city":{"description":"City name","type":"string"},"country":{"description":"Country code","type":"string"}},"required":["city","country","postcode"],"type":"object"},"FlowCompany":{"properties":{"uid":{"description":"Unique identifier for the company","format":"uuid","type":"string"},"remote_id":{"description":"The ID of the company in your system","type":"string"},"name":{"description":"Company name","type":"string"},"address":{"$ref":"#/components/schemas/FlowCompanyRequest_address"}},"type":"object"},"inline_response_400":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_non_field_errors"}},"type":"object"},"inline_response_400_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/companies/":{"post":{"operationId":"createFlowCompany","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowCompanyRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FlowCompany"}}},"description":"Company created successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400"}}},"description":"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. `\"address.city: Field required\"`). The `company_remote_id_conflict` semantic error keeps its own named code."}},"summary":"Beta: Create a company","tags":["Flow (beta)"]}}}}
````

## GET /flow/sites/{site-slug}/slots/

> Beta: Get booked slots for a site

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"SlotsResponse":{"properties":{"count":{"description":"Total number of slots","type":"integer"},"next":{"description":"URL for the next page of results","nullable":true,"type":"string"},"previous":{"description":"URL for the previous page of results","nullable":true,"type":"string"},"results":{"description":"Array of slot objects","items":{"$ref":"#/components/schemas/Slot"},"type":"array"}},"required":["count","results"],"type":"object"},"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"},"inline_response_400_1":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_1_non_field_errors"}},"type":"object"},"inline_response_400_1_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"},"inline_response_404":{"properties":{"detail":{"type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/":{"get":{"operationId":"getSiteSlots","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"Filter slots updated since this datetime. Must be an RFC 3339 timestamp carrying a UTC offset (e.g. `2026-01-01T00:00:00Z` or `2026-01-01T01:00:00+01:00`); a value without an offset is rejected with a 400.\n","in":"query","name":"updated_since","required":false,"schema":{"format":"date-time","type":"string"}},{"description":"Page number for pagination","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Include draft slots in the response","in":"query","name":"include_draft","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Filter slots by custom field label/value pairs.\nPass a JSON-encoded object where keys are custom field labels and values are the expected values.\nThe value comparison is case-insensitive.\nMultiple custom field filters are combined with AND logic.\n\nExample: `?custom_fields={\"Order Number\": \"ORD123\", \"Truck Color\": \"blue\"}`\n","in":"query","name":"custom_fields","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotsResponse"}}},"description":"Get successful"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400_1"}}},"description":"Bad request - invalid query parameters. Validation errors are returned as a single `non_field_errors` umbrella with `code: [\"invalid_input\"]` and one `detail` entry per offending parameter, formatted as `\"<parameter>: <message>\"`. Raised when `include_draft` is not a boolean, when `updated_since` is not an RFC 3339 datetime carrying a UTC offset, or when `custom_fields` is not a JSON object. Unknown query parameters are ignored, and blank ones (e.g. `?updated_since=`) are read as \"no filter\"."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_404"}}},"description":"Site not found"}},"summary":"Beta: Get booked slots for a site","tags":["Flow (beta)"]}}}}
````

## Beta: Create a draft slot

> 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<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"SlotDraftRequest":{"properties":{"company":{"description":"Company information. Either 'remote_id' or 'pk' must be provided, but not both.","oneOf":[{"required":["remote_id"],"type":"object"},{"required":["pk"],"type":"object"}],"properties":{"remote_id":{"description":"Company remote identifier (external ID)","type":"string"},"pk":{"description":"Company primary key (internal ID)","type":"integer"}},"type":"object"},"note":{"description":"Optional note for the slot (can be blank or null)","nullable":true,"type":"string"},"fields":{"additionalProperties":{"description":"Custom field values (any type will be converted to string). Note that custom fields cannot be validated against zone specifications since draft slots don't have a zone assigned yet.","type":"string"},"description":"Optional fields containing references and/or custom fields. Custom fields are provided as key-value pairs where keys are field labels (strings) and values will be converted to strings.","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"type":"array"}},"type":"object"}},"required":["company"],"type":"object"},"DraftSlot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/DraftSlot_zone"},"company":{"$ref":"#/components/schemas/DraftSlot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format (null for draft slots until scheduled)","format":"date-time","nullable":true,"type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format (null for draft slots until scheduled)","format":"date-time","nullable":true,"type":"string"},"state":{"description":"State of the slot (always \"draft\" for draft slots)","enum":["draft"],"type":"string"},"note":{"description":"Optional note for the slot","nullable":true,"type":"string"},"fields":{"additionalProperties":{"description":"Custom field values returned as key-value pairs","type":"string"},"description":"Custom fields for the slot including references and any custom field labels","properties":{"references":{"description":"List of reference strings for the slot","items":{"type":"string"},"nullable":true,"type":"array"}},"type":"object"}},"required":["state","uid"],"type":"object"},"DraftSlot_zone":{"description":"Zone information (null for draft slots as they are not assigned to a zone yet)","nullable":true,"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"DraftSlot_company":{"description":"Company associated with the slot","properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier (external ID)","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"inline_response_400_2":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_2_non_field_errors"}},"type":"object"},"inline_response_400_2_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"},"inline_response_404_3":{"properties":{"error":{"type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/draft/":{"post":{"description":"Create a new draft slot for a specific site. The slot will be created in draft state without a zone or scheduled times.\n\nDraft slots allow you to:\n- Pre-register a booking before scheduling\n- Add notes and references\n- Include custom fields\n","operationId":"createDraftSlot","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotDraftRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DraftSlot"}}},"description":"Draft slot created successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400_2"}}},"description":"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. `\"company: Field required\"`). The `company_requires_remote_id_or_pk` semantic error keeps its own named code."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_404_3"}}},"description":"Site not found"}},"summary":"Beta: Create a draft slot","tags":["Flow (beta)"]}}}}
````

## Beta: Create a planned slot

> Create a new planned slot for a specific site. The slot will be created in planned state. The custom fields (e.g., \`custom\_field\_1\`, \`custom\_field\_2\`) depend on the custom fields defined in the zone related to the created slot.

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"SlotPlannedRequest":{"properties":{"zone":{"$ref":"#/components/schemas/SlotPlannedRequest_zone"},"company":{"description":"Company identification. Either remote_id or pk must be provided, but not both.","oneOf":[{"required":["remote_id"],"type":"object"},{"required":["pk"],"type":"object"}],"properties":{"remote_id":{"description":"Company remote identifier","type":"string"},"pk":{"description":"Company primary key","type":"integer"}},"type":"object"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","zone"],"type":"object"},"SlotPlannedRequest_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"}},"required":["uid"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"},"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"inline_response_400_3":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_3_non_field_errors"}},"type":"object"},"inline_response_400_3_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/planned/":{"post":{"description":"Create a new planned slot for a specific site. The slot will be created in planned state. The custom fields (e.g., `custom_field_1`, `custom_field_2`) depend on the custom fields defined in the zone related to the created slot.","operationId":"createSiteSlotPlanned","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotPlannedRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot created successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400_3"}}},"description":"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. `\"start_time: Field required\"`). Semantic errors (`zone_not_found`, `company_not_found`, `company_requires_remote_id_or_pk`, custom-field-not-in-zone-specs, `end_time must be after start_time`) keep their named codes and may use a per-field response shape."}},"summary":"Beta: Create a planned slot","tags":["Flow (beta)"]}}}}
````

## Beta: Update slot references

> 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.

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"SlotUpdateReferencesRequest":{"properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"required":["references"],"type":"object"},"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"},"inline_response_400_4":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_4_non_field_errors"}},"type":"object"},"inline_response_400_4_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/update-references/":{"post":{"description":"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.","operationId":"updateSlotReferences","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotUpdateReferencesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot references updated successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400_4"}}},"description":"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."}},"summary":"Beta: Update slot references","tags":["Flow (beta)"]}}}}
````

## Beta: Reassign a slot to a different company

> Reassign a slot to another carrier company. You can identify the target company using either its primary key (pk) or remote\_id. The slot can be reassigned regardless of its current state (planned, draft, etc.).

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"SlotReassignRequest":{"properties":{"company":{"description":"Company identification. Either remote_id or pk must be provided, but not both.","oneOf":[{"required":["remote_id"],"type":"object"},{"required":["pk"],"type":"object"}],"properties":{"remote_id":{"description":"Company remote identifier","type":"string"},"pk":{"description":"Company primary key","type":"integer"}},"type":"object"}},"required":["company"],"type":"object"},"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"},"inline_response_400_2":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_2_non_field_errors"}},"type":"object"},"inline_response_400_2_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"},"inline_response_404_4":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_404_4_non_field_errors"}},"type":"object"},"inline_response_404_4_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/reassign/":{"post":{"description":"Reassign a slot to another carrier company. You can identify the target company using either its primary key (pk) or remote_id. The slot can be reassigned regardless of its current state (planned, draft, etc.).","operationId":"reassignSlot","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotReassignRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot reassigned successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400_2"}}},"description":"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. `\"company: Field required\"`). The `company_requires_remote_id_or_pk` semantic error keeps its own named code under `non_field_errors`."},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_404_4"}}},"description":"Company or slot not found"}},"summary":"Beta: Reassign a slot to a different company","tags":["Flow (beta)"]}}}}
````

## Beta: Cancel slot

> Cancel a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"requestBodies":{"inline_object_5":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_5"}}},"required":true}},"schemas":{"inline_object_5":{"properties":{"reason":{"description":"The reason for cancelling the slot","type":"string"}},"required":["reason"],"type":"object"},"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"},"inline_response_400_5":{"properties":{"non_field_errors":{"$ref":"#/components/schemas/inline_response_400_5_non_field_errors"}},"type":"object"},"inline_response_400_5_non_field_errors":{"properties":{"code":{"items":{"type":"string"},"type":"array"},"detail":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/cancel/":{"post":{"description":"Cancel a slot","operationId":"cancelSlot","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/inline_object_5","content":{"application/json":{"schema":{"properties":{"reason":{"description":"The reason for cancelling the slot","type":"string"}},"required":["reason"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot cancelled successfully"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_response_400_5"}}},"description":"Bad request - invalid input. 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. `\"reason: String should have at least 1 character\"`)."}},"summary":"Beta: Cancel slot","tags":["Flow (beta)"]}}}}
````

## Beta: Confirm slot arrival

> Confirm arrival for a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/confirm-arrival/":{"post":{"description":"Confirm arrival for a slot","operationId":"confirmSlotArrival","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot arrival confirmed successfully"}},"summary":"Beta: Confirm slot arrival","tags":["Flow (beta)"]}}}}
````

## Beta: Cancel slot arrival

> Cancel arrival for a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/cancel-arrival/":{"post":{"description":"Cancel arrival for a slot","operationId":"cancelSlotArrival","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot arrival cancelled successfully"}},"summary":"Beta: Cancel slot arrival","tags":["Flow (beta)"]}}}}
````

## Beta: Confirm slot handling

> Confirm handling for a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/confirm-handling/":{"post":{"description":"Confirm handling for a slot","operationId":"confirmSlotHandling","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot handling confirmed successfully"}},"summary":"Beta: Confirm slot handling","tags":["Flow (beta)"]}}}}
````

## Beta: Cancel slot handling

> Cancel handling for a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/cancel-handling/":{"post":{"description":"Cancel handling for a slot","operationId":"cancelSlotHandling","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot handling cancelled successfully"}},"summary":"Beta: Cancel slot handling","tags":["Flow (beta)"]}}}}
````

## Beta: Complete slot

> Complete a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/complete/":{"post":{"description":"Complete a slot","operationId":"completeSlot","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot completed successfully"}},"summary":"Beta: Complete slot","tags":["Flow (beta)"]}}}}
````

## Beta: Cancel slot completion

> Cancel completion for a slot

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"Slot":{"properties":{"uid":{"description":"Unique identifier for the slot","type":"string"},"zone":{"$ref":"#/components/schemas/Slot_zone"},"company":{"$ref":"#/components/schemas/Slot_company"},"start_time":{"description":"Start time of the slot in ISO 8601 format","format":"date-time","type":"string"},"end_time":{"description":"End time of the slot in ISO 8601 format","format":"date-time","type":"string"},"state":{"description":"Current state of the slot","enum":["draft","planned","arrived","handled","completed","departed","cancelled"],"type":"string"},"note":{"description":"Optional note for the slot","type":"string"},"fields":{"$ref":"#/components/schemas/SlotFields"}},"required":["company","end_time","start_time","state","uid","zone"],"type":"object"},"Slot_zone":{"properties":{"uid":{"description":"Zone unique identifier","type":"string"},"name":{"description":"Zone name","type":"string"}},"required":["name","uid"],"type":"object"},"Slot_company":{"properties":{"pk":{"description":"Company primary key","type":"integer"},"remote_id":{"description":"Company remote identifier","type":"string"},"name":{"description":"Company name","type":"string"}},"required":["name","pk"],"type":"object"},"SlotFields":{"description":"Custom fields for the slot","properties":{"references":{"description":"List of reference strings for the slot","items":{"maxLength":128,"type":"string"},"nullable":true,"type":"array"},"custom_field_1":{"description":"Value for the first custom field (if defined in the zone)","type":"string"},"custom_field_2":{"description":"Value for the second custom field (if defined in the zone)","type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/cancel-completion/":{"post":{"description":"Cancel completion for a slot","operationId":"cancelSlotCompletion","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Slot"}}},"description":"Slot completion cancelled successfully"}},"summary":"Beta: Cancel slot completion","tags":["Flow (beta)"]}}}}
````

## Beta: List documents attached to a slot

> Return the documents attached to a slot, ordered by upload date\
> (most recent first).<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"schemas":{"SlotDocument":{"properties":{"uid":{"description":"Unique identifier for the document","type":"string"},"slot_uid":{"description":"Unique identifier of the slot the document is attached to","type":"string"},"name":{"description":"Display name of the document","type":"string"},"file":{"description":"URL of the uploaded file","format":"uri","type":"string"},"file_size":{"description":"File size in bytes","type":"integer"},"created":{"description":"Upload timestamp in ISO 8601 format","format":"date-time","type":"string"},"created_by_user":{"$ref":"#/components/schemas/SlotDocument_created_by_user"}},"required":["created","file","file_size","name","slot_uid","uid"],"type":"object"},"SlotDocument_created_by_user":{"description":"User who uploaded the document. Null if the user has been deleted.","nullable":true,"properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/documents/":{"get":{"description":"Return the documents attached to a slot, ordered by upload date\n(most recent first).\n","operationId":"listSlotDocuments","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SlotDocument"},"type":"array"}}},"description":"List of documents attached to the slot"},"404":{"description":"Site or slot not found."}},"summary":"Beta: List documents attached to a slot","tags":["Flow (beta)"]}}}}
````

## Beta: Upload a document on a slot

> Attach a document (PDF, JPEG or PNG, up to 10 MB) to a slot. Up to 10\
> non-deleted documents can be attached to the same slot. Uploads are\
> rejected on cancelled slots. The created document is returned.<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"requestBodies":{"inline_object_6":{"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/inline_object_6"}}},"required":true}},"schemas":{"inline_object_6":{"properties":{"file":{"description":"The document file (PDF, JPEG or PNG, max 10 MB)","format":"binary","type":"string"},"name":{"description":"Optional display name. Defaults to the uploaded file name.","type":"string"}},"required":["file"],"type":"object"},"SlotDocument":{"properties":{"uid":{"description":"Unique identifier for the document","type":"string"},"slot_uid":{"description":"Unique identifier of the slot the document is attached to","type":"string"},"name":{"description":"Display name of the document","type":"string"},"file":{"description":"URL of the uploaded file","format":"uri","type":"string"},"file_size":{"description":"File size in bytes","type":"integer"},"created":{"description":"Upload timestamp in ISO 8601 format","format":"date-time","type":"string"},"created_by_user":{"$ref":"#/components/schemas/SlotDocument_created_by_user"}},"required":["created","file","file_size","name","slot_uid","uid"],"type":"object"},"SlotDocument_created_by_user":{"description":"User who uploaded the document. Null if the user has been deleted.","nullable":true,"properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/documents/":{"post":{"description":"Attach a document (PDF, JPEG or PNG, up to 10 MB) to a slot. Up to 10\nnon-deleted documents can be attached to the same slot. Uploads are\nrejected on cancelled slots. The created document is returned.\n","operationId":"uploadSlotDocument","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/inline_object_6","content":{"multipart/form-data":{"schema":{"properties":{"file":{"description":"The document file (PDF, JPEG or PNG, max 10 MB)","format":"binary","type":"string"},"name":{"description":"Optional display name. Defaults to the uploaded file name.","type":"string"}},"required":["file"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotDocument"}}},"description":"Document uploaded successfully"},"400":{"description":"Bad request. State errors (`slot_cancelled`,\n`slot_document_limit_reached`) are returned with their named code\nunder `non_field_errors`. File validation errors (`file_too_large`,\n`invalid_extension`, `invalid_file_type`) keep their named codes.\nStructural input errors (missing `file`, `name` over 255 chars)\nreturn the umbrella shape: `non_field_errors` with\n`code: [\"invalid_input\"]` and one `detail` entry per offending\nfield, formatted as `\"<dotted-loc>: <message>\"`.\n"},"404":{"description":"Site or slot not found."}},"summary":"Beta: Upload a document on a slot","tags":["Flow (beta)"]}}}}
````

## Beta: Delete a slot document

> Delete a document attached to a slot. Authenticated callers act with\
> site-manager privileges and can delete any document, regardless of which\
> user uploaded it.<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/documents/{doc-uid}/":{"delete":{"description":"Delete a document attached to a slot. Authenticated callers act with\nsite-manager privileges and can delete any document, regardless of which\nuser uploaded it.\n","operationId":"deleteSlotDocument","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the document","in":"path","name":"doc-uid","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Document deleted successfully"},"404":{"description":"Site, slot or document not found."}},"summary":"Beta: Delete a slot document","tags":["Flow (beta)"]}}}}
````

## Beta: Rename a slot document

> Update the display name of a document attached to a slot. Renames are\
> rejected on cancelled slots. Renaming to the same name is a no-op (no\
> history event recorded). Returns the updated document.<br>

````json
{"openapi":"3.0.0","info":{"title":"Dashdoc public API","version":"4.0"},"tags":[{"name":"Flow (beta)"}],"servers":[{"description":"Production","url":"https://api.dashdoc.eu/api/v4"},{"description":"Sandbox","url":"https://sandbox.dashdoc.eu/api/v4"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"description":"Authentication is token based. You can issue a token for your API request from the ['API' section of the settings](http://dashdoc.eu/app/settings/api/) menu. The token MUST be sent in a `Authorization` header with each request.\n\n\n**Example of authenticated request**\n```\n$ curl -X GET -H \"Authorization: Token <your token>\" \"https://api.dashdoc.eu/api/v4/\"\n```\n","in":"header","name":"Authentication","type":"apiKey"}},"requestBodies":{"inline_object_7":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/inline_object_7"}}},"required":true}},"schemas":{"inline_object_7":{"properties":{"name":{"description":"The new display name (1 to 255 characters, trimmed).","maxLength":255,"type":"string"}},"required":["name"],"type":"object"},"SlotDocument":{"properties":{"uid":{"description":"Unique identifier for the document","type":"string"},"slot_uid":{"description":"Unique identifier of the slot the document is attached to","type":"string"},"name":{"description":"Display name of the document","type":"string"},"file":{"description":"URL of the uploaded file","format":"uri","type":"string"},"file_size":{"description":"File size in bytes","type":"integer"},"created":{"description":"Upload timestamp in ISO 8601 format","format":"date-time","type":"string"},"created_by_user":{"$ref":"#/components/schemas/SlotDocument_created_by_user"}},"required":["created","file","file_size","name","slot_uid","uid"],"type":"object"},"SlotDocument_created_by_user":{"description":"User who uploaded the document. Null if the user has been deleted.","nullable":true,"properties":{"email":{"type":"string"},"first_name":{"type":"string"},"last_name":{"type":"string"}},"type":"object"}}},"paths":{"/flow/sites/{site-slug}/slots/{slot-uid}/documents/{doc-uid}/rename/":{"post":{"description":"Update the display name of a document attached to a slot. Renames are\nrejected on cancelled slots. Renaming to the same name is a no-op (no\nhistory event recorded). Returns the updated document.\n","operationId":"renameSlotDocument","parameters":[{"description":"The slug identifier of the site","in":"path","name":"site-slug","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the slot","in":"path","name":"slot-uid","required":true,"schema":{"type":"string"}},{"description":"The unique identifier of the document","in":"path","name":"doc-uid","required":true,"schema":{"type":"string"}}],"requestBody":{"$ref":"#/components/requestBodies/inline_object_7","content":{"application/json":{"schema":{"properties":{"name":{"description":"The new display name (1 to 255 characters, trimmed).","maxLength":255,"type":"string"}},"required":["name"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SlotDocument"}}},"description":"Document renamed successfully"},"400":{"description":"Bad request. The `slot_cancelled` state error is returned with its\nnamed code under `non_field_errors`. Structural input errors\n(missing `name`, blank `name`, `name` over 255 chars) return the\numbrella shape: `non_field_errors` with `code: [\"invalid_input\"]`\nand one `detail` entry per offending field, formatted as\n`\"<dotted-loc>: <message>\"` (e.g. `\"name: Field required\"`).\n"},"404":{"description":"Site, slot or document not found."}},"summary":"Beta: Rename a slot document","tags":["Flow (beta)"]}}}}
````
