ByteChef LogoByteChef
OpenapiRows

Upsert a row by external id

Upsert: insert the row under this external id, or merge the values into the row that already carries it. Idempotent.

PUT
/workspaces/{workspaceId}/data-tables/{name}/rows/by-external-id/{externalId}

Path Parameters

workspaceId*integer

The id of a workspace.

Formatint64
name*string

The table name.

externalId*string

The caller-supplied row key.

Lengthlength <= 255

Header Parameters

X-Environment?string

The environment whose physical table is addressed. PRODUCTION when omitted.

Value in

  • "DEVELOPMENT"
  • "STAGING"
  • "PRODUCTION"

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X PUT "https://example.com/workspaces/0/data-tables/string/rows/by-external-id/string" \  -H "Content-Type: application/json" \  -d '{    "values": {}  }'
{  "id": 0,  "externalId": "string",  "values": {}}

How is this guide?