Get Artifact

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"
  }
}

GET

api

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 pending
upload_started - Processing in progress
upload_completed - Processing completed successfully
upload_failed - Processing failed

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

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

string

Unique identifier of the company.

object

User who created the artifact.

Show properties

string

Unique identifier of the user.

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.

Getting Started

Artifacts

Projects

Project Videos

Path Parameters

Response

​Path Parameters

​Response

Path Parameters

Response