Create a DataSet

Creates a new DataSet in your Domo instance. Once a DataSet has been created, data can be imported into the DataSet.

POST /v1/datasets

Create a DataSet

cURL

curl --request POST \
  --url https://api.domo.com/v1/datasets \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "Leonhard Euler Party",
  "description": "Mathematician Guest List",
  "rows": 0,
  "schema": {
    "columns": [
      {
        "type": "STRING",
        "name": "Friend"
      },
      {
        "type": "STRING",
        "name": "Attending"
      }
    ]
  }
}
'

201

{
  "id": "4405ff58-1957-45f0-82bd-914d989a3ea3",
  "name": "Leonhard Euler Party",
  "description": "Mathematician Guest List",
  "rows": 0,
  "columns": 0,
  "schema": {
    "columns": [
      {
        "type": "STRING",
        "name": "Friend"
      },
      {
        "type": "STRING",
        "name": "Attending"
      }
    ]
  },
  "owner": {
    "id": 27,
    "name": "DomoSupport"
  },
  "createdAt": "2016-06-21T17:20:36Z",
  "updatedAt": "2016-06-21T17:20:36Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

name · string · required

Name of the DataSet to create

schema · object · required

The current schema associated with this DataSet

Show child attributes

description · string

Description of DataSet to create

Response

201 - application/json

Returns a DataSet object when successful. The returned object will have DataSet attributes based on the information provided when the DataSet was created.

id · string

name · string

description · string

rows · integer

columns · integer

schema · object

Show child attributes

owner · object

Show child attributes

createdAt · string

updatedAt · string