---
title: "Create an organization annotations group"
method: POST
path: "/organization/{organizationId}/annotationsGroups"
tags: ["Organization Annotations Group"]
---

# Create an organization annotations group

`POST /organization/{organizationId}/annotationsGroups`

## Request

- Base URL: `https://api.qovery.com`
- URL: `https://api.qovery.com/organization/{organizationId}/annotationsGroups`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/qovery/apis/qovery-api/docs/organization/:organizationId/annotationsGroups/post.ts> (a function with typed inputs; its response is checked against the schema)

Create an organization annotations group

## Path parameters

- `organizationId` string, uuid, required

## Request body

- OrganizationAnnotationsGroupCreateRequest
  - `name` string, required: name of the annotations group
  - `annotations` Annotation[], required
    - `key` string, required
    - `value` string, required
  - `scopes` OrganizationAnnotationsGroupScopeEnum[], required

## Response `201`

Organization annotations group created

- OrganizationAnnotationsGroupResponse
  - `id` string, uuid, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time
  - `name` string, required
  - `annotations` Annotation[], required
    - `key` string, required
    - `value` string, required
  - `scopes` OrganizationAnnotationsGroupScopeEnum[], required

## Other responses

- `400`: Bad request
- `401`: Access token is missing or invalid
- `403`: Access forbidden

---

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