Create a span note

Add a note annotation to a span. Each call appends a new note with an auto-generated UUIDv4 identifier, so multiple notes accumulate on the same span. Structured annotations, by contrast, are keyed by (name, span_id, identifier) — re-writing the same key overwrites the existing annotation, so to keep multiple structured annotations with the same name on a span you must supply distinct identifiers.

POST /v1/span_notes

Create a span note

cURL

curl --request POST \
  --url https://api.example.com/v1/span_notes \
  --header 'Content-Type: application/json' \
  --data '
{
  "data": {
    "span_id": "<string>",
    "note": "<string>"
  }
}
'

200

{
  "data": {
    "id": "<string>"
  }
}

Body

application/json

data · SpanNoteData · object · required

Show child attributes

Response

200

application/json

Span note created successfully

data · InsertedSpanAnnotation · object · required

Show child attributes