Skip to main content
GET
https://studio.dubformer.ai
/
api
/
v1
/
artifacts
/
{artifactId}
curl -X GET \
  https://studio.dubformer.ai/api/v1/artifacts/1a2b3c4d5e6f7g8h9i0j \
  -H 'Authorization: Bearer YOUR_API_KEY'
{
  "id": "694eb201f9fc340f3ae47280",
  "fileName": "source_video.wav",
  "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"
  }
}

Path Parameters

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

Response

id
string
Unique identifier of the artifact.
fileName
string
Original name of the uploaded file.
type
string
Type of artifact. One of: video, audio, or script.
status
string
Current upload/processing status. One of:
  • created - Artifact created, upload pending
  • upload_started - Upload in progress
  • upload_completed - Upload and processing completed
  • upload_failed - Upload or processing failed
uploadMethod
string
Method used to upload the artifact. One of:
  • presigned_url - Uploaded via presigned URL
  • direct_url - Uploaded from external URL
  • 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",
  "fileName": "source_video.wav",
  "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.