Strategy

Update a Strategy Goal

patch/v1/workspaces/{workspaceId}/strategy/goals/{goalId}

Request

  • Base URL: https://api.maevesocial.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.maevesocial.com/v1/workspaces/{workspaceId}/strategy/goals/{goalId}
  • Auth: HTTP bearer

Path parameters

goalIdstring required
workspaceIdstring uuid required

Workspace UUID.

Request body

metricIdstring nullable
customLabelstring nullable
customUnitstring nullable
startDatestring date nullable
endDatestring date nullable
targetnumber nullable
currentnumber nullable
colorstring nullable
channelIdsstring[] nullable
pillarIdsstring[] nullable
formatIdsstring[] nullable
campaignIdsstring[] nullable
labelIdsstring[] nullable

Response

Updated Strategy Goal

metaunknown required

Example response

{
  "data": {
    "id": "11111111-1111-4111-8111-111111111111",
    "workspaceId": "22222222-2222-4222-8222-222222222222",
    "metricId": "reach",
    "metric": {
      "id": "reach",
      "label": "Reach",
      "stage": "awareness",
      "unit": "count",
      "help": "Unique people who saw you",
      "tracking": "auto",
      "aggregation": "period_total",
      "suggestedLift": 0.35,
      "countable": true,
      "platforms": [
        "instagram",
        "facebook"
      ],
      "allChannels": true,
      "dayBounded": true
    },
    "startDate": "2026-06-01",
    "endDate": "2026-06-30",
    "baseline": 32000,
    "target": 50000,
    "current": 43000,
    "tracking": "auto",
    "color": "#2F6BFF",
    "computed": {
      "phase": "active",
      "startDate": "2026-06-01",
      "endDate": "2026-06-30",
      "totalDays": 29,
      "elapsedPct": 0.5,
      "daysLeft": 14,
      "pct": 0.62,
      "expectedPct": 0.5,
      "projected": 52000,
      "statusKey": "ontrack"
    },
    "baselineStartDate": "2026-05-02",
    "baselineEndDate": "2026-05-31",
    "lastRefreshedAt": "2026-06-17T00:00:00.000Z",
    "completedAt": "2026-06-20T00:00:00.000Z",
    "completedByUserId": "33333333-3333-4333-8333-333333333333",
    "createdAt": "2026-06-17T00:00:00.000Z",
    "updatedAt": "2026-06-17T00:00:00.000Z"
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.