--- title: "POST used_material" method: POST path: "/v3/administrations/{administration_id}/todos/{todo_id}/used_materials" tags: ["Todo UsedMaterials"] --- # POST used_material `POST /v3/administrations/{administration_id}/todos/{todo_id}/used_materials` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/todos/{todo_id}/used_materials` - Auth: one of: - API key in header `X-API-KEY` - OAuth 2 - Authorization code: `/oauth/authorize` - Token URL: `/oauth/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Add a new used material for a Todo ## Path parameters - `todo_id` string, required - `administration_id` string, required ## Query parameters - `fields[used_material]` string - `include` string ## Headers - `Accept-Language` string ## Request body - object - `data` object: A material that has been used as part of a Todo. - `type` string: Type - `attributes` object: Attributes - `quantity` integer - `description` string - `relationships` object: Relationships - `task_cost` object - `data` object - `id` string: task_cost ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `included` TaskCost[] - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `description` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `price` number, double - `archived` boolean - `created_at` string, date-time - `updated_at` string, date-time - `relationships` object: Relationships - `account` object - `data` object - `id` string: account ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `used_materials` object - `data` object[] - `id` string: used_materials ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. ## Response `200` UsedMaterialResponse - object - `data` UsedMaterial: A material that has been used as part of a Todo. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `quantity` integer - `description` string - `created_at` string, date-time - `updated_at` string, date-time - `relationships` object: Relationships - `task_cost` object - `data` object - `id` string: task_cost ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `todo` object - `data` object - `id` string: todo ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `included` union[] - union - TaskCost: A task cost of an administration - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `description` object - `cs` string - `da-DK` string - `de` string - `de-AT` string - `de-CH` string - `en-US` string - `en-GB` string - `es` string - `fr` string - `fr-BE` string - `fr-LU` string - `it` string - `nb` string - `nl` string - `nl-BE` string - `pl` string - `pt` string - `tr` string - `en` string - `da` string - `price` number, double - `archived` boolean - `created_at` string, date-time - `updated_at` string, date-time - `relationships` object: Relationships - `account` object - `data` object - … - `used_materials` object - `data` object[] - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - Todo: A todo is a task that needs to be done before a given deadline. It has an optional relationship to a Reservation or TodoList. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `deadline` string, date - `quantity` integer - `name` string, required - `description` string - `details` string - `blocker` boolean: Yields whether this todo blocks check-in - `checkable` boolean: Yields whether this todo should be checked after being finished - `taxable` boolean: Yields whether this todo is taxable after being checked - `urgent` boolean: This will notify the executor of the todo via SMS - `checked_at` string, date-time - `finished_at` string, date-time - `timesheet_hours` number, double: Total time written in hours - `automatically_generated` boolean: Returns whether the todo was generated by an Automatic todo. - `memo` string: An optional note - `created_at` string, date-time - `updated_at` string, date-time - `links` object: Links - `self` string: Link to self - `url` string: Link to url - `relationships` object: Relationships - `executor` object - `data` object - … - `facility` object - `data` object - … - `rentable_identity` object: DEPRECATED use inventory_object instead - `data` object - … - `inventory_object` object - `data` object - … - `todo_list` object - `data` object - … - `reservation` object - `data` object - … - `administration` object - `data` object - … - `creator` object - `data` object - … - `invoice` object - `data` object - … - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. ## Other responses - `429`: Error - `default`: Error ## Changes - **2026-11-03** `ff81bc4fefa9`: 6 info - added the new optional request property `included/items/anyOf[#/components/schemas/TaskCost]/attributes/description/da-DK` - added the new optional request property `included/items/anyOf[#/components/schemas/TaskCost]/attributes/description/en-GB` - added the new optional request property `included/items/anyOf[#/components/schemas/TaskCost]/attributes/description/en-US` - added the optional property `included/items/anyOf[#/components/schemas/TaskCost]/attributes/description/da-DK` to the response with the `200` status - …2 more [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/todos/:todo_id/used_materials/post.md) --- [API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)