API reference/Goals

Set a revenue goal

Persist a monthly whole-dollar goal shared with the customer dashboard and pipeline.

PATCH/api/v1/goals/{period}

Authentication

Send your workspace key as xi-api-key or Authorization: Bearer.

goals:writewrite

Parameters

Named placeholders belong in the path. Other arguments use a JSON body.

periodRequired: string
amountRequired: integerRange: 0 to 10000000

Response

JSON response with status 200.

Requests and errors →

Illustrative arguments

{
  "period": "YOUR_VALUE",
  "amount": 0
}

Input schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string",
      "pattern": "^20\\d{2}-(0[1-9]|1[0-2])$"
    },
    "amount": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "required": [
    "period",
    "amount"
  ],
  "additionalProperties": false
}

Response schema

{
  "type": "object",
  "properties": {
    "period": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    }
  },
  "required": [
    "period",
    "amount"
  ],
  "additionalProperties": false
}