curl -X GET \
https://studio.dubformer.ai/api/v1/artifacts/1a2b3c4d5e6f7g8h9i0j \
-H 'Authorization: Bearer YOUR_API_KEY'
import axios from 'axios';
const artifactId = '1a2b3c4d5e6f7g8h9i0j';
const response = await axios.get(
`https://studio.dubformer.ai/api/v1/artifacts/${artifactId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
console.log(response.data);
{
"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"
}
}
Artifacts
Get Artifact
Retrieve detailed information about an artifact
GET
/
api
/
v1
/
artifacts
/
{artifactId}
curl -X GET \
https://studio.dubformer.ai/api/v1/artifacts/1a2b3c4d5e6f7g8h9i0j \
-H 'Authorization: Bearer YOUR_API_KEY'
import axios from 'axios';
const artifactId = '1a2b3c4d5e6f7g8h9i0j';
const response = await axios.get(
`https://studio.dubformer.ai/api/v1/artifacts/${artifactId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
console.log(response.data);
{
"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"
}
}
Path Parameters
string
required
The unique identifier of the artifact to retrieve.
Response
string
Unique identifier of the artifact.
string
Display name of the artifact.
string
Type of artifact. One of:
video, audio, or script.string
Current upload/processing status. One of:
created- Artifact created, processing pendingupload_started- Processing in progressupload_completed- Processing completed successfullyupload_failed- Processing failed
string
Method used to upload the artifact. One of:
direct_url- Uploaded via presigned URL, direct URL, or S3 pathfragments- Created from concatenated fragments
number | null
File size in bytes. Null if not yet processed.
number | null
Duration in seconds for video/audio artifacts. Null for script type or if not yet processed.
string | null
Error message if upload/processing failed. Null if no error occurred.
string
ISO timestamp when the artifact was created.
string
ISO timestamp when the artifact was last updated.
string
Internal S3 storage path where the artifact file is stored.
object
Company information associated with the artifact.
Show properties
Show properties
string
Unique identifier of the company.
curl -X GET \
https://studio.dubformer.ai/api/v1/artifacts/1a2b3c4d5e6f7g8h9i0j \
-H 'Authorization: Bearer YOUR_API_KEY'
import axios from 'axios';
const artifactId = '1a2b3c4d5e6f7g8h9i0j';
const response = await axios.get(
`https://studio.dubformer.ai/api/v1/artifacts/${artifactId}`,
{
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
console.log(response.data);
{
"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.