Skip to main content
GET
/
datasets
/
{dataset_id}
/
interfaces
List connector interfaces compatible with a dataset
curl --request GET \
  --url https://api-dev.narrative.io/datasets/{dataset_id}/interfaces \
  --header 'Authorization: Bearer <token>'
{
  "dataset_id": 18923,
  "accepted": [
    {
      "app_id": 42,
      "interface_id": "audience_export"
    }
  ],
  "errors": [
    {
      "app_id": 99,
      "interface_id": "people_match",
      "details": {
        "valid": false,
        "errors": [
          {
            "instanceLocation": "$.properties",
            "error": "required property 'email' missing"
          }
        ]
      }
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.narrative.io/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

Authorization
string
header
required

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

Path Parameters

dataset_id
integer
required

Unique identifier for a dataset.

Query Parameters

tags
string[]

Restrict evaluation to interfaces whose metadata tags include at least one of the supplied values. Repeat the parameter to pass multiple tags (e.g. ?tags=audience_delivery). Matching is case-insensitive.

Response

OK

dataset_id
integer
required

The dataset whose schema was evaluated against installed connector interfaces.

accepted
object[]
required

Connector interfaces whose policy is satisfied by the dataset's schema.

errors
object[]
required

Connector interfaces whose policy was not satisfied by the dataset's schema, along with per-interface details describing which constraints failed.