---
title: "Update an execution's properties (admin only)."
method: PATCH
path: "/api/v1/execution/{execution}"
---

# Update an execution's properties (admin only).

`PATCH /api/v1/execution/{execution}`

**Authentication**: JWT token required
**Authorization**: Admin level access required
**Access**: Only admin users can update execution properties

**Path Parameters**:
- `execution`: Execution ID (UUID format)

**Request Body**:
```json
{
  "status": "CANCELLED",
  "progress": 100,
  "results": {
    "reason": "User requested cancellation"
  }
}
```

**Updatable Fields**:
- `status`: Execution status (PENDING, RUNNING, SUCCESS, FAILED, CANCELLED)
- `progress`: Progress percentage (0-100)
- `results`: Results data (JSON object)
- `end_date`: End timestamp (ISO 8601 format)

**Response Schema**:
```json
{
  "data": {
    "id": "abc123-def456",
    "script_id": "vegetation-analysis",
    "status": "CANCELLED",
    "progress": 100,
    "user_id": "user-789",
    "start_date": "2025-01-15T10:30:00Z",
    "end_date": "2025-01-15T10:35:00Z",
    "results": {
      "reason": "User requested cancellation"
    }
  }
}
```

**Error Responses**:
- `401 Unauthorized`: JWT token required
- `403 Forbidden`: Admin access required
- `404 Not Found`: Execution does not exist
- `422 Unprocessable Entity`: Invalid request data
- `500 Internal Server Error`: Server error

## Path parameters

- `execution` string, required

## Request body

- object

## Response `200`

Success

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/trends/apis/trends-earth-api.md) · [All operations](https://skmtc.dev/trends/apis/trends-earth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trends/trends-earth-api/revisions/6bdbc0b84666/schema)