파일 생성 및 Presigned URL 발급

Developing

POST

/api/v2/temp-files

Last modified:2026-02-10 05:17:57

파일 업로드를 시작하기 전에 호출하는 API입니다. 이 API를 호출하면 임시파일 레코드가 생성되고, S3에 직접 파일을 업로드할 수 있는 Presigned URL 발급됩니다.
Presigned URL은 제한된 시간 동안만 유효하며, 해당 URL로 파일을 업로드한 후에는 반드시 "파일 업로드 완료 처리" API를 호출해야 파일 파싱이 시작됩니다.

Presigned URL 업로드 예시

Request

Authorization

Add parameter in header

storm-api-key

Example:

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

Body Params application/jsonRequired

Example

{
    "name": "quarterly_report.pdf",
    "size": 103760,
    "contentType": "application/pdf",
    "agentId": "agent_abc123def456"
}

Responses

🟢200Success

application/json

Body

Example

{
    "status": "success",
    "data": {
        "id": "0806790591403921408",
        "uploadUrl": "https://s3.amazonaws.com/bucket/key?X-Amz-Signature=...",
        "expiresAt": "2024-01-15T10:30:00.000Z"
    }
}

Modified at 2026-02-10 05:17:57

채팅 중 파일 업로드

파일 업로드 완료 처리