AI Result Tracker – Prompt Groups

Organize tracked prompts into groups for cleaner reporting and bulk operations. Groups live at the site level and are shared across every LLM engine configured for that site; prompts are assigned to groups per engine. Data in the AI Result Tracker is refreshed daily.

List prompt groups

GET https://api.seranking.com/v1/project-management/airt/prompts/groups

Quick start

curl 'https://api.seranking.com/v1/project-management/airt/prompts/groups?site_id=11270054&keys_count=1' \

  -H 'Authorization: Token YOUR_API_KEY'

Returns every prompt group for project 11270054, ordered by position, with a keys_count on each group.

Request parameters

Response shape

[

  {

    "id": "string",

    "name": "string",

    "position": "string",

    "is_default": "string",

    "creation_date": "YYYY-MM-DD",

    "keys_count": "string"

  }

]

The response is a bare JSON array (no data envelope).

Response example

Project 11270054, all three groups, with counts requested:

[

  { "id": "26377", "name": "General",         "position": "1", "is_default": "1", "creation_date": "2026-03-03", "keys_count": "25" },

  { "id": "52273", "name": "docs-test-alpha", "position": "2", "is_default": "0", "creation_date": "2026-05-15", "keys_count": "2" },

  { "id": "52276", "name": "docs-test-beta",  "position": "3", "is_default": "0", "creation_date": "2026-05-15", "keys_count": "3" }

]

Error responses

Missing or malformed site_id does not error — it silently returns the /sites project list with HTTP 200.

Create prompt group

POST https://api.seranking.com/v1/project-management/airt/prompts/groups

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Creates a new prompt group for a site. The new group is appended to the end of the group order. Returns 400 if a group with the same name already exists.

Request parameters

Request example

curl -X POST "https://api.seranking.com/v1/project-management/airt/prompts/groups?site_id=123" \

  -H "Content-Type: application/json" \

  -d '{"name": "Competitors"}'\

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

Response example

{ "id": 12 }

Error responses

Rename prompt group

PATCH https://api.seranking.com/v1/project-management/airt/prompts/groups

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Updates the name of a prompt group.

Request parameters

Request example

curl -X PATCH "https://api.seranking.com/v1/project-management/airt/prompts/groups?site_id=123&group_id=147" \

  -H "Content-Type: application/json" \

  -d '{"name": "Branded queries"}'\

  -H 'Authorization: Token YOUR_API_KEY'

Response parameters

Response example

{ "id": 12 }

Error responses

Delete prompt group

DELETE https://api.seranking.com/v1/project-management/airt/prompts/groups

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Deletes a prompt group. All prompts currently in the group are moved to the default group. The default group itself cannot be deleted.

Request parameters

Request example

curl -X DELETE "https://api.seranking.com/v1/project-management/airt/prompts/groups?site_id=123&group_id=147"\

  -H 'Authorization: Token YOUR_API_KEY'

Response

Returns 204 No Content on success.

Error responses

Change group order

POST https://api.seranking.com/v1/project-management/airt/prompts/groups/order

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Moves a group to a new position in the site’s group order. Provide exactly one of before_id or after_id to anchor the new position.

Request parameters

Request example

Move group 12 to right after group 18:

curl -X POST "https://api.seranking.com/v1/project-management/airt/prompts/groups/order?site_id=123&group_id=147" \

  -H "Content-Type: application/json" \

  -d '{"after_id": 18}'\

  -H 'Authorization: Token YOUR_API_KEY'

Response

Returns 204 No Content on success.

Error responses

Delete all prompts in group

DELETE api.seranking.com/v1/project-management/airt/prompts/groups/prompts

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Removes every prompt currently assigned to the group. The group itself is not deleted.

Warning:

• This operation is destructive. Deleted prompts and their historical data cannot be recovered.
• To keep the prompts but empty the group, use Move all prompts from one group to another instead.

Request parameters

Request example

curl -X DELETE "https://api.seranking.com/v1/project-management/airt/prompts/groups/prompts?site_id=123&group_id=147"\

  -H 'Authorization: Token YOUR_API_KEY'

Response

Returns 204 No Content on success.

Error responses

Move prompts to group

POST https://api.seranking.com/v1/project-management/airt/prompts/groups/move

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Moves a specific set of prompts into the target group. Prompts can come from any group on the same site.

Request parameters

Request example

curl -X POST "https://api.seranking.com/v1/project-management/airt/prompts/groups/move?site_id=123&group_id=147" \

  -H "Content-Type: application/json" \

  -d '{"k2site_llm_ids": [101, 102, 103]}'\

  -H 'Authorization: Token YOUR_API_KEY'

Response

Returns 204 No Content on success.

Error responses

Move all prompts from one group to another

POST https://api.seranking.com/v1/project-management/airt/prompts/groups/transfer

Cost: 0. Managing prompt groups does not consume API credits or subscription quota.

Moves every prompt from one group to another in a single call. Use this to merge a group into another group, then optionally delete the now-empty source group.

Request parameters

Request example

curl -X POST "https://api.seranking.com/v1/project-management/airt/prompts/groups/transfer?site_id=123" \

  -H "Content-Type: application/json" \

  -d '{"from_group_id": 18, "to_group_id": 12}'\

  -H 'Authorization: Token YOUR_API_KEY'

Response

Returns 204 No Content on success.

Error responses