Update Goal

Update an existing goal.

Update Goal

Updates the configuration of an existing goal. Requires member role or higher.

Endpoint

PUT /api/v1/organizations/:orgId/sites/:siteId/goals/:goalId

Request Body

Field	Type	Required	Description
`name`	`string`	No	Goal display name
`pattern`	`string`	No	Page path or event name to match
`match_type`	`string`	No	`exact`, `contains`, or `regex`
`value`	`number`	No	Monetary value per conversion
`currency`	`string`	No	Currency code (e.g. `USD`)
`property_conditions`	`array`	No	Property filters for custom events

The type field is immutable — goals are auto-created as custom_event or pageview and cannot change type after creation.

Example request (cURL)

curl -X PUT \
  'https://api.engagetrack.net/api/v1/organizations/{orgId}/sites/{siteId}/goals/{goalId}' \
  -H 'Authorization: Bearer <token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Signup Complete",
    "pattern": "signup_complete",
    "match_type": "exact"
  }'

Success response (200 OK)

{
  "success": true,
  "data": {
    "id": "goal_abc",
    "site_id": "site_abc123",
    "name": "Signup Complete",
    "type": "custom_event",
    "pattern": "signup_complete",
    "match_type": "exact",
    "updated_at": "2024-02-15T10:00:00Z"
  }
}