This reference is the skmtc/skmtc-api API on Hub. Star it to see each revision, and add a pipeline to get its changes.
StarOpen on HubPublish through an upload URL
Publish the document bytes through an upload URL from createPublishUpload, as the user who minted it. The token in the path is the only credential. An unknown, used or expired token is a 401, and no revision is created.
Request
POST/v1/apis/publish/uploads/{token}application/octet-streamstringpath, requiredRequest body
Response
201 application/json
The request has succeeded and a new resource has been created as a result.
The outcome of importing a schema document into the catalog.
The API the schema belongs to - newly created, or extended with a revision.
The revision created - or the pre-existing one when deduped is true.
True when identical content already existed; no new revision was created.
True when the import created a brand-new API entry.
True when the API's full revision history is still being archived + diffed in the background - a large GitHub history deferred to the diff-backfill queue so the import responds without waiting on minutes of container diffs. The returned revision (the newest) is complete; older revisions' diffs fill in shortly. False for single-revision imports, which diff inline.
{
"api": {
"id": "string",
"owner": {
"id": "string",
"handle": "string",
"displayName": "string",
"type": "user",
"avatarUrl": "string",
"bio": "string",
"location": "string",
"emailDomain": "string",
"claimStatus": "claimed",
"joinedAt": "2026-10-30T12:00:00Z",
"url": "string",
"htmlUrl": "string"
},
"slug": "string",
"name": "string",
"displayName": "string",
"visibility": "public",
"description": "string",
"category": "ai-machine-learning",
"readme": "string",
"providerName": "string",
"homepageUrl": "string",
"logoUrl": "string",
"isVerified": true,
"license": {
"name": "string",
"spdxId": "string",
"url": "string"
},
"sources": [
{
"id": "string",
"type": "direct_url",
"url": "string",
"discoveredVia": "string",
"isPrimary": true,
"refetchEnabled": true,
"lastCheckedAt": "2026-10-30T12:00:00Z",
"lastStatus": "updated",
"lastError": "string",
"createdAt": "2026-10-30T12:00:00Z"
}
],
"versions": [
{
"label": "string",
"stability": "ga",
"isDefault": true,
"sortRank": 0,
"releasedAt": "2026-10-30T12:00:00Z",
"eolAt": "2026-10-30T12:00:00Z"
}
],
"lastCheckedAt": "2026-10-30T12:00:00Z",
"lastUpdatedAt": "2026-10-30T12:00:00Z",
"latestVersionRef": "string",
"versionCount": 0,
"retiredAt": "2026-10-30T12:00:00Z",
"starCount": 0,
"consumerCount": 0,
"createdAt": "2026-10-30T12:00:00Z",
"updatedAt": "2026-10-30T12:00:00Z",
"url": "string",
"htmlUrl": "string",
"viewer": {
"canRead": true,
"canWrite": true,
"canAdmin": true
}
},
"revision": {
"publishedAt": "2026-10-30T12:00:00Z",
"isLatest": true,
"hasDocument": true,
"documentUrl": "string",
"commit": {
"sha": "string",
"message": "string",
"date": "2026-10-30T12:00:00Z",
"htmlUrl": "string"
},
"linkedRepositoryRun": {
"repository": "string",
"sha": "string",
"runId": "string",
"runAttempt": "string",
"workflowRef": "string",
"htmlUrl": "string"
},
"specType": "openapi",
"specVersion": "string",
"documentVersion": "string",
"license": {
"name": "string",
"spdxId": "string",
"url": "string"
},
"retrievedAt": "2026-10-30T12:00:00Z",
"operationCount": 0,
"schemaCount": 0,
"serverUrl": "string",
"authSchemes": [
"apiKey"
],
"documentFormat": "json",
"byteSize": 0,
"contentHash": "string",
"contentRef": "string",
"url": "string",
"htmlUrl": "string"
},
"deduped": true,
"isNewApi": true,
"diffsPending": true
}400 application/json
Binds a concrete HTTP Status to the shared ApiError body.
The uniform error envelope returned for every non-2xx response.
Machine-readable error category. Each value pairs with one HTTP status.
Human-readable summary safe to surface to end users.
Correlates the response with server logs for support.
{
"code": "badRequest",
"message": "string",
"requestId": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}401 application/json
Binds a concrete HTTP Status to the shared ApiError body.
The uniform error envelope returned for every non-2xx response.
Machine-readable error category. Each value pairs with one HTTP status.
Human-readable summary safe to surface to end users.
Correlates the response with server logs for support.
{
"code": "badRequest",
"message": "string",
"requestId": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}403 application/json
Binds a concrete HTTP Status to the shared ApiError body.
The uniform error envelope returned for every non-2xx response.
Machine-readable error category. Each value pairs with one HTTP status.
Human-readable summary safe to surface to end users.
Correlates the response with server logs for support.
{
"code": "badRequest",
"message": "string",
"requestId": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}404 application/json
Binds a concrete HTTP Status to the shared ApiError body.
The uniform error envelope returned for every non-2xx response.
Machine-readable error category. Each value pairs with one HTTP status.
Human-readable summary safe to surface to end users.
Correlates the response with server logs for support.
{
"code": "badRequest",
"message": "string",
"requestId": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}409 application/json
Binds a concrete HTTP Status to the shared ApiError body.
The uniform error envelope returned for every non-2xx response.
Machine-readable error category. Each value pairs with one HTTP status.
Human-readable summary safe to surface to end users.
Correlates the response with server logs for support.
{
"code": "badRequest",
"message": "string",
"requestId": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}422 application/json
Binds a concrete HTTP Status to the shared ApiError body.
The uniform error envelope returned for every non-2xx response.
Machine-readable error category. Each value pairs with one HTTP status.
Human-readable summary safe to surface to end users.
Correlates the response with server logs for support.
{
"code": "badRequest",
"message": "string",
"requestId": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}Changes
Operation history2fe10b584fa2- added
#/components/schemas/SourceRefetchStatusto theapi/allOf[#/components/schemas/Api]/sources/items/lastStatusresponse propertyallOflist for the response status201 - removed
#/components/schemas/SourceRefreshStatusfrom theapi/allOf[#/components/schemas/Api]/sources/items/lastStatusresponse propertyallOflist for the response status201