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

Affinda Data Sources API

Manage custom mapping data sources — master-data lists used to match raw extracted values (vendor names, SKUs, categories) to known canonical entities. Upload values via the API and reference the data source from a document type field to enable automatic data matching during parsing.

Affinda Data Sources API is one of 16 APIs that Affinda publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Data Sources, Master Data, and Matching. The published artifact set on APIs.io includes API documentation and an OpenAPI specification.

This API exposes 10 operations across 4 paths, and defines 8 schemas. It is described by OpenAPI 3.0.3, at version 3.0.0.

Requests are made against a single base URL, https://{region}.affinda.com.

10 operations 4 paths 8 schemas 2 DELETE4 GET2 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
3.0.0
Server
https://{region}.affinda.com
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Affinda Data Sources API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (ApiKeyAuth). By default, every request must be authenticated.

  • ApiKeyAuth — Basic authentication using an API key, e.g. {Authorization: Bearer aff0bb4fbdf97b7e4111ff6c0015471094155f91}. You can find your API key within the Settings pag…

Paths & Operations 10

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

Data Sources 10
POST
/v3/mapping_data_sources
Create a data source
createMappingDataSource body → 201400401default
GET
/v3/mapping_data_sources
List data sources
listMappingDataSources 6 params → 200400401default
GET
/v3/mapping_data_sources/{identifier}
Get specific data source
getMappingDataSource 1 param → 200400401default
DELETE
/v3/mapping_data_sources/{identifier}
Delete specific data source
deleteMappingDataSource 1 param → 204400401default
GET
/v3/mapping_data_sources/{identifier}/values
List values for a data source
listMappingDataSourceValues 6 params → 200400401default
PUT
/v3/mapping_data_sources/{identifier}/values
Replace values for a data source
replaceMappingDataSourceValues 1 param body → 201400401default
POST
/v3/mapping_data_sources/{identifier}/values
Add value for a data source
addMappingDataSourceValue 1 param body → 201400401default
GET
/v3/mapping_data_sources/{identifier}/values/{value}
Get specific data source value
getMappingDataSourceValue 2 params → 200400401default
PUT
/v3/mapping_data_sources/{identifier}/values/{value}
Update specific data source value
updateMappingDataSourceValue 2 params body → 200400401default
DELETE
/v3/mapping_data_sources/{identifier}/values/{value}
Delete specific data source value
deleteMappingDataSourceValue 2 params → 204400401default

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are MappingDataSourceCreate (7 properties), MappingDataSource (7 properties), PaginatedResponse (3 properties), RequestError (2 properties). Each schema is shown below with its type and property counts.

MappingDataSourceCreate
object
A mapping data source is used to map from raw data found by our AI models to records in your database.
7 properties 1 required
Organization_properties-identifier
string
Uniquely identify an organization.
MappingDataSource_properties-identifier
string
Uniquely identify a mapping data source.
RequestError
object
2 properties 2 required
PaginatedResponse
object
3 properties 1 required
MappingDataSource
object
A mapping data source is used to map from raw data found by our AI models to records in your database.
7 properties 5 required
properties-name
string
identifier
string
Uniquely identify a workspace.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

affinda-data-sources-api-openapi.yml Raw ↑

Other APIs Affinda publishes across the network.

Affinda Documents API
Affinda Document Types API
Affinda Workspaces API
Affinda Organizations API
Affinda Annotations API
Affinda Validation Results API
Affinda Tags API
Affinda Usage API
Affinda Webhooks API
Affinda Search and Match API
Affinda Add x-hidden to endpoints API
Affinda Deprecated End Points API