API overview

The Trace API is JSON over HTTPS. Authenticate every request with a user-scoped Bearer key. New keys carry memories:read and memories:write scopes by default; change a key's permissions in Developer settings at any time.

Choose cURL, JavaScript or Python in any example. Trace remembers that choice in this browser as you move between reference pages. Sign in to manage the API keys and webhooks for your account.

1curl \
2  --request GET \
3  --url "https://accounts.sterlingtrace.com/developer/v1/memories/7b4f5c42-7f27-4f38-9f53-524b7e574d51" \
4  --header "Authorization: Bearer $TRACE_API_KEY"

1const response = await fetch(
2  "https://accounts.sterlingtrace.com/developer/v1/memories/7b4f5c42-7f27-4f38-9f53-524b7e574d51",
3  {
4    headers: {
5      Authorization: `Bearer ${process.env.TRACE_API_KEY}`,
6    },
7  },
8);
9
10if (!response.ok) throw new Error(`Trace returned ${response.status}`);
11const { memory } = await response.json();

1import os
2import requests
3
4response = requests.get(
5    "https://accounts.sterlingtrace.com/developer/v1/memories/7b4f5c42-7f27-4f38-9f53-524b7e574d51",
6    headers={"Authorization": f"Bearer {os.environ['TRACE_API_KEY']}"},
7    timeout=10,
8)
9response.raise_for_status()
10memory = response.json()["memory"]

Current endpoints

The public surface reads a processed Memory with GET /memories/:id and accepts immutable Apple Notes revisions.

There is no public list, update or delete API. Webhooks provide the Memory ID when a processed Memory is ready, and the read endpoint retrieves its complete current projection.

HTTP responses

Trace uses standard HTTP status codes. Successful reads return 200. An absent, expired or revoked key returns 401; a Memory that does not exist or belongs to another account returns 404.