---
title: "Draft Row"
method: PUT
path: "/v3.0/draft-rows/{submitCode}/"
tags: ["draft-rows"]
---

# Draft Row

`PUT /v3.0/draft-rows/{submitCode}/`

## Request

- Base URL: `https://api.formaloo.me`
- URL: `https://api.formaloo.me/v3.0/draft-rows/{submitCode}/`
- Auth: none declared. Required headers: `x-api-key`

## Path parameters

- `submitCode` string, required

## Headers

- `x-api-key` string, required

## Request body

- RowActionsRequest
  - `row_tags` string[]
  - `previous_position` string, nullable: Previous position of the row, if we're changing the position.
  - `next_position` string, nullable: Next position of the row, if we're changing the position.
  - `submit_time` string, time, nullable: time it took to fill this form
  - `submitter_referer_address` string, nullable: which website was this request submitted on
  - `email_verification_state` 'not_required' | 'not_verified' | 'verified'
  - `data` object, nullable: the form's submitted data, in json. a key value pair with fields's slug.
  - `calculation_score` object, nullable: shows the sum of scores for each field in row. it is null if there is not any calculations
  - `create_type` 'api' | 'excel' | 'google_forms' | 'google_sheets' | 'magic_import' | 'magic_create' | 'recurring_submission'
  - `status` 'draft' | 'submit' | 'expired'

## Response `200`

- RowActions
  - `readable_data` object
  - `rendered_data` object
  - `form` string
  - `row_tags` string[]
  - `slug` string, nullable
  - `submit_code` string, nullable: a submit code to provide to user.
  - `tracking_code` string, nullable: a tracking code to provide to end user. unique for each row in the form.
  - `submit_number` integer
  - `language` LanguageShort
    - `slug` string, nullable
    - `title` string, required
    - `code` string, nullable
    - `is_default` boolean: set true to set this language as the default language for the new forms.
    - `direction` 'ltr' | 'rtl'
  - `next_row` string
  - `previous_row` string
  - `position` number, double, nullable: position of row in table.
  - `created_by` string
  - `updated_by` string
  - `pdf_link` string, uri, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `submit_time` string, time, nullable: time it took to fill this form
  - `submitter_referer_address` string, nullable: which website was this request submitted on
  - `email_verification_state` 'not_required' | 'not_verified' | 'verified'
  - `data` object, nullable: the form's submitted data, in json. a key value pair with fields's slug.
  - `calculation_score` object, nullable: shows the sum of scores for each field in row. it is null if there is not any calculations
  - `create_type` 'api' | 'excel' | 'google_forms' | 'google_sheets' | 'magic_import' | 'magic_create' | 'recurring_submission'
  - `status` 'draft' | 'submit' | 'expired'

---

[API](https://skmtc.dev/formaloo/apis/formaloo-api-documentation.md) · [All operations](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/formaloo/apis/formaloo-api-documentation/revisions/47b268aeb656?raw)