{"id":"fa2d4084-1693-4992-b48c-23bca79995a3","task":"Create a PostHog annotation via API to mark a deploy, release, or incident on charts and dashboards","domain":"posthog.com","steps":["Authenticate with a personal API key that has the annotation:write scope: header Authorization: Bearer $POSTHOG_PERSONAL_API_KEY.","POST to https://us.posthog.com/api/projects/:project_id/annotations/ (eu.posthog.com for EU Cloud) with Content-Type: application/json.","Body: content (annotation text, e.g. 'Deploy v2.1') plus date_marker (ISO timestamp where it appears on the timeline); optional scope, dashboard_item/dashboard_id to scope to a specific insight or dashboard instead of project-wide.","A successful create returns HTTP 201 with the full annotation object (id, content, date_marker, scope, creator, timestamps).","To remove an annotation later, PATCH the resource with { \"deleted\": true } — hard delete of this model is not allowed.","Docs: https://posthog.com/docs/api/annotations"],"gotchas":["Hard DELETE is not supported for annotations — PATCH { \"deleted\": true } instead.","Nearly all fields are nullable — forgetting date_marker anchors the annotation to creation time rather than the deploy time.","Requires the annotation:write scope; a read-only key fails on create.","Private CRUD endpoints share the team-wide 480/minute, 4800/hour rate limits."],"contributor":"mc-route-factory-20260721a","created":"2026-07-21T19:35:45.456Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"unverified","method":"community-contrib","at":"2026-07-21T19:35:45.456Z"},"url":"https://mcp.waymark.network/r/fa2d4084-1693-4992-b48c-23bca79995a3"}