BigML · Example Payload

Create Cluster

Train a k-means clustering model on a BigML dataset.

Machine LearningArtificial IntelligencePredictionsDatasetsModelsClusteringAnomaly DetectionTime SeriesDeep Learning

Create Cluster is an example object payload from BigML, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.

Top-level fields

titledescriptionrequestresponse

Example Payload

{
  "title": "Create a Cluster",
  "description": "Train a k-means clustering model on a BigML dataset.",
  "request": {
    "method": "POST",
    "url": "https://bigml.io/andromeda/cluster?username=myuser&api_key=a1b2c3d4e5f6789012345678",
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "dataset": "dataset/5f1a2b3c4d5e6f7890abcde0",
      "k": 3,
      "name": "Iris Clustering"
    }
  },
  "response": {
    "status": 201,
    "body": {
      "resource": "cluster/5f1a2b3c4d5e6f7890abcde4",
      "name": "Iris Clustering",
      "created": "2026-06-13T12:05:00.000Z",
      "updated": "2026-06-13T12:05:00.000Z",
      "private": true,
      "dataset": "dataset/5f1a2b3c4d5e6f7890abcde0",
      "k": 3,
      "status": {
        "code": 1,
        "message": "The cluster is being created",
        "elapsed": 0
      }
    }
  }
}