Create records

POST

/api/v1/tables/{tableId}/records

curl --request POST \
  --url https://api.cloudtable.insurge.io/api/v1/tables/example/records \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '{ "fields": { "additionalProperty": "example" }, "records": [ { "fields": { "additionalProperty": "example" } } ], "upsertOn": [ "example" ] }'

• CloudTable

Body: { fields } for one, or { records: [{ fields }] } for many. Pass upsertOn: [“Field Name”] to update matching rows instead of inserting. Fields are keyed by name; selects accept the option name, links accept record ids.

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

tableId

required

string

Request Body

Media typeapplication/json

object

fields

object

key

additional properties

nullable

records

Array<object>

object

fields

required

object

key

additional properties

nullable

upsertOn

Array<string>

Example^generated

{
  "fields": {
    "additionalProperty": "example"
  },
  "records": [
    {
      "fields": {
        "additionalProperty": "example"
      }
    }
  ],
  "upsertOn": [
    "example"
  ]
}

Responses

200

Created/upserted records

Media typeapplication/json

object

records

required

Array<object>

object

id

required

string

createdTime

string

fields

required

object

key

additional properties

nullable

Example^generated

{
  "records": [
    {
      "id": "example",
      "createdTime": "example",
      "fields": {
        "additionalProperty": "example"
      }
    }
  ]
}

400

Bad input

401

Unauthorized

404

Not found