Variable Discoveries

Get Variable Discovery

get

Returns details for a specific Variable Discovery.

Authorizations

Bearer

AuthorizationstringRequired

Path parameters

uuidstring · uuidRequired

Responses

200

Successful Response

application/json

uuidstring · uuidRequired

Unique identifier for this variable discovery

data_sourcestring · uuidRequired

The data source this variable discovery is assigned to.

created_atstring · date-timeRequired

Timestamp when this variable discovery was created.

last_modified_atstring · date-timeRequired

Timestamp when this variable discovery was last modified, generally the case when its state changes.

stateone ofRequired

The current state of the variable discovery.

or

or

or

422

Validation Error

application/json

get/v2/variable-discoveries/{uuid}

HTTPcURLJavaScriptPython

GET /api/v2/variable-discoveries/{uuid} HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "data_source": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-07-18T07:33:05.196Z",
  "last_modified_at": "2026-07-18T07:33:05.196Z",
  "state": {
    "type": "text"
  }
}

Get Variable Discoveries

get

Lists Variable Discovery resources

Authorizations

Bearer

AuthorizationstringRequired

Query parameters

data_sourcestring · uuid[] · max: 50 · nullableOptional

machinestring · uuid[] · max: 50 · nullableOptional

sparkstring · uuid[] · max: 50 · nullableOptional

cursorstringOptional

Responses

200

Successful Response

application/json

422

Validation Error

application/json

get/v2/variable-discoveries

HTTPcURLJavaScriptPython

GET /api/v2/variable-discoveries HTTP/1.1
Authorization: YOUR_API_KEY
Accept: */*

{
  "data": [
    {
      "uuid": "123e4567-e89b-12d3-a456-426614174000",
      "data_source": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2026-07-18T07:33:05.196Z",
      "last_modified_at": "2026-07-18T07:33:05.196Z",
      "state": {
        "type": "text"
      }
    }
  ],
  "metadata": {
    "next_cursor": "text"
  }
}

Create Variable Discovery

post

Start a Variable Discovery run on a data source.

Authorizations

Bearer

AuthorizationstringRequired

Body

application/json

data_sourcestring · uuidRequired

The data source this variable discovery is assigned to.

Responses

201

Successful Response

application/json

uuidstring · uuidRequired

Unique identifier for this variable discovery

data_sourcestring · uuidRequired

The data source this variable discovery is assigned to.

created_atstring · date-timeRequired

Timestamp when this variable discovery was created.

last_modified_atstring · date-timeRequired

Timestamp when this variable discovery was last modified, generally the case when its state changes.

stateone ofRequired

The current state of the variable discovery.

or

or

or

422

Validation Error

application/json

post/v2/variable-discoveries

HTTPcURLJavaScriptPython

POST /api/v2/variable-discoveries HTTP/1.1
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 54

{
  "data_source": "123e4567-e89b-12d3-a456-426614174000"
}

{
  "uuid": "123e4567-e89b-12d3-a456-426614174000",
  "data_source": "123e4567-e89b-12d3-a456-426614174000",
  "created_at": "2026-07-18T07:33:05.196Z",
  "last_modified_at": "2026-07-18T07:33:05.196Z",
  "state": {
    "type": "text"
  }
}