---
title: "Update a span"
method: PATCH
path: "/api/request-logs/{unique_id}/"
tags: ["spans"]
---

# Update a span

`PATCH /api/request-logs/{unique_id}/`

Update mutable fields of a span. Supports pinning for infinite retention, user feedback, text annotations, and metadata (merged with existing metadata).

## Path parameters

- `unique_id` string, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `is_pinned` boolean — Pin the span for infinite retention.
  - `positive_feedback` boolean, nullable — User feedback. `true` = positive, `false` = negative, `null` = clear.
  - `note` string — Free-text annotation on the span.
  - `metadata` ApiRequestLogsUniqueIdPatchRequestBodyContentApplicationJsonSchemaMetadata — Metadata to merge into existing span metadata.

## Response `200`

Span updated successfully

- SpansUpdateSpanResponse200 — Empty response body

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limited
- `500` — Internal Server Error

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/77d94e49bc7a/schema)