Skip to main content
POST
Create an imported dataset
Required scopes: metrics:write.

Authorizations

x-chatobserver-key
string
header
required

A workspace API key. Data endpoints require a service-account key with the specified scopes.

Headers

Idempotency-Key
string
required

Unique key for one logical command. Reuse it only when retrying the same request and payload.

Required string length: 16 - 160
Pattern: ^[A-Za-z0-9:_-]+$

Body

application/json
name
string
required
Required string length: 1 - 150
source
object
required
mapping
object
required
updatePolicy
object
required
retentionPolicy
object
required
maximumRows
integer
required
Required range: x <= 10000000
maximumBytes
integer
required
Required range: x <= 10737418240
malformedRowPolicy
enum<string>
required
Available options:
reject_file,
quarantine_rows
description
null | string
Maximum string length: 4000
visibility
string

Service-account resources must be visible to the workspace.

Allowed value: "workspace"
publish
default:false
qualityRules
object[]
Maximum array length: 250

Response

Successful response.

data
object
required
replayed
required