---
title: "Propose study structure (MRS groups, grids, derived banners, scale T2B/B2B) from a .sav + questionnaire via the Agent SDK"
method: POST
path: "/v1/agent/detect-structure"
tags: ["Agent"]
---

# Propose study structure (MRS groups, grids, derived banners, scale T2B/B2B) from a .sav + questionnaire via the Agent SDK

`POST /v1/agent/detect-structure`

## Request

- Base URL: `https://spss.insightgenius.io` (the document declares no server; this is the origin it was published from)
- URL: `https://spss.insightgenius.io/v1/agent/detect-structure`
- Auth: none declared

Upload a questionnaire (.docx or .pdf) plus a .sav (or pass file_id). The agent reads the questionnaire, cross-references it with the SPSS metadata, and proposes a structure for the analyst to review and apply. Every variable in the proposal is verified to exist in the dataset. Idempotent — running twice on the same inputs produces similar (not necessarily identical) suggestions.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/insightgenius/apis/spss-insightgenius-api.md) · [All operations](https://skmtc.dev/insightgenius/apis/spss-insightgenius-api/llms.txt) · [OpenAPI document](https://skmtc.dev/insightgenius/apis/spss-insightgenius-api/revisions/0d165df595f0?raw)