Method HandlePUT_nodes_uid_properties

Modules/RESTAPI/src/mitkDataStorageController.cpp:2104–2212

}

void DataStorageController::HandlePUT_nodes_uid_properties(const httplib::Request& req, httplib::Response& res)
{
  if (!m_Bridge.HasDataStorage())
  {
    this->SendErrorResponse(res, 503, ErrorResponse::DataStorageNotAvailable(req.path));
    return;
  }

  const std::string uid = req.path_params.at("uid");
  if (!ValidateUid(uid))
  {
    this->SendErrorResponse(res, 400, ErrorResponse::InvalidRequest("Invalid UID format", req.path));
    return;
  }

  // Check if node exists
  auto nodeCheck = m_Bridge.GetNode(uid);
  if (!nodeCheck.has_value())
  {
    this->SendErrorResponse(res, 404, ErrorResponse::NodeNotFound(uid, req.path));
    return;
  }

  // Parse property query parameters for context and scope
  // Per API spec: PUT /properties defaults to "node" scope
  PropertyQueryParams params;
  try
  {
    params = this->ParsePropertyQueryParams(req, PropertyScope::Node);
  }
  catch (const InvalidQueryParam& e)
  {
    this->SendErrorResponse(res, 400, ErrorResponse::InvalidRequest(e.detail, req.path));
    return;
  }

  // Mutation endpoints do not support scope "all"
  if (params.scope == PropertyScope::All)
  {
    this->SendErrorResponse(res, 400, ErrorResponse::InvalidRequest(
      "Scope 'all' is not supported for property mutation operations. Use 'node' or 'data'.", req.path));
    return;
  }

  // Parse request body
  nlohmann::json properties;
  try
  {
    properties = nlohmann::json::parse(req.body);
  }
  catch (const nlohmann::json::parse_error& e)
  {
    this->SendErrorResponse(res, 400, ErrorResponse::InvalidRequest("Invalid JSON: " + std::string(e.what()), req.path));
    return;
  }

  if (!properties.is_object())
  {