Strategy Group Endpoints

Create and manage strategy groups for bulk operations on collections of strategies.

Create strategy group

POST /api/strategy-groups

Request body

{
  "name": "E-commerce Monitors",
  "description": "Product price tracking across 50 stores"
}

Field	Type	Required	Description
`name`	string	Yes	Name for the group
`description`	string	No	Description of the group

Response

{
  "id": "aa0e8400-e29b-41d4-a716-446655440000",
  "name": "E-commerce Monitors",
  "description": "Product price tracking across 50 stores",
  "strategy_count": 0,
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}

Example

curl -X POST https://api.meter.sh/api/strategy-groups \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "E-commerce Monitors",
    "description": "Product price tracking across 50 stores"
  }'

List strategy groups

GET /api/strategy-groups?limit=50&offset=0

Query parameters

Parameter	Type	Required	Description
`limit`	integer	No	Max results (default: 50)
`offset`	integer	No	Results to skip (default: 0)

Response

[
  {
    "id": "aa0e8400-e29b-41d4-a716-446655440000",
    "name": "E-commerce Monitors",
    "description": "Product price tracking across 50 stores",
    "strategy_count": 12,
    "created_at": "2025-01-15T10:30:00Z",
    "updated_at": "2025-01-15T10:30:00Z"
  }
]

Example

curl https://api.meter.sh/api/strategy-groups?limit=10 \
  -H "Authorization: Bearer sk_live_..."

Get strategy group

Get details for a specific group including member strategies.

GET /api/strategy-groups/{group_id}

Response

{
  "id": "aa0e8400-e29b-41d4-a716-446655440000",
  "name": "E-commerce Monitors",
  "description": "Product price tracking across 50 stores",
  "strategies": [
    {
      "strategy_id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Amazon Products",
      "description": "Extract product listings",
      "url": "https://amazon.com/products",
      "created_at": "2025-01-15T10:30:00Z",
      "updated_at": "2025-01-15T10:30:00Z"
    }
  ],
  "created_at": "2025-01-15T10:30:00Z",
  "updated_at": "2025-01-15T10:30:00Z"
}

Example

curl https://api.meter.sh/api/strategy-groups/{group_id} \
  -H "Authorization: Bearer sk_live_..."

Update strategy group

Update a group’s name or description.

PATCH /api/strategy-groups/{group_id}

Request body

{
  "name": "Updated Name",
  "description": "Updated description"
}

All fields are optional. Include only fields to update.

Example

curl -X PATCH https://api.meter.sh/api/strategy-groups/{group_id} \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"name": "New Group Name"}'

Delete strategy group

Delete a group. Strategies in the group become ungrouped — they are not deleted.

DELETE /api/strategy-groups/{group_id}

Response

{
  "message": "Strategy group deleted successfully"
}

Example

curl -X DELETE https://api.meter.sh/api/strategy-groups/{group_id} \
  -H "Authorization: Bearer sk_live_..."

Add strategies to group

Add existing strategies to a group.

POST /api/strategy-groups/{group_id}/strategies

Request body

{
  "strategy_ids": [
    "550e8400-e29b-41d4-a716-446655440000",
    "660e8400-e29b-41d4-a716-446655440000"
  ]
}

Response

{
  "message": "Strategies added to group"
}

Example

curl -X POST https://api.meter.sh/api/strategy-groups/{group_id}/strategies \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "strategy_ids": [
      "550e8400-e29b-41d4-a716-446655440000",
      "660e8400-e29b-41d4-a716-446655440000"
    ]
  }'

Remove strategy from group

Remove a strategy from a group (sets the strategy’s group to null — the strategy is not deleted).

DELETE /api/strategy-groups/{group_id}/strategies/{strategy_id}

Response

{
  "message": "Strategy removed from group"
}

Example

curl -X DELETE https://api.meter.sh/api/strategy-groups/{group_id}/strategies/{strategy_id} \
  -H "Authorization: Bearer sk_live_..."

Apply group schedule

Create or update a schedule for every strategy in the group.

POST /api/strategy-groups/{group_id}/schedule

Request body

{
  "interval_seconds": 3600,
  "webhook_url": "https://your-app.com/webhooks/meter",
  "webhook_type": "standard"
}

Field	Type	Required	Description
`interval_seconds`	integer	Conditional	Run every N seconds (min: 60)
`cron_expression`	string	Conditional	Cron expression
`webhook_url`	string	No	Webhook URL for notifications
`webhook_secret`	string	No	Webhook secret (auto-generated if not provided)
`webhook_type`	string	No	`standard`, `slack`, `slack_workflow`, or `discord`. Auto-detected from URL if not specified
`webhook_metadata`	object	No	Custom JSON metadata for webhook payloads

Provide either interval_seconds or cron_expression, not both.

Response

{
  "message": "Group schedule applied",
  "created": 8,
  "updated": 4
}

Example

curl -X POST https://api.meter.sh/api/strategy-groups/{group_id}/schedule \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "interval_seconds": 3600,
    "webhook_url": "https://your-app.com/webhooks/meter"
  }'

Delete group schedules

Delete all schedules for strategies in the group.

DELETE /api/strategy-groups/{group_id}/schedule

Response

{
  "message": "Group schedules deleted"
}

Example

curl -X DELETE https://api.meter.sh/api/strategy-groups/{group_id}/schedule \
  -H "Authorization: Bearer sk_live_..."

Toggle group schedules

Enable or disable all schedules for strategies in the group.

PATCH /api/strategy-groups/{group_id}/schedule/toggle

Request body

{
  "enabled": false
}

Response

{
  "message": "Group schedules updated"
}

Example

curl -X PATCH https://api.meter.sh/api/strategy-groups/{group_id}/schedule/toggle \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Apply group schema

Apply an output schema to all strategies in the group. This triggers asynchronous regeneration of each strategy.

PATCH /api/strategy-groups/{group_id}/schema

Request body

{
  "output_schema": {
    "title": "string",
    "price": "number",
    "in_stock": "boolean"
  }
}

Field	Type	Required	Description
`output_schema`	object	Yes	JSON schema defining the desired output structure

See Output Schemas for supported types and nesting.

Response

{
  "message": "Schema applied and regeneration started",
  "strategy_count": 12
}

Example

curl -X PATCH https://api.meter.sh/api/strategy-groups/{group_id}/schema \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "output_schema": {
      "title": "string",
      "price": "number",
      "in_stock": "boolean"
    }
  }'

Get schema progress

Poll the progress of a group schema regeneration task.

GET /api/strategy-groups/{group_id}/schema/progress

Response

Returns progress details from the background regeneration task.

Example

curl https://api.meter.sh/api/strategy-groups/{group_id}/schema/progress \
  -H "Authorization: Bearer sk_live_..."

Test group webhook

Send a test webhook using a group’s schedule webhook configuration.

POST /api/strategy-groups/{group_id}/webhook/test

Response

{
  "success": true,
  "status_code": 200,
  "message": "Webhook delivered successfully"
}

Example

curl -X POST https://api.meter.sh/api/strategy-groups/{group_id}/webhook/test \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"

The test uses the webhook URL from any existing schedule in the group. At least one member strategy must have a schedule with a webhook_url configured.

Error responses

Status	Description
`400`	Invalid request (missing required fields, invalid cron expression)
`401`	Invalid or missing API key
`404`	Strategy group not found
`422`	Validation error (e.g., both interval and cron provided)
`500`	Internal server error

See REST API Errors for detailed error handling.

Next steps

Strategy Groups Concept

Understand strategy group architecture

Output Schemas

Define output structure for groups

Python SDK

Strategy group methods in the SDK

Webhooks

Handle webhook notifications

Need help?

Email me at mckinnon@meter.sh

​Strategy Group Endpoints

​Create strategy group

​Request body

​Response

​Example

​List strategy groups

​Query parameters

​Response

​Example

​Get strategy group

​Response

​Example

​Update strategy group

​Request body

​Example

​Delete strategy group

​Response

​Example

​Add strategies to group

​Request body

​Response

​Example

​Remove strategy from group

​Response

​Example

​Apply group schedule

​Request body

​Response

​Example

​Delete group schedules

​Response

​Example

​Toggle group schedules

​Request body

​Response

​Example

​Apply group schema

​Request body

​Response

​Example

​Get schema progress

​Response

​Example

​Test group webhook

​Response

​Example

​Error responses

​Next steps

Strategy Groups Concept

Output Schemas

Python SDK

Webhooks

​Need help?

Strategy Group Endpoints

Create strategy group

Request body

Response

Example

List strategy groups

Query parameters

Response

Example

Get strategy group

Response

Example

Update strategy group

Request body

Example

Delete strategy group

Response

Example

Add strategies to group

Request body

Response

Example

Remove strategy from group

Response

Example

Apply group schedule

Request body

Response

Example

Delete group schedules

Response

Example

Toggle group schedules

Request body

Response

Example

Apply group schema

Request body

Response

Example

Get schema progress

Response

Example

Test group webhook

Response

Example

Error responses

Next steps

Need help?