Delete a dataset item

client.DatasetItems.Archive(ctx, datasetItemID) (*DatasetItemArchiveResponse, error)

DELETE/v5/dataset-items/{dataset_item_id}

Soft-delete a dataset item by marking it as removed in the current dataset version.

The database row is not removed; instead the item’s end version is set to the current dataset version so it no longer appears at the latest version while remaining retrievable at earlier versions, and a new dataset version snapshot is created to record the removal. An item that is already archived or already deleted cannot be deleted again. The response echoes the item id with deleted set to true.

ParametersExpand Collapse

datasetItemID string

ReturnsExpand Collapse

type DatasetItemArchiveResponse struct{…}

ID string

Deleted bool

Object DatasetItemArchiveResponseObjectOptional

Delete a dataset item

package main

import (
  "context"
  "fmt"

  "github.com/scaleapi/sgp-dev-go"
  "github.com/scaleapi/sgp-dev-go/option"
)

func main() {
  client := sgpdev.NewClient(
    option.WithAPIKey("My API Key"),
    option.WithAccountID("My Account ID"),
  )
  response, err := client.DatasetItems.Archive(context.TODO(), "dataset_item_id")
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.ID)
}

{
  "id": "id",
  "deleted": true,
  "object": "dataset.item"
}

Returns Examples

{
  "id": "id",
  "deleted": true,
  "object": "dataset.item"
}