# Create a script in a folder

Creates a new script in the folder folder_id within the project project_id.

The new script is supplied as a JSON object in the request body and can contain tests,
runs, run headers, results and custom fields.

### URL Parameters
insert enum or integer  
Controls where the script will be created within the specified folder.

first (default) — the script is placed at the top of the folder.  
last — the script is placed at the end of the folder.  
as integer, N — the script is placed after the Nth item in the folder.

### POST data
name string — The name of the new script.  
description string (OPTIONAL) — The description for the new script.  
comments string (OPTIONAL) — The report comments for the new script.

tests — See Supplying Test Text.  
fields — Order/visibility/definition of run header fields.  
runs — List of test run objects as defined in Supplying Test Runs.

### Returns
JSON response payload containing:

script object — Summary of the new script.  
context object — Project and folderPath context.

### Defaults for common parameters
(no common parameters are used).

Endpoint: POST /projects/{project_id}/folders/{folder_id}/scripts
Version: 1.0

## Path parameters:

  - `project_id` (integer, required)
    The project ID.

  - `folder_id` (string, required)
    The folder ID.

## Query parameters:

  - `insert` (string)
    Controls where the script will be created within the target folder:

first (default) — the script is placed at the top of the folder.  
last — the script is placed at the end of the folder's contents.  
N - integer — the script is placed after the Nth item in the folder.


## Response 200 fields