Document Training Request by URL

POST

/api/v2/documents/by-url

It generally takes about 10 seconds to 1 minute per document.
This API responds when the document learning “request” is completed. To receive the result at the time of actual learning “completion”, please specify the webhookUrl parameter.

Files in Google Drive must be accessible to anyone with the link.

Request

Authorization

Add parameter in header

storm-api-key

Example:

storm-api-key: ********************

Body Params application/json

Examples

Responses

🟢200Success

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v2/documents/by-url' \
--header 'storm-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "bucketId": "string",
    "url": "string",
    "webhookUrl": "string"
}'

Response Example

{
    "status": "success",
    "data": {
        "id": "7336209765206708224",
        "dorigin": "google",
        "dtype": "pdf",
        "name": "v8.pdf",
        "description": null,
        "source": "https://drive.google.com/file/d/testfiletestfile/view?usp=sharing",
        "status": "progress",
        "characters": null,
        "createdAt": "2025-06-05T01:58:28.211Z",
        "updatedAt": "2025-06-05T01:58:28.211Z",
        "bucketName": "test_agent",
        "creatorName": "외부테스트계정",
        "lastEditorName": "외부테스트계정"
    }
}

Modified at 2026-02-05 05:16:54

Document Training Request by file

View Documents