---
title: "Put Agent Goal"
method: PUT
path: "/reports/agent-goals/{user_id}"
tags: ["CRM Reports", "CRM Reports"]
---

# Put Agent Goal

`PUT /reports/agent-goals/{user_id}`

## Path parameters

- `user_id` string, required

## Query parameters

- `year` integer, required

## Request body

- AgentGoalUpsertRequest — Create-or-update an agent's commission goal for a year.
  - `userid` string, required — Agent userid
  - `year` integer, required — Goal year
  - `commission_goal` number, required — Target commission amount

## Response `200`

Successful Response

- AgentGoalResponse
  - `id` string, required
  - `tenant_id` string, nullable
  - `userid` string, required
  - `year` integer, required
  - `commission_goal` number
  - `updated_ts` number, nullable
  - `updated_by_userid` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)