Skip to main content
POST
Upload an External OpenAPI Schema

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider. Send it in the Authorization header as Bearer <token>.

Body

multipart/form-data
file
file
required

OpenAPI 3.x schema file (JSON).

name
string
required

Schema name.

Example:

"kyc-provider"

version
string
required

Schema version.

Example:

"v1.0.0"

Response

Indicates that the resource was successfully created and the operation was completed as expected.

byteSize
integer<int64>
required
Example:

4096

contentHash
string
required
Example:

"sha256:9f2c8b1a4d7e0f3c6b5a8d2e1f4c7b0a3d6e9f2c5b8a1d4e7f0c3b6a9d2e5f8c"

createdAt
string<date-time>
required
Example:

"2026-01-15T10:30:00Z"

createdBy
string
required
Example:

"user@example.com"

id
string<uuid>
required
Example:

"018f3e2a-1c4d-7b9e-a1b2-c3d4e5f6a7b8"

name
string
required
Example:

"jd-spi"

openapiVersion
string
required
Example:

"3.0.3"

operationCount
integer<int64>
required
Example:

42

title
string
required
Example:

"JD SPI API"

version
string
required
Example:

"1"