[POST] .../v1/target/finish
Finishes a target. Use this method to complete an active target without deleting its history. It marks the target and its active history period as finished and returns row_affected. The caller must have edit permission for the target owner scope; missing body, invalid id, missing target, denied permissions, already-finished targets and storage errors are returned as HTTP 200 ErrorResult business errors.
Request Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| id | Int64 | Required | Record ID. |
Request Example
{
"id": 12
}Response Parameters
| Name | Type | Description |
|---|---|---|
| ok | Boolean | Indicates whether the request completed successfully. |
| result | Update | Update operation result. |
Response Example
{
"ok": true,
"result": {
"row_affected": 1
}
}