Voxco · Schema

NewStudyRequest

A request to create a new Study.

Survey SoftwareMarket ResearchCATIOmnichannelText AnalyticsData CollectionPanel Management

Properties

Name Type Description
quota integer The quota for the Study
id string The id of the new Study. Must be unique among all Studies in the Ascribe account of the current session by case-insensitive comparison. Must be at least 1 character and not more than 30 characters.
name string Optional name of this Study, intended to be more human-friendly than the id of the Study. Maximum of 50 characters.
description string An optional description of the Study.
status string Optional status of the Study at the time it is created. If specified, one of:
  • u: Under construction
  • p: Coding in progress
  • h: On hold
If omitted the default status
supervisorKey integer The key of the Person who will do revision of coding work If no supervisor is set for the Study this field will not be present in the response.
clientCompanyKey integer Optional key of the Company for which this coding work is being performed.
endCompanyKey integer The key of the Company for which this coding work is being performed If no end customer company is set for the Study this field will not be present in the response.
help string Optional text to assist workers coding this Study This may be used to provide customer specific instructions to the coders for work on this Study.
startDateUtc string UTC date/time the Study was started.
dueDateUtc string UTC date/time the Study was completed.
externalStudyId string External study id from StudyMaps
View JSON Schema on GitHub

JSON Schema

NewStudyRequest.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "NewStudyRequest",
  "required": [
    "id"
  ],
  "type": "object",
  "properties": {
    "quota": {
      "type": "integer",
      "description": "The quota for the Study",
      "format": "int32",
      "nullable": true
    },
    "id": {
      "maxLength": 30,
      "minLength": 1,
      "type": "string",
      "description": "The id of the new Study.\r\n\r\nMust be unique among all Studies in the Ascribe account of the current session by case-insensitive comparison.\r\n\r\nMust be at least 1 character and not more than 30 characters."
    },
    "name": {
      "maxLength": 50,
      "minLength": 0,
      "type": "string",
      "description": "Optional name of this Study, intended to be more human-friendly than the id of the Study.\r\n\r\nMaximum of 50 characters.",
      "nullable": true
    },
    "description": {
      "type": "string",
      "description": "An optional description of the Study.",
      "nullable": true
    },
    "status": {
      "maxLength": 1,
      "minLength": 0,
      "type": "string",
      "description": "Optional status of the Study at the time it is created.\r\n\r\nIf specified, one of:\r\n<ul><li>u: Under construction\r\n</li><li>p: Coding in progress\r\n</li><li>h: On hold\r\n</li></ul>\r\nIf omitted the default status is 'Coding in progress'.",
      "nullable": true
    },
    "supervisorKey": {
      "type": "integer",
      "description": "The key of the Person who will do revision of coding work\r\n\r\nIf no supervisor is set for the Study this field will not be present in the response.",
      "format": "int32",
      "nullable": true
    },
    "clientCompanyKey": {
      "type": "integer",
      "description": "Optional key of the Company for which this coding work is being performed.",
      "format": "int32",
      "nullable": true
    },
    "endCompanyKey": {
      "type": "integer",
      "description": "The key of the Company for which this coding work is being performed\r\n\r\nIf no end customer company is set for the Study this field will not be present in the response.",
      "format": "int32",
      "nullable": true
    },
    "help": {
      "type": "string",
      "description": "Optional text to assist workers coding this Study\r\n\r\nThis may be used to provide customer specific instructions to the coders for work on this Study.",
      "nullable": true
    },
    "startDateUtc": {
      "type": "string",
      "description": "UTC date/time the Study was started.",
      "format": "date-time",
      "nullable": true
    },
    "dueDateUtc": {
      "type": "string",
      "description": "UTC date/time the Study was completed.",
      "format": "date-time",
      "nullable": true
    },
    "externalStudyId": {
      "type": "string",
      "description": "External study id from StudyMaps",
      "nullable": true
    }
  },
  "additionalProperties": false,
  "description": "A request to create a new Study."
}

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/NewStudyRequest"
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 email required.

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