---
title: "Create Annotation in Graphite format."
method: POST
path: "/annotations/graphite"
tags: ["annotations"]
---

# Create Annotation in Graphite format.

`POST /annotations/graphite`

## Request

- Base URL: `/api` (relative, and the document’s source URL is not known)
- URL: `/api/annotations/graphite`
- Auth: one of:
  - HTTP basic
  - API key in header `Authorization`

Creates an annotation by using Graphite-compatible event format. The `when` and `data` fields are optional. If `when` is not specified then the current time will be used as annotation’s timestamp. The `tags` field can also be in prior to Graphite `0.10.0` format (string with multiple tags being separated by a space).

## Request body

- PostGraphiteAnnotationsCmd
  - `data` string
  - `tags` unknown
  - `what` string
  - `when` integer

## Response `200`

(empty)

- object
  - `id` integer, required: ID Identifier of the created annotation.
  - `message` string, required: Message Message of the created annotation.

## Other responses

- `400`: BadRequestError is returned when the request is invalid and it cannot be processed.
- `401`: UnauthorizedError is returned when the request is not authenticated.
- `403`: ForbiddenError is returned if the user/token has insufficient permissions to access the requested resource.
- `500`: InternalServerError is a general error indicating something went wrong internally.

---

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