Sign inGet Started
शुरू करें
गाइड
API Reference
SDKs
CLI
Knowledge Base
Changelog

Refresh a media-library upload instruction

POST
/v1/asset-upload-sessions/{upload_id}/prepare
const upload = await bird.assets.uploads.prepare("aus_01krdgeqcxet5s7t44vh8rt9mg");
console.log(upload.state);
प्रतिक्रिया200
{
  "id": "aus_01krdgeqcxet5s7t44vh8rt9mg",
  "state": "pending",
  "folder_id": "asf_01krdgeqcxet5s7t44vh8rt9mg",
  "file": {
    "filename": "invoice.pdf",
    "content_type": "application/pdf",
    "size_bytes": 1024,
    "sha256": "4e2090a479f7ce6b17ad31f991988f12571bcafbd4a441cc4063644fc1400ae0"
  },
  "result": {
    "asset_id": "ast_01krdgeqcxet5s7t44vh8rt9mg"
  },
  "next": [
    {
      "kind": "operation"
    }
  ]
}

Refreshes the temporary upload instruction for a pending session. File properties and the one-hour session deadline remain unchanged. No replacement file or metadata is accepted.

पैरामीटर

upload_idstring

ID of the media-library upload session.

Response Payload

id
string
आवश्यक
state
string
आवश्यक

The session is awaiting transfer and completion.

Value: pending

expires_at
string
आवश्यक

Absolute session expiry. Completion must finish before this deadline; starting it or refreshing an upload instruction does not extend it.

name
string
आवश्यक

Frozen display name for a newly published asset.

alt_text
nullable string
आवश्यक

Frozen alternative text, or null when omitted.

folder_id
nullable string
आवश्यक

Frozen destination folder, or null for the library root.

file
object
आवश्यक

Exact properties of the original file. Calculate size and SHA-256 from its bytes before creating a session. Images allow up to 5,242,880 bytes; other supported media allow up to 25,000,000 bytes.

चाइल्ड एट्रिब्यूट दिखाएँ
result
nullable object
आवश्यक

Saved publication receipt, or null until completed.

चाइल्ड एट्रिब्यूट दिखाएँ
last_error
nullable object
आवश्यक

Last completion error, or null when no failure is recorded.

चाइल्ड एट्रिब्यूट दिखाएँ
next
array of object
आवश्यक

Available next steps for this session.

चाइल्ड एट्रिब्यूट दिखाएँ
upload
object
आवश्यक

Send the original file bytes to this URL with the exact headers and content length. Send no Bird credentials or cookies. Keep the URL private and call complete after the PUT succeeds.

चाइल्ड एट्रिब्यूट दिखाएँ
upload.method
string
आवश्यक

HTTP method for transferring the file.

Value: PUT

upload.url
string
आवश्यक

Temporary HTTPS upload URL. It can be reused for the same fixed file until expiry.

upload.required_headers
object
आवश्यक

Headers the upload request must send exactly as provided.

upload.content_length
integer
आवश्यक

Required HTTP content length in bytes.

upload.expires_at
string
आवश्यक

Upload instruction expiry, bounded by the session and signing credentials.

संबंधित संसाधन

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ