Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. Vector
    3. OpenTelemetry
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources API
    3. Source groups API
    4. Metrics API
    5. Dashboards API
    6. Explorations API
    7. Exploration groups API
      1. List all exploration groups GET
      2. Get a single exploration group GET
      3. Create an exploration group POST
      4. Update an exploration group PATCH
      5. Remove an exploration group DELETE
      6. List explorations in a group GET
    8. Alerts API
    9. Connections API
    10. Collectors API
    11. Query API ↗
  7. Alternative to
    1. Lightstep

Create an exploration group

Creates a new exploration group for organizing explorations.

POST https://telemetry.betterstack.com/api/v2/exploration-groups

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

name
required string

The name of the exploration group.

team_name
string

Required if using a global API token to specify which team should own the resource.

201

The exploration group was created successfully.

Response body

{
  "data": {
    "id": 456,
    "type": "exploration_group",
    "attributes": {
      "name": "Production Monitoring",
      "created_at": "2026-02-20T10:00:00Z",
      "updated_at": "2026-02-20T10:00:00Z"
    }
  }
}
422

Validation failed due to invalid parameters.

Response body

{
  "errors": "Sorry, some values are incorrect",
  "invalid_values": {
    "name": [
      "can't be blank"
    ]
  }
}

Example Request

cURL
curl --request POST \
  --url https://telemetry.betterstack.com/api/v2/exploration-groups \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "name": "Production Monitoring"
  }'


Previous article

Get a single exploration group

Next article

Update an exploration group