createRevision method

Future<RevisionResponse> createRevision(
  1. String itemKref, {
  2. Map<String, String>? metadata,
  3. int? number,
  4. String? embeddingText,
  5. bool existsError = false,
})
inherited

Creates a new revision for an item.

itemKref is the item's kref URI. metadata is optional key-value pairs to attach. number is optional; if not provided, uses the next available number. existsError controls whether to throw if revision exists (default: false).

Implementation

Future<RevisionResponse> createRevision(
  String itemKref, {
  Map<String, String>? metadata,
  int? number,
  String? embeddingText,
  bool existsError = false,
}) async {
  final request = CreateRevisionRequest()
    ..itemKref = Kref(uri: itemKref)
    ..existsError = existsError;
  if (metadata != null) {
    request.metadata.addAll(metadata);
  }
  if (number != null && number > 0) {
    request.number = number;
  }
  if (embeddingText != null && embeddingText.isNotEmpty) {
    request.embeddingText = embeddingText;
  }
  return stub.createRevision(request, options: callOptions);
}