Update Business
Updates a Workspace business version, or, with scope=shared and no Workspace, submits sourced updates about an existing public Business. Shared updates require a signed-in user or an HTTP API key with businesses:write, plus source, observed_at and rights_basis. Submit at most 100 updates total across fields and additional_observations. Each submitted field is saved as pending evidence; canonical facts and publication stay unchanged. Retry the same input and idempotency key to recover the original receipt.
Signed-in user's Supabase access token. Workspace-scoped operations also require SMB-Workspace-Id.
In: header
Path Parameters
Stable SMB Business ID.
^biz_[0-7][0-9A-HJKMNP-TV-Z]{25}$Header Parameters
Required for Workspace edits; must be omitted when scope=shared.
uuid8 <= length <= 200Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/v1/businesses/string" \ -H "Idempotency-Key: stringst" \ -H "Content-Type: application/json" \ -d '{}'{ "business_id": "string", "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9", "name": "string", "status": "active", "fields": {}, "updated_fields": [ "string" ], "revision": 1, "based_on_business_revision": 1, "access_level": "view", "created": true, "business_created": true, "idempotent_replay": true, "request_id": "string", "receipt": { "receipt_id": "64d0a161-468e-472a-b00e-a06ee9ab7de7", "command_id": "7d510d78-7444-4252-aeac-9e473949661e", "operation": "string", "workspace_id": "0967198e-ec7b-4c6b-b4d3-f71244cadbe9" }, "additional_observations": [ { "observation_id": "d5b663f3-1b87-4f94-9f66-dbd8d5553132", "name": "string", "mapping_status": "mapped" } ]}