# Create new working file

**POST /data/tasks/{task_id}/working-files/new**

Create a new working file for a task. Working files are versioned files used by artists to produce output files. Each file requires a comment and generates a path based on file tree template.


## Servers
- http://api.example.com: http://api.example.com ()


## Authentication methods
- Jwt authorization


## Parameters

### Path parameters
- **task_id** (string(uuid))
  Task unique identifier


### Body: application/json (object)

- **name** (string)
  Working file name
- **mode** (string)
  Working file mode
- **description** (string)
  Working file description
- **comment** (string)
  Working file comment
- **person_id** (string(uuid))
  Person identifier
- **software_id** (string(uuid))
  Software identifier
- **revision** (integer)
  Working file revision
- **sep** (string)
  Path separator


## Responses
### 201
New working file created successfully

#### Body: application/json (object)
- **id** (string(uuid))
  Working file unique identifier
- **name** (string)
  Working file name
- **path** (string)
  Working file path
- **revision** (integer)
  Working file revision
- **task_id** (string(uuid))
  Task identifier
- **created_at** (string(date-time))
  Creation timestamp
- **updated_at** (string(date-time))
  Last update timestamp


[Powered by Bump.sh](https://bump.sh)