POST
/
datasets
curl --request POST \
  --url https://api.axiom.co/v2/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "description": "string",
  "name": "string",
  "retentionDays": 30
}'
{
  "created": "2022-07-20T02:35:14.137Z",
  "description": "string",
  "id": "string",
  "name": "string",
  "who": "string"
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

referrer
string

Referrer slug

Body

application/json
name
string
required

Dataset unique name

description
string
default:

Dataset description

retentionDays
integer

Number of days to retain data in the dataset

useRetentionPeriod
boolean

Whether to use the retention period

Response

200
application/json
Created
created
string
required

The RFC3339-formatted time when the dataset was created.

description
string
required

Dataset description

id
string
required

Dataset ID

name
string
required

Unique dataset name

who
string
required

Name of the dataset creator

canWrite
boolean

Whether this dataset has write access

retentionDays
integer

Number of days to retain data in the dataset

sharedByOrg
string

ID of the org that shared this resource, if it's shared

useRetentionPeriod
boolean

Whether to use the retention period