How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Oneschema Headless Importer API

Headless Importer operations

Oneschema Headless Importer API is one of 28 APIs that Oneschema publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Headless Importer. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 5 operations across 5 paths, and defines 17 schemas. It is described by OpenAPI 3.1.0, at version 1.

Requests are made against 4 base URLs: https://api.oneschema.co, https://api.eu.oneschema.co, https://api.ca.oneschema.co, https://api.au.oneschema.co.

5 operations 5 paths 17 schemas 5 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1
Base URL
https://api.oneschema.co
Authentication
API Key
Terms of Service
Resource Areas
1

Authentication & Security 1

Oneschema Headless Importer API declares 1 security scheme for authenticating requests. An API key is passed in the header as X-API-KEY (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 5

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

Headless Importer 5

Headless Importer operations

POST
/v1/embeds
Create an embed session
create-embed body → 200400
POST
/v1/embeds/{embed_id}/import
Import an embed file
import-embed-file 1 param → 200422
POST
/v1/embeds/{embed_id}/map
Set column mapping on an embed file
set-column-mapping-on-an-embed-file 1 param body → 200422
POST
/v1/embeds/{embed_id}/set-header
Set header row on an embed file
set-header-row-on-an-embed-file 1 param body → 200422
POST
/v1/embeds/{embed_id}/upload
Upload a CSV or excel file to an embed
upload-a-csv-or-excel-file 1 param body → 200422

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are CustomizationOverrides (46 properties), TemplateColumnOverride (19 properties), CreateEmbedRequest (10 properties), ImportConfig (7 properties). Each schema is shown below with its type and property counts.

import-config-headers
object
ImportConfig
object
7 properties
SetHeaderRequest
object
1 property 1 required
EmbedDetail
object
1 property
EmbedSummary
object
6 properties
EmbedColumn
object
4 properties
CreateEmbedRequest
object
10 properties 3 required
CustomizationOverrides
object
46 properties
MappingOverride
object
3 properties 1 required
SetColumnMappingRequest
object
1 property
UploadFileRequest
object
2 properties 1 required
ImportConfigFormatOptions
object
1 property
EmbedCreatedResponse
object
4 properties
TemplateOverrides
object
1 property
empty-response
object
EmbedUploadResponse
object
4 properties
TemplateColumnOverride
object
19 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

oneschema-headless-importer-api-openapi.yml Raw ↑

Other APIs Oneschema publishes across the network.

Oneschema AWS Secrets Manager Accounts API
Oneschema AWS Secrets Manager Secrets API
Oneschema Azure Key Vault Accounts API
Oneschema Azure Key Vault Secrets API
Oneschema Code Hooks (Legacy) API
Oneschema Event Webhooks API
Oneschema FileFeed Folders API
Oneschema FileFeed Mappings API
Oneschema FileFeeds API
Oneschema FileFeeds Embed Sessions API
Oneschema FileFeeds Imports API
Oneschema Importer Embed Events API
Where this information came from

This is an independent, third-party profile of Oneschema Headless Importer API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.