Artifacts API

    Store, retrieve, and manage files and data produced by agent executions.

    list()

    typescript
    const { data: artifacts } = await client.artifacts.list({
  sessionId: 'session-uuid', // optional filter
  type: 'image',             // optional filter
});

artifacts.forEach(a => {
  console.log(`${a.title} (${a.mimeType}) - ${a.sizeBytes} bytes`);
});

    get()

    typescript
    const artifact = await client.artifacts.get('artifact-uuid');

console.log(artifact.title);
console.log(artifact.type);     // 'image' | 'document' | 'code' | 'data'
console.log(artifact.mimeType); // 'image/png', 'application/json', etc.
console.log(artifact.url);      // signed download URL

    getDownloadUrl()

    typescript
    const url = await client.artifacts.getDownloadUrl('artifact-uuid');
// Returns a time-limited signed URL for downloading the artifact

    Artifact Types

    TypeDescriptionCommon MIME Types
    imageGenerated imagesimage/png, image/jpeg, image/webp
    documentReports, PDFs, documentsapplication/pdf, text/markdown
    codeGenerated code snippetstext/plain, application/json
    dataStructured data exportstext/csv, application/json