Skip to main content
GET
/
api
/
v1
/
artifacts
/
{artifactId}
curl -X GET \
  https://studio.dubformer.ai/api/v1/artifacts/1a2b3c4d5e6f7g8h9i0j \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "694eb201f9fc340f3ae47280",
  "name": "Source Audio",
  "type": "audio",
  "status": "upload_completed",
  "uploadMethod": "fragments",
  "size": 6638526,
  "duration": 138.301,
  "errorMessage": null,
  "createdAt": "2025-12-26T16:04:17.367Z",
  "updatedAt": "2026-01-12T14:42:59.985Z",
  "s3Path": "uploads/694eb201f9fc340f3ae47280/source_video.wav",
  "company": {
    "id": "6686801a54e7c52988dbc531"
  },
  "createdBy": {
    "id": "68517bac632d23eb88bf8e5c"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.dubformer.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Path Parameters

​
artifactId
string
required
The unique identifier of the artifact to retrieve.

​
Response

​
id
string
Unique identifier of the artifact.
​
name
string
Display name of the artifact.
​
type
string
Type of artifact. One of: video, audio, or script.
​
status
string
Current upload/processing status. One of:
  • created - Artifact created, processing pending
  • upload_started - Processing in progress
  • upload_completed - Processing completed successfully
  • upload_failed - Processing failed
​
uploadMethod
string
Method used to upload the artifact. One of:
  • direct_url - Uploaded via presigned URL, direct URL, or S3 path
  • fragments - Created from concatenated fragments
​
size
number | null
File size in bytes. Null if not yet processed.
​
duration
number | null
Duration in seconds for video/audio artifacts. Null for script type or if not yet processed.
​
errorMessage
string | null
Error message if upload/processing failed. Null if no error occurred.
​
createdAt
string
ISO timestamp when the artifact was created.
​
updatedAt
string
ISO timestamp when the artifact was last updated.
​
s3Path
string
Internal S3 storage path where the artifact file is stored.
​
company
object
Company information associated with the artifact.
​
createdBy
object
User who created the artifact.
curl -X GET \
  https://studio.dubformer.ai/api/v1/artifacts/1a2b3c4d5e6f7g8h9i0j \
  -H 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "694eb201f9fc340f3ae47280",
  "name": "Source Audio",
  "type": "audio",
  "status": "upload_completed",
  "uploadMethod": "fragments",
  "size": 6638526,
  "duration": 138.301,
  "errorMessage": null,
  "createdAt": "2025-12-26T16:04:17.367Z",
  "updatedAt": "2026-01-12T14:42:59.985Z",
  "s3Path": "uploads/694eb201f9fc340f3ae47280/source_video.wav",
  "company": {
    "id": "6686801a54e7c52988dbc531"
  },
  "createdBy": {
    "id": "68517bac632d23eb88bf8e5c"
  }
}
This endpoint returns metadata about the artifact, including the internal S3 storage path. Note that the S3 path is provided for reference but direct access requires proper authentication and authorization.