{"id": "json_api:tableinsertview", "page": "json_api", "ref": "tableinsertview", "title": "Inserting rows", "content": "This requires the  insert-row  permission. \n                 A single row can be inserted using the  \"row\"  key: \n                 POST /<database>/<table>/-/insert\nContent-Type: application/json\nAuthorization: Bearer dstok_<rest-of-token> \n                 {\n    \"row\": {\n        \"column1\": \"value1\",\n        \"column2\": \"value2\"\n    }\n} \n                 If successful, this will return a  201  status code and the newly inserted row, for example: \n                 {\n    \"rows\": [\n        {\n            \"id\": 1,\n            \"column1\": \"value1\",\n            \"column2\": \"value2\"\n        }\n    ]\n} \n                 To insert multiple rows at a time, use the same API method but send a list of dictionaries as the  \"rows\"  key: \n                 POST /<database>/<table>/-/insert\nContent-Type: application/json\nAuthorization: Bearer dstok_<rest-of-token> \n                 {\n    \"rows\": [\n        {\n            \"column1\": \"value1\",\n            \"column2\": \"value2\"\n        },\n        {\n            \"column1\": \"value3\",\n            \"column2\": \"value4\"\n        }\n    ]\n} \n                 If successful, this will return a  201  status code and a  {\"ok\": true}  response body. \n                 The maximum number rows that can be submitted at once defaults to 100, but this can be changed using the  max_insert_rows  setting. \n                 To return the newly inserted rows, add the  \"return\": true  key to the request body: \n                 {\n    \"rows\": [\n        {\n            \"column1\": \"value1\",\n            \"column2\": \"value2\"\n        },\n        {\n            \"column1\": \"value3\",\n            \"column2\": \"value4\"\n        }\n    ],\n    \"return\": true\n} \n                 This will return the same  \"rows\"  key as the single row example above. There is a small performance penalty for using this option. \n                 If any of your rows have a primary key that is already in use, you will get an error and none of the rows will be inserted: \n                 {\n    \"ok\": false,\n    \"errors\": [\n        \"UNIQUE constraint failed: new_table.id\"\n    ]\n} \n                 Pass  \"ignore\": true  to ignore these errors and insert the other rows: \n                 {\n    \"rows\": [\n        {\n            \"id\": 1,\n            \"column1\": \"value1\",\n            \"column2\": \"value2\"\n        },\n        {\n            \"id\": 2,\n            \"column1\": \"value3\",\n            \"column2\": \"value4\"\n        }\n    ],\n    \"ignore\": true\n} \n                 Or you can pass  \"replace\": true  to replace any rows with conflicting primary keys with the new values. This requires the  update-row  permission. \n                 Pass  \"alter: true  to automatically add any missing columns to the table. This requires the  alter-table  permission.", "breadcrumbs": "[\"JSON API\", \"The JSON write API\"]", "references": "[]"}