HeyMarvin · Schema

PostApiV1DeveloperImportSurveysInitializeRequest

AICustomerInsightsAnalyticsSaaSPlatform

Properties

Name	Type	Description
project_id	integer	ID from the list projects response
name	string	Survey name (max 200 chars)
file_type	string	Must be "CSV"
num_parts	integer	Number of CSV parts to upload (1–100)
column_mapping	object	Map CSV column names to types
auto_map	boolean	Use AI to auto-detect column types (default: false)
add_to_research_panel	boolean	Add respondents to Research Panel (default: true)
media_config	object	Enables respondent-level media linking
idempotency_key	string	Unique key to prevent duplicates (max 255 chars)

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/heymarvin/json-schema/heymarvin-post-api-v1-developer-import-surveys-initialize-request-schema.json",
  "title": "PostApiV1DeveloperImportSurveysInitializeRequest",
  "x-generated": "2026-10-28",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/_ae-authored/heymarvin-openapi-generated.yml#/components/schemas/PostApiV1DeveloperImportSurveysInitializeRequest",
  "type": "object",
  "properties": {
    "project_id": {
      "type": "integer",
      "description": "ID from the list projects response"
    },
    "name": {
      "type": "string",
      "description": "Survey name (max 200 chars)"
    },
    "file_type": {
      "type": "string",
      "description": "Must be \"CSV\""
    },
    "num_parts": {
      "type": "integer",
      "description": "Number of CSV parts to upload (1–100)"
    },
    "column_mapping": {
      "type": "object",
      "description": "Map CSV column names to types"
    },
    "auto_map": {
      "type": "boolean",
      "description": "Use AI to auto-detect column types (default: false)"
    },
    "add_to_research_panel": {
      "type": "boolean",
      "description": "Add respondents to Research Panel (default: true)"
    },
    "media_config": {
      "type": "object",
      "description": "Enables respondent-level media linking"
    },
    "idempotency_key": {
      "type": "string",
      "description": "Unique key to prevent duplicates (max 255 chars)"
    }
  },
  "required": [
    "project_id",
    "name",
    "file_type",
    "num_parts"
  ]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/heymarvin-post-api-v1-developer-import-surveys-initialize-request"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.