Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Yoobic Custom Model Instances - Datasets API

Datasets are where all your data is stored. They have some similarities to spreadsheets, for example they look similar and support some of the same functions and formulas. But, in terms of power, efficiency, and elasticity, datasets tend to behave more like a database. Datasets in Yoobic can used all the different data types available in a Yoobic Campaign.Datasets can be used to:- Display your data dynamically in Yoobic’s missions- Update dynamically your data based on Yoobic’s missions- Filter, sort, summarise, and link data- Preserve data integrity- Trigger automations and run calculation### Endpoint: InventoryYOOBIC’s dataset collection is stored in the inventory collection therefore we refer to the inventory endpoint to create or update a dataset.### Custom Model definitionA dataset is identified in YOOBIC’s public API by a custom_model_id . We refer to datasets as a Custom Model because each dataset object is customizable (different field type available for each of the fields). Consequently, each row of a dataset (aka Custom_model) is referred to as a custom_model_instances.### How to create new instances in a datasetImport a csv/excel file containing in the header the name of the field and in the cells the value you want to import. If you are not sure of the format of the csv/excel file, we recommend you to first export your dataset to a csv/excel file and then to use this file as a template for the import.### How to update existing instances in a datasetImport a csv/excel file containing in the header the name of the field and in the cells the value you want to import. If you wish to update the value, you have to provide in the custom_model_instances_id column the value of the instance you wish to update. It’s a unique identifier generated by YOOBIC. The easiest way to do it is to export the existing dataset, then to modify the value directly in the file and finally to import it into YOOBIC.### Fields| Field | Type | Required | Readonly | OrderBy | Description ||-----------------------------------|:--------------:|:--------:|:--------:|:-------:|---------------------------||`custom_model_instances_id` | string | | x | | Unique identifier |**Important** The columns of the export/import depend on the inventory's questions. Each `question_id` is a column header. See [`inventory`](#group-inventory) for more details.

Yoobic Custom Model Instances - Datasets API is one of 41 APIs that Yoobic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Custom Model Instances - Datasets. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, and a changelog.

This API exposes 2 operations across 2 paths, and defines 1 schema. It is described by OpenAPI 3.0.0.

Requests are made against a single base URL, https:///.

2 operations 2 paths 1 schemas 1 GET1 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
Base URL
https://api.yoobic.com/public/api
Authentication
OAuth 2.0
Resource Areas
1

Authentication & Security 1

Yoobic Custom Model Instances - Datasets API declares 1 security scheme for authenticating requests. It supports OAuth 2.0 (oauth2) using the authorizationCode flow.

Paths & Operations 2

Across 2 paths, the API surfaces 2 operations — 1 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Custom Model Instances - Datasets 2

Datasets are where all your data is stored. They have some similarities to spreadsheets, for example they look similar and support some of the same functions and formulas. But, in…

GET
/public/api/custom-model-instances/export?custom_model_id={custom_model_id}&type={type}&filter={filter}
Export
Export 4 params body → 200
POST
/public/api/custom-model-instances/import?custom_model_id={custom_model_id}&type={type}
Import
Import 3 params body → 200

Schemas 1

The contract defines 1 schema that model the data the API accepts and returns. The most detailed is Default_Header (1 property). Each schema is shown below with its type and property counts.

Default_Header
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

yoobic-custom-model-instances-datasets-api-openapi.yml Raw ↑

Other APIs Yoobic publishes across the network.

Yoobic Answers API
Yoobic Badges API
Yoobic Bot Messages API
Yoobic Bots API
Yoobic Business KPIs data - salesdata API
Yoobic Campaigns API
Yoobic Catalogs API
Yoobic Chats API
Yoobic Comments API
Yoobic Communities API
Yoobic Community Posts API
Yoobic Competencies API