Database table form view

Changed on

Submits the form if the form is publicly shared or if the user has access to the related workspace. The provided data will be validated based on the fields that are in the form and the rules per field. If valid, a new row will be created in the table.

post/api/database/views/form/{slug}/submit/

Request

  • Base URL
    https://api.baserow.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.baserow.io/api/database/views/form/{slug}/submit/
  • Auth
    • HTTP bearer
    • or none

Path parameters

slugstring required

The slug related to the form.

Request body

field_1string nullable

This field represents the text field. The number in field_1 is in a normal request or response the id of the field.

field_2string nullable

This field represents the long_text field. The number in field_2 is in a normal request or response the id of the field.

field_3string nullable

This field represents the url field. The number in field_3 is in a normal request or response the id of the field.

field_4string nullable

This field represents the email field. The number in field_4 is in a normal request or response the id of the field.

field_5string decimal nullable

This field represents the number field. The number in field_5 is in a normal request or response the id of the field.

field_6integer

This field represents the rating field. The number in field_6 is in a normal request or response the id of the field.

field_7boolean

This field represents the boolean field. The number in field_7 is in a normal request or response the id of the field.

field_8string date nullable

This field represents the date field. The number in field_8 is in a normal request or response the id of the field.

field_13number float nullable

This field represents the duration field. The number in field_13 is in a normal request or response the id of the field. The provided value can be a string in one of the available formats or a number representing the duration in seconds. In any case, the value will be rounded to match the field's duration format.

field_14integer[]

This field represents the link_row field. The number in field_14 is in a normal request or response the id of the field. This field accepts an array containing the ids or the names of the related rows. A name is the value of the primary key of the related row. This field also accepts a string with names separated by a comma or an array of row names. You can also provide a unique row Id.The response contains a list of objects containing the id and the primary field's value as a string for display purposes.

field_16integer nullable

Accepts one of the following option ids as integer value This field accepts an integer representing the chosen select option id related to the field. Available ids can be found when getting or listing the field. The response represents chosen field, but also the value and color is exposed..

field_17integer[]

This field represents the multiple_select field. The number in field_17 is in a normal request or response the id of the field. This field accepts a list of integer each of which representing the chosen select option id related to the field. Available ids can be foundwhen getting or listing the field. You can also send a list of option names in which case the option are searched by name. The first one that matches is used. This field also accepts a string with names separated by a comma or an array of file names. The response represents chosen field, but also the value and color is exposed.

field_18string nullable

This field represents the phone_number field. The number in field_18 is in a normal request or response the id of the field.

field_23integer[]

This field represents the multiple_collaborators field. The number in field_23 is in a normal request or response the id of the field. This field accepts a list of objects representing the chosen collaborators through the object's id property. The id is Baserow user id. The response objects also contains the collaborator name directly along with its id.

field_26string nullable

This field represents the password field. The number in field_26 is in a normal request or response the id of the field. Allows setting a write only password value. Providing a string will set the password, null will unset it, true will be ignored. The response will respond with true is a password is set, but will never expose the password itself.

field_29string nullable

This field represents the ai field. The number in field_29 is in a normal request or response the id of the field. Holds a value that is generated by a generative AI model using a dynamic prompt.

Response

submit_action'MESSAGE' | 'REDIRECT'
  • MESSAGE - Message
  • REDIRECT - Redirect
submit_action_messagestring

If the submit_action is MESSAGE, then this message will be shown to the visitor after submitting the form.

row_idinteger required

Changes

  • 8afc69805528Revision changes
    • breaking

      the response property's maxLength was unset from 2000 for the response status

    • breaking

      added subschema #1 subschema #2 to the response property oneOf list for the response status

    • breaking

      the response's property type changed from string to no type, and format from uri to no format for status

  • e81714236040Revision changes
    • info

      the endpoint scheme security UserSource JWT was removed from the API

    • info

      added the non-success response with the status