---
title: "Create timed annotations for dashboard"
method: POST
path: "/api/{org_id}/dashboards/{dashboard_id}/annotations"
tags: ["Dashboards"]
---

# Create timed annotations for dashboard

`POST /api/{org_id}/dashboards/{dashboard_id}/annotations`

## Request

- Base URL: `https://api.openobserve.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openobserve.ai/api/{org_id}/dashboards/{dashboard_id}/annotations`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/openobserve/apis/openobserve-api-http/docs/api/:org_id/dashboards/:dashboard_id/annotations/post.ts> (a function with typed inputs; its response is checked against the schema)

Creates new timed annotations for specific panels within a dashboard

## Path parameters

- `org_id` string, required
- `dashboard_id` string, required

## Request body

- object
  - `timed_annotations` TimedAnnotation[], required
    - `annotation_id` string, nullable
    - `end_time` integer, nullable
    - `panels` string[]
    - `start_time` integer
    - `tags` string[]
    - `text` string, nullable
    - `title` string

## Response `200`

Timed annotations created successfully

- TimedAnnotation[]
  - `annotation_id` string, nullable
  - `end_time` integer, nullable
  - `panels` string[]
  - `start_time` integer
  - `tags` string[]
  - `text` string, nullable
  - `title` string

## Other responses

- `500`: Failed to create timed annotations

---

[API](https://skmtc.dev/openobserve/apis/openobserve-api-http.md) - [All operations](https://skmtc.dev/openobserve/apis/openobserve-api-http/llms.txt) - [OpenAPI document](https://skmtc.dev/openobserve/apis/openobserve-api-http/revisions/0529b8a10252?raw)