API documentation
API Reference
- GETHeal Missing User Snapshots
- POSTHeal Missing User Snapshots
- GETRepair Missing User Data
- GETHealth Check
- POSTGenerate Placeholder IDs
- GETPlaceholder Struct for Server Generation
- GETPlaceholder Struct for Thread Content Types
- POSTUpdate Asset Processing State
- POSTUpdate Asset Properties
- POSTInitialize New Asset Upload
- POSTRegister Uploaded Asset
- POSTSearch Assets by Name
- DELDelete Assets (Recoverable)
- GETGet Asset Details
- GETRedeem Access Token
- GETList Collection Members and Pending Invites
- DELDelete Invitation Token
- GETList Collection Assets
- POSTUpdate Collection Properties
- POSTMove Collection and Descendants
- GETList Collection Threads
- POSTAdd New Collection
- DELPermanently Delete Collections
- GETView Collection Details
- POSTLink Assets to Collection
- POSTLink Threads to Collection
- POSTCreate New Device Identifier
- GETGenerate Admin Diagnostic URL
- POSTUpload User Feedback Diagnostics
- POSTUpdate Collection Access Rights
- GETGet User's Recent Assets
- GETList User's Recent Threads
- POSTEnhance Prompt
- POSTShare Collection With Others
- POSTCreate Organization Thread
- DELDelete Threads (Recoverable)
- GETGet Thread Details
- POSTUpdate Thread Properties
- POSTProcess Thread Message
- POSTShare Thread with Link or Email
- POSTCrawl URL
- PUTMerge User Accounts
- POSTAuth Sync
- GETView Collection Hierarchy
- GETHandle WebSocket Connection
- GETFallback is called for debug endpoints. Not intended for normal use.
- PUTFallback is called for debug endpoints. Not intended for normal use.
- POSTFallback is called for debug endpoints. Not intended for normal use.
- DELFallback is called for debug endpoints. Not intended for normal use.
- HEADFallback is called for debug endpoints. Not intended for normal use.
- PATCHFallback is called for debug endpoints. Not intended for normal use.
API Reference
Register Uploaded Asset
API Reference
Register Uploaded Asset
Triggers asset fingerprinting and indexing after upload completion, making the asset available for chat.
POST
/
v1
/
assets
/
notifyUploaded
curl --request POST \
--url https://api.storytell.ai/v1/assets/notifyUploaded \
--header 'Content-Type: application/json' \
--data '{
"assetID": "<string>",
"processInBackground": true,
"processInThread": true
}'
{
"code": "<string>",
"data": {
"chunkingStrategy": "<string>",
"collectionIds": [
[
127
]
],
"contentType": "<string>",
"displayName": "<string>",
"embeddings": [
{
"model": "<string>",
"state": "<string>"
}
],
"etag": "<string>",
"extractionStrategy": "<string>",
"failureReason": "<string>",
"fileSize": 123,
"htmlArtifactTokenCount": 123,
"id": [
127
],
"keywordStrategy": "<string>",
"keywords": [
"<string>"
],
"keywordsTokenCount": 123,
"lifecycleState": "<string>",
"lifecyclesCompleted": [
"<string>"
],
"markdownTokenCount": 123,
"metadata": {
"createdAt": "2023-11-07T05:31:56Z",
"createdBy": [
127
],
"deletedAt": "2023-11-07T05:31:56Z",
"deletedBy": [
127
],
"embeddings": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"extract": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"lastReadyAt": "2023-11-07T05:31:56Z",
"lastReferencedAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z",
"modifiedBy": [
127
],
"processing": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"summarize": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"transcribe": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"uploadedAt": "2023-11-07T05:31:56Z"
},
"organizationId": [
127
],
"originalFileName": "<string>",
"processingErrMessage": "<string>",
"processingMessage": "<string>",
"producedEmbeddings": true,
"producedHTMLArtifact": true,
"producedKeywords": true,
"producedMarkdownArtifact": true,
"producedSummary": true,
"producedTranscriptionArtifact": true,
"references": [
{
"referenceId": [
127
],
"referencedAt": "2023-11-07T05:31:56Z",
"referencedBy": [
127
],
"referencedFor": [
127
],
"vendor": "<string>",
"vendorIdentifier": "<string>"
}
],
"signedURL": "<string>",
"summary": "<string>",
"summaryStrategy": "<string>",
"summaryTokenCount": 123,
"tenantId": [
127
],
"textTokens": 123,
"transcriptionTokenCount": 123,
"version": 123,
"workerStrategy": "<string>"
},
"details": {
"consumption": {
"units": 123
},
"operation": {
"duration": 123,
"operationId": "<string>"
}
},
"done": true,
"eventKey": "<string>",
"message": "<string>"
}
Body
application/json
the trigger to process the asset must occur through the threads domain as knowledge is added. Otherwise, the system will begin processing async in the background.
processed through a websocket message.
Response
200
application/json
Success response
content within the asset.
on disk when it was on the user's system.
period of time. This is a cache of the identifiers used by the vendor to reference the asset. The validity of these identifiers should be confirmed by the vendor before use and the reference dropped or updated.
mMust be less than 2048 characters.
curl --request POST \
--url https://api.storytell.ai/v1/assets/notifyUploaded \
--header 'Content-Type: application/json' \
--data '{
"assetID": "<string>",
"processInBackground": true,
"processInThread": true
}'
{
"code": "<string>",
"data": {
"chunkingStrategy": "<string>",
"collectionIds": [
[
127
]
],
"contentType": "<string>",
"displayName": "<string>",
"embeddings": [
{
"model": "<string>",
"state": "<string>"
}
],
"etag": "<string>",
"extractionStrategy": "<string>",
"failureReason": "<string>",
"fileSize": 123,
"htmlArtifactTokenCount": 123,
"id": [
127
],
"keywordStrategy": "<string>",
"keywords": [
"<string>"
],
"keywordsTokenCount": 123,
"lifecycleState": "<string>",
"lifecyclesCompleted": [
"<string>"
],
"markdownTokenCount": 123,
"metadata": {
"createdAt": "2023-11-07T05:31:56Z",
"createdBy": [
127
],
"deletedAt": "2023-11-07T05:31:56Z",
"deletedBy": [
127
],
"embeddings": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"extract": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"lastReadyAt": "2023-11-07T05:31:56Z",
"lastReferencedAt": "2023-11-07T05:31:56Z",
"modifiedAt": "2023-11-07T05:31:56Z",
"modifiedBy": [
127
],
"processing": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"summarize": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"transcribe": {
"completedAt": "2023-11-07T05:31:56Z",
"count": 123,
"failedAt": "2023-11-07T05:31:56Z",
"failedReason": "<string>",
"message": "<string>",
"occurredAt": "2023-11-07T05:31:56Z",
"startAt": "2023-11-07T05:31:56Z",
"statusCode": 123,
"step": "<string>"
},
"uploadedAt": "2023-11-07T05:31:56Z"
},
"organizationId": [
127
],
"originalFileName": "<string>",
"processingErrMessage": "<string>",
"processingMessage": "<string>",
"producedEmbeddings": true,
"producedHTMLArtifact": true,
"producedKeywords": true,
"producedMarkdownArtifact": true,
"producedSummary": true,
"producedTranscriptionArtifact": true,
"references": [
{
"referenceId": [
127
],
"referencedAt": "2023-11-07T05:31:56Z",
"referencedBy": [
127
],
"referencedFor": [
127
],
"vendor": "<string>",
"vendorIdentifier": "<string>"
}
],
"signedURL": "<string>",
"summary": "<string>",
"summaryStrategy": "<string>",
"summaryTokenCount": 123,
"tenantId": [
127
],
"textTokens": 123,
"transcriptionTokenCount": 123,
"version": 123,
"workerStrategy": "<string>"
},
"details": {
"consumption": {
"units": 123
},
"operation": {
"duration": 123,
"operationId": "<string>"
}
},
"done": true,
"eventKey": "<string>",
"message": "<string>"
}