> ## Documentation Index > Fetch the complete documentation index at: https://exsited.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Update labour availability in bulk > Sets the availability slots of one or more labours in one call. Send `labours`, an array with one entry per labour: its `id` and the slots to set in `labour_availability` or `labour_custom_availability`. Each slot has a `preferred_day`, `start_time`, `end_time` and `available`. When it succeeds, the update returns `204` with no body. > [!NOTE] > > The SDK samples get their client from credentials your app registers once when it starts, as shown in [Authentication](https://exsited.mintlify.site/authentication.md#set-up-a-client). To try the call here, click **Try it**, set `host` to your Exsited API host name and paste an access token from [Get an access token](https://exsited.mintlify.site/api-reference/authentication/get-an-access-token.md). To send a raw JSON body instead of filling in fields, copy the cURL sample and edit its `-d` payload. ## OpenAPI ````yaml PATCH /labour_availability openapi: 3.1.0 info: title: Exsited API version: v4 servers: - url: https://{host}/api/v4 variables: host: default: your-api-host.example.com description: Your Exsited API host name, without https://. security: - bearerAuth: [] tags: - name: Authentication - name: Accounts - name: Account emails - name: Account groups - name: Communications - name: Communication profiles - name: Orders - name: Quote orders - name: Express - name: Usages - name: Sales reps - name: Gift certificates - name: Invoices - name: Pro-forma invoices - name: Payments - name: Refunds - name: Credit notes - name: Credit note applications - name: Reconciliations - name: Items - name: Inventory adjustments - name: Units of measurement - name: Zones - name: Shipping packages - name: Shipping rules - name: Fulfillment profiles - name: Fulfillment terms - name: Item fulfillments - name: Item receipts - name: Bookings - name: Rental assets - name: Return merchandise authorisations - name: Purchase orders - name: Purchase invoices - name: Purchase payments - name: Purchase refunds - name: Purchase credit notes - name: Purchase credit note applications - name: Purchase express - name: Return vendor authorizations - name: ABA files - name: Receive terms - name: Labours - name: Tasks - name: Timesheets - name: Milestones - name: Employees - name: Departments - name: Designations - name: Teams - name: Time periods - name: Workflows - name: Workflow settings - name: Events - name: Custom events - name: System events - name: Approvals - name: Approval profiles - name: Approval user groups - name: Alerts - name: Alert responsibility settings - name: Alert responsibilities - name: Action scripts - name: Note groups - name: Note attachments - name: Instance settings - name: Accounting codes - name: Additional codes - name: Billing periods - name: Charging periods - name: Pricing periods - name: Invoice terms - name: Days of the month - name: Countries - name: Salutations - name: Document templates - name: Email templates - name: Roles - name: Operators - name: Operator groups - name: User settings - name: Custom attributes - name: Custom components - name: Custom features - name: Custom fields - name: Custom forms - name: Attribute attachments - name: Portal - name: Integration connections - name: External databases - name: Reports - name: Applications - name: Organisation - name: Child organisations - name: Webhooks paths: /labour_availability: patch: tags: - Labours summary: Update labour availability in bulk description: >- Send `labours`, an array with one entry per labour: its `id` and the slots to set in `labour_availability` or `labour_custom_availability`. Each slot has a `preferred_day`, `start_time`, `end_time` and `available`. When it succeeds, the update returns `204` with no body. operationId: labours_update_labour_availability parameters: [] requestBody: required: true content: application/json: schema: type: object properties: labours: type: array items: type: object properties: id: type: string description: The labour's `id`. labour_availability: type: array items: type: object properties: preferred_day: type: string description: >- The day of the week, in lower case, such as `monday`. start_time: type: string description: The start time, as `HH:MM`. end_time: type: string description: The end time, as `HH:MM`. available: type: boolean labour_custom_availability: type: array items: type: object properties: preferred_day: type: string description: >- The day of the week, in lower case, such as `monday`. start_time: type: string description: The start time, as `HH:MM`. end_time: type: string description: The end time, as `HH:MM`. available: type: boolean required: - id required: - labours example: labours: - id: 0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d labour_custom_availability: - preferred_day: monday start_time: '09:00' end_time: '12:00' available: true responses: '204': description: The availability is updated. No body. x-codeSamples: - lang: bash label: cURL source: |- curl -X PATCH "$EXSITED_BASE_URL/api/v4/labour_availability" \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "labours": [ { "id": "0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d", "labour_custom_availability": [ { "preferred_day": "monday", "start_time": "09:00", "end_time": "12:00", "available": true } ] } ] }' - lang: python label: Python source: | from exsited import build_client client = build_client() response = client.labours.update_labour_availability( { "labours": [ { "id": "0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d", "labour_custom_availability": [ { "preferred_day": "monday", "start_time": "09:00", "end_time": "12:00", "available": True, } ], } ] } ) print(response.data) - lang: javascript label: JavaScript source: | import {buildClient} from 'exsited'; const client = await buildClient(); const response = await client.labours.updateLabourAvailability({ labours: [ { id: '0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d', labour_custom_availability: [ {preferred_day: 'monday', start_time: '09:00', end_time: '12:00', available: true}, ], }, ], }); console.log(response.data); - lang: php label: PHP source: | use Exsited\Client\ClientRegistry; $client = ClientRegistry::buildClient(); $response = $client->labours->updateLabourAvailability([ 'labours' => [ [ 'id' => '0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d', 'labour_custom_availability' => [ [ 'preferred_day' => 'monday', 'start_time' => '09:00', 'end_time' => '12:00', 'available' => true, ], ], ], ], ]); print_r($response->data); - lang: java label: Java source: > import com.exsited.Dto; import com.exsited.client.ApiResponse; import com.exsited.client.ClientRegistry; import com.exsited.client.ExsitedClient; import java.util.List; import java.util.Map; ExsitedClient client = ClientRegistry.buildClient(); ApiResponse response = client.labours().updateLabourAvailability( Map.of( "labours", List.of( Map.of( "id", "0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d", "labour_custom_availability", List.of( Map.of( "preferred_day", "monday", "start_time", "09:00", "end_time", "12:00", "available", true)))))); System.out.println(response.getMap()); - lang: csharp label: .NET source: > using Exsited.Client; await using var client = ExsitedClient.BuildClient(); var response = await client.Labours.UpdateLabourAvailabilityAsync(new Dictionary { ["labours"] = new List { new Dictionary { ["id"] = "0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d", ["labour_custom_availability"] = new List { new Dictionary { ["preferred_day"] = "monday", ["start_time"] = "09:00", ["end_time"] = "12:00", ["available"] = true, }, }, }, }, }); Console.WriteLine(response.Json); - lang: dart label: Dart source: | import 'package:exsited/exsited.dart'; final client = buildClient(); final response = await client.labours.updateLabourAvailability({ 'labours': [ { 'id': '0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d', 'labour_custom_availability': [ { 'preferred_day': 'monday', 'start_time': '09:00', 'end_time': '12:00', 'available': true, }, ], }, ], }); print(response.map); - lang: go label: Go source: "import (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\n\texsited \"github.com/exsited/exsited-sdk-go/v4\"\n)\n\nclient, err := exsited.BuildClient(nil)\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer client.Close()\n\nresponse, err := client.Labours().UpdateLabourAvailability(context.Background(), map[string]any{\n\t\"labours\": []any{\n\t\tmap[string]any{\n\t\t\t\"id\": \"0b6f3d2a-8c4e-4f1a-9d7b-2e5c8a1f3b6d\",\n\t\t\t\"labour_custom_availability\": []any{\n\t\t\t\tmap[string]any{\n\t\t\t\t\t\"preferred_day\": \"monday\",\n\t\t\t\t\t\"start_time\": \"09:00\",\n\t\t\t\t\t\"end_time\": \"12:00\",\n\t\t\t\t\t\"available\": true,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t},\n}, nil)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Println(response.Map)\n" components: securitySchemes: bearerAuth: type: http scheme: bearer description: >- An access token from `POST /api/v4/oauth2/token`. The SDKs get and renew it for you. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.