List data source templates

GET

/v2/themes/{themeId}/data-source-templates

curl --request GET \
  --url https://api.ligr.live/rest/v2/themes/1/data-source-templates \
  --header 'Authorization: Bearer <token>'

• LIGR REST API

Beta. This operation can change between minor versions. See Beta status.

Lists the data source templates of a theme your organization owns. A graphic selects a template by its alias, and an operator pushes rows into the alias per competition.

Authorizations

• bearer
  themes:read
• api_key
  themes:read

Parameters

Path Parameters

themeId

required

number format: double

The theme identifier

Responses

200

Ok

Media typeapplication/json

Array<object>

One data source template. The alias names the schema a graphic selects, and an operator pushes rows into it with POST /v2/data-sources/{competitionThemeSettingId}/{alias}.

object

id

required

integer format: int32

alias

required

string

sourceType

required

string

Allowed values: csv xlsx

shape

required

string

Allowed values: cell kv rows

config

required

Parse options, for example headerRow and dataStartRow. Null when the defaults apply.

schema

required

JSON schema of the pushed data. The server infers it from the sample.

sample

required

First rows of the sample, so the builder can preview the shape.

description

required

string

nullable

updatedAt

required

ISO 8601 timestamp.

string

Example

[
  {
    "sourceType": "csv",
    "shape": "cell"
  }
]

400

Request is invalid

Media typeapplication/json

object

message

required

string

details

required

object

key

additional properties

Example^generated

{
  "message": "example",
  "details": {
    "additionalProperty": "example"
  }
}

401

Missing or invalid api key

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Api key provides insufficient access for the request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

404

Theme or data source template not found

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

429

Api key has made too many requests

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

500

An unexpected error has occured. If problems persist please contact support

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}