Data Feeds

Attach a data source to a data feed

Attaches a new data source to a data feed. Each data feed can have at most one source per source_type. Returns the updated data feed including all attached sources.

Settings are validated on save; see config in the request body for the keys each source_type takes. Validation does not connect to the database or endpoint, so a wrong host, query or secret surfaces on the first run. api sources require HTTP API sources to be enabled for your account; otherwise returns 422 “Source type HTTP API is not enabled for this account”. Contact Mangrove to enable them. Requires the write:data_feed token scope.

POST

data_feeds

{data_feed_friendly_id}

sources

curl --request POST \
  --url https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": {
    "name": "API uploads",
    "source_type": "endpoint"
  }
}
'

{
  "id": "datafd_aBcD1234eFgH5678",
  "name": "Daily Production Data",
  "description": "Imports daily production metrics",
  "headers_row_number": 1,
  "setup_error": "<string>",
  "not_ready_message": null,
  "schema_fields": [
    {
      "name": "site_name",
      "value_type": "string"
    }
  ],
  "event_types": [
    {
      "id": 123,
      "name": "<string>",
      "slug": "<string>"
    }
  ],
  "transformations": [
    {
      "id": "tfn_aBcD1234eFgH5678",
      "event_type_id": "et_aBcD1234eFgH5678",
      "event_type_name": "<string>",
      "script_status": "generating",
      "script_content": "<string>"
    }
  ],
  "sources": [
    {
      "id": "dsrc_aBcD1234eFgH5678",
      "name": "<string>",
      "source_type": "endpoint",
      "config": {}
    }
  ],
  "ui_url": "https://app.gomangrove.com/nexus/prj_aBcD1234eFgH5678/data-inputs/data-feeds/datafd_aBcD1234eFgH5678",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

Path Parameters

data_feed_friendly_id

string

required

The data feed's friendly ID (e.g. datafd_aBcD1234eFgH5678).

Body

application/json

source

object

required

Show child attributes

Response

Source successfully attached. Returns the updated data feed.

A data feed. List rows omit each transformation's script_content and each source's config; single-feed responses include them.

string

The data feed's friendly ID.

Example:

"datafd_aBcD1234eFgH5678"

name

string

Example:

"Daily Production Data"

description

string | null

Example:

"Imports daily production metrics"

headers_row_number

integer

Row number (1-based) containing column headers. Rows above are ignored during ingestion. 1 until a schema sets another value.

Example:

1

setup_error

string | null

Why automatic setup could not build the schema (for example an unreadable sample file), or null.

not_ready_message

string | null

Why the feed cannot accept data yet, or null when it is ready. A new feed reports "Transformation scripts are still being generated" until its scripts are drafted, and "Schema not defined" until a schema exists.

Example:

null

schema_fields

object[]

The columns of the current schema. Empty until a schema is defined.

Show child attributes

event_types

object[]

The event types the feed's active transformations create.

Show child attributes

transformations

object[]

Active (unarchived) transformations, one per event type.

Show child attributes

sources

object[]

Show child attributes

ui_url

string<uri>

Link to the data feed's page in the app.

Example:

"https://app.gomangrove.com/nexus/prj_aBcD1234eFgH5678/data-inputs/data-feeds/datafd_aBcD1234eFgH5678"

created_at

string<date-time>

updated_at

string<date-time>

curl --request POST \
  --url https://app.gomangrove.com/api/v1/data_feeds/{data_feed_friendly_id}/sources \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "source": {
    "name": "API uploads",
    "source_type": "endpoint"
  }
}
'

{
  "id": "datafd_aBcD1234eFgH5678",
  "name": "Daily Production Data",
  "description": "Imports daily production metrics",
  "headers_row_number": 1,
  "setup_error": "<string>",
  "not_ready_message": null,
  "schema_fields": [
    {
      "name": "site_name",
      "value_type": "string"
    }
  ],
  "event_types": [
    {
      "id": 123,
      "name": "<string>",
      "slug": "<string>"
    }
  ],
  "transformations": [
    {
      "id": "tfn_aBcD1234eFgH5678",
      "event_type_id": "et_aBcD1234eFgH5678",
      "event_type_name": "<string>",
      "script_status": "generating",
      "script_content": "<string>"
    }
  ],
  "sources": [
    {
      "id": "dsrc_aBcD1234eFgH5678",
      "name": "<string>",
      "source_type": "endpoint",
      "config": {}
    }
  ],
  "ui_url": "https://app.gomangrove.com/nexus/prj_aBcD1234eFgH5678/data-inputs/data-feeds/datafd_aBcD1234eFgH5678",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Getting Started

API Cookbooks

Production Data

Accounting and Reporting

Credit Inventory Management

Account Admin

Attach a data source to a data feed

Authorizations

Path Parameters

Body

Response