---
title: "Create Group"
method: POST
path: "/api/v2/organization/{organization_id}/groups"
tags: ["Public Scan"]
---

# Create Group

`POST /api/v2/organization/{organization_id}/groups`

## Request

- Base URL: `https://aquilax.ai`
- URL: `https://aquilax.ai/api/v2/organization/{organization_id}/groups`
- Auth: API key in header `X-AX-KEY`

Sends vulnerability details and source code to the AI service, which analyzes
the data and returns a classification with a confidence score.

## Query parameters

- `organization_id` string, required

## Request body

- object
  - `name` string: Human readable Group Name
  - `security_policy` object: A JSON object representing the security policy configuration for the group. Includes scanner configurations, frequency of scans, thresholds, and ticketing behavior.
    - `frequency` string: Cron expression defining how often to run scans. Use `"none"` for disabled scheduling.
    - `ignore` string[]: Paths or patterns to ignore during scanning.
    - `jira_project_key` string
    - `notify_on_failure` boolean
    - `raise_tickets` boolean
    - `scanners` object[]: List of enabled scanners. Each scanner is an object with a key indicating its type (e.g., `sast`, `secret`, `compliance`) and an `enforced` boolean.
    - `tags` string[]
    - `testing` boolean
    - `threshold` object
      - `HIGH` integer
      - `MEDIUM` integer
      - `LOW` integer
      - `total` integer
    - `ticket_body` string
    - `ticket_integration` string
    - `ticket_title` string

## Response `200`

Invalid request format

## Other responses

- `500`: Internal server error or AI model not configured
- `502`: Failed to reach external AI model

## Changes

- **2025-05-13** `a09ec44bd7a9`: 1 info
  - endpoint added
- **2025-03-09** `8e1891ab4552`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/aquilax-ai/apis/aquilax-ai-api-docs/changes/api/v2/organization/:organization_id/groups/post.md)

---

[API](https://skmtc.dev/aquilax-ai/apis/aquilax-ai-api-docs.md) - [All operations](https://skmtc.dev/aquilax-ai/apis/aquilax-ai-api-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/aquilax-ai/apis/aquilax-ai-api-docs/revisions/9b4f595ad674?raw)