Upload an annotation attachment

Overview

Upload an annotation attachment. Annotations attach human context and evidence to operational data without changing the recorded series values.

When to use it

• Use it when an application needs to upload an annotation attachment.
• Use it when an operator needs to add, find, revise, or preserve context around an event or time range.

Quick example

Set the base URL and replace generated identifiers or credentials with values from your installation.

curl --request POST \
  --url "$ORDINATE_URL/v1/annotations/attachments?name=string&mime=string" \
  --header "Authorization: Bearer $ORDINATE_TOKEN" \
  --header "Content-Type: application/octet-stream" \
  --data-binary "@request-body.bin"

{
  "attachment_id": "00000000-0000-4000-8000-000000000001",
  "size_bytes": 0,
  "content_hash": "string",
  "deduplicated": false
}

The cURL request sends the smallest contract-derived body and asks OrdinateDB to upload an annotation attachment. The documented 201 response is content-addressed upload receipt.

How it works

Reference

Required capability

annotate

Authorization scope

handler-resolved target

{
  "attachment_id": "00000000-0000-4000-8000-000000000001",
  "size_bytes": 0,
  "content_hash": "string",
  "deduplicated": false
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

{
  "error": "string",
  "code": "account-sealed",
  "correlation_id": "00000000-0000-4000-8000-000000000001"
}

Code examples

These examples are generated from the source contract. Replace the base URL, credentials, identifiers, and minimal generated values for your instance.

const ordinateUrl = "http://localhost:8080";
const token = "<bearer-token>";

const response = await fetch(`${ordinateUrl}/v1/annotations/attachments?name=string&mime=string`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/octet-stream"
  },
  body: requestBody
});

if (!response.ok) {
  throw new Error(`OrdinateDB returned ${response.status}: ${await response.text()}`);
}

const data = await response.json();
console.log(data);