Assets API

Object storage, uploads, transformations, delivery, media processing, and asset operations. Base URL: https://api.stackshift.cloud/api/v1 Authentication varies by route: management uses an account bearer key; /playback sessions use anonymous creation or ephemeral playback credentials; picker operations use an origin-bound capability. Absolute /playback paths use the API origin without /api/v1. See the native video and picker guides and each OpenAPI security requirement. SDK-backed operations are traced to official source files in the coverage report. Routes without an SDK wrapper are explicitly marked contract-only.

Method	SDK route	SDK method	Request type	Response type
`PUT`	`/assets/ai/credential`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`DELETE`	`/assets/ai/credential`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/{assetID}/ai/outputs/{outputID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/{assetID}/video`	`AssetVideoClient.workspace`	`None`	`AssetVideoWorkspace`
`POST`	`/assets/{assetID}/versions/{versionID}/video`	`AssetVideoClient.process`	`None`	`AssetVideoPackage`
`POST`	`/assets/{assetID}/playback-sessions`	`AssetVideoClient.createSession`	`None`	`AssetPlaybackGrant`
`DELETE`	`/assets/{assetID}/playback-sessions/{sessionID}`	`AssetVideoClient.revokeSession`	`None`	`{ revoked: boolean }`
`POST`	`/assets/{assetID}/versions/{versionID}/video/review`	`AssetVideoClient.review`	`{ decision: "approved" \| "rejected"; reason: string; }`	`{ reviewed: boolean }`
`GET`	`/assets/{assetID}/versions/{versionID}/video/captions`	`AssetVideoClient.captions`	`None`	`AssetVideoCaption[]`
`POST`	`/assets/{assetID}/versions/{versionID}/video/captions`	`AssetVideoClient.addCaption`	`AssetVideoCaptionInput`	`AssetVideoCaption`
`DELETE`	`/assets/{assetID}/versions/{versionID}/video/captions/{captionID}`	`AssetVideoClient.removeCaption`	`None`	`{ removed: boolean }`
`GET`	`/assets/{assetID}/video/analytics`	`AssetVideoClient.analytics`	`None`	`AssetPlaybackAnalytics`
`POST`	`/playback/assets/{assetID}/sessions`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/playback/media/{kind}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/playback/sessions/renew`	`AssetVideoClient.renewSession`	`{}`	`AssetPlaybackGrant`
`POST`	`/playback/events`	`AssetVideoClient.events`	`{ events: AssetPlaybackEvent[]; }`	`{ accepted: boolean }`
`POST`	`/assets/upload`	`AssetsClient.upload`	`{ file: Blob; options?: AssetUploadOptions }`	`Asset`
`POST`	`/assets/upload-sessions`	`AssetsClient.createUploadSession`	`AssetSignedUploadUrlOptions`	`AssetSignedUploadUrl`
`GET`	`/assets/upload-sessions/{sessionID}`	`AssetsClient.resumeUploadSession`	`string`	`AssetSignedUploadUrl`
`POST`	`/assets/upload-sessions/{sessionID}/complete`	`AssetsClient.completeUploadSession`	`string`	`Asset`
`DELETE`	`/assets/upload-sessions/{sessionID}`	`AssetsClient.cancelUploadSession`	`string`	`{ cancelled: boolean }`
`POST`	`/assets/upload-url`	`AssetsClient.signedUploadUrl`	`AssetSignedUploadUrlOptions`	`AssetSignedUploadUrl`
`POST`	`/assets/buckets`	`AssetsClient.createBucket`	`AssetBucketInput & { name: string }`	`AssetBucket`
`GET`	`/assets/buckets`	`AssetsClient.listBuckets`	`None`	`{ buckets: AssetBucket[] }`
`PUT`	`/assets/buckets/{bucketID}`	`AssetsClient.updateBucket`	`AssetBucketInput`	`AssetBucket`
`DELETE`	`/assets/buckets/{bucketID}`	`AssetsClient.deleteBucket`	`string`	`void`
`PUT`	`/assets/buckets/{bucketID}/storage`	`AssetStorageClient.configure`	`AssetStorageConfiguration`	`AssetBucket`
`POST`	`/assets/buckets/{bucketID}/relocations`	`AssetStorageClient.relocate`	`AssetRelocationInput`	`AssetMigration`
`POST`	`/assets/connections`	`AssetConnectionsClient.create`	`AssetConnectionInput`	`AssetConnection`
`GET`	`/assets/connections`	`AssetConnectionsClient.list`	`None`	`AssetConnectionListResult`
`GET`	`/assets/connections/{connectionID}`	`AssetConnectionsClient.get`	`string`	`AssetConnection`
`PATCH`	`/assets/connections/{connectionID}`	`AssetConnectionsClient.update`	`string`	`AssetConnection`
`POST`	`/assets/connections/{connectionID}/verify`	`AssetConnectionsClient.verify`	`string`	`AssetConnection`
`DELETE`	`/assets/connections/{connectionID}`	`AssetConnectionsClient.delete`	`string`	`{ deleted: boolean }`
`GET`	`/assets/s2-buckets`	`AssetStorageClient.listS2Buckets`	`None`	`AssetS2BucketListResult`
`POST`	`/assets/s2-buckets`	`AssetStorageClient.createS2Bucket`	`{ name: string; region: string; }`	`AssetS2Bucket`
`POST`	`/assets/migrations`	`AssetMigrationsClient.start`	`AssetMigrationInput`	`AssetMigration`
`GET`	`/assets/migrations`	`AssetMigrationsClient.list`	`{ limit?: number }`	`AssetMigrationListResult`
`GET`	`/assets/migrations/{migrationID}`	`AssetMigrationsClient.get`	`string`	`AssetMigration`
`POST`	`/assets/migrations/{migrationID}/cancel`	`AssetMigrationsClient.cancel`	`string`	`{ canceled: boolean }`
`POST`	`/assets/migrations/{migrationID}/items/{itemID}/retry`	`AssetMigrationsClient.retryItem`	`string`	`{ queued: boolean }`
`GET`	`/assets/migrations/{migrationID}/report`	`AssetMigrationsClient.report`	`string`	`AssetMigrationReport`
`POST`	`/assets/upload-capabilities`	`AssetUploadCapabilitiesClient.create`	`AssetUploadCapabilityInput`	`CreatedAssetUploadCapability`
`GET`	`/assets/policy`	`AssetsClient.getPolicy`	`None`	`AssetContentPolicy`
`PUT`	`/assets/policy`	`AssetsClient.updatePolicy`	`AssetContentPolicy`	`AssetContentPolicy`
`POST`	`/assets/transformations`	`AssetsClient.createTransformation`	`AssetNamedTransformInput`	`AssetTransformation`
`GET`	`/assets/transformations`	`AssetsClient.listTransformations`	`None`	`{ transformations: AssetTransformation[] }`
`POST`	`/assets/{assetID}/transforms`	`AssetsClient.materializeTransform`	`string`	`AssetJobSubmission`
`GET`	`/assets/{assetID}/derivatives`	`AssetsClient.derivatives`	`string`	`{ derivatives: AssetDerivedAsset[] }`
`POST`	`/assets/generations`	`AssetsClient.generate`	`AssetImageGenerationInput`	`AssetJobSubmission`
`GET`	`/assets/automation`	`AssetsClient.automation`	`None`	`import('./asset-workflows.js').AssetAutomationOverview`
`POST`	`/assets/mcp`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/workflows/catalog`	`AssetWorkflowsClient.catalog`	`None`	`{ nodes: AssetWorkflowNodeDefinition[]; templates: AssetWorkflowTemplate[] }`
`GET`	`/assets/workflows`	`AssetWorkflowsClient.list`	`None`	`AssetWorkflow[]`
`POST`	`/assets/workflows`	`AssetWorkflowsClient.create`	`{ name: string; description?: string; template_key?: string; definition?: AssetWorkflowDefinition; layout?: AssetWorkflowLayout; }`	`AssetWorkflow`
`GET`	`/assets/workflows/{workflowId}`	`AssetWorkflowsClient.get`	`string`	`AssetWorkflow`
`PUT`	`/assets/workflows/{workflowId}/draft`	`AssetWorkflowsClient.updateDraft`	`{ name: string; description?: string; definition: AssetWorkflowDefinition; layout: AssetWorkflowLayout; expected_revision: number; }`	`AssetWorkflow`
`POST`	`/assets/workflows/{workflowId}/validate`	`AssetWorkflowsClient.validate`	`string`	`AssetWorkflowValidation`
`POST`	`/assets/workflows/{workflowId}/publish`	`AssetWorkflowsClient.publish`	`number`	`AssetWorkflowVersion`
`POST`	`/assets/workflows/{workflowId}/activate`	`AssetWorkflowsClient.activate`	`{ versionId: string; expectedRevision: number }`	`void`
`POST`	`/assets/workflows/{workflowId}/run`	`AssetWorkflowsClient.run`	`{ version_id?: string; input?: unknown; idempotency_key?: string; }`	`AssetWorkflowRun`
`GET`	`/assets/workflows/{workflowId}/versions`	`AssetWorkflowsClient.versions`	`string`	`AssetWorkflowVersion[]`
`GET`	`/assets/workflows/{workflowId}/runs`	`AssetWorkflowsClient.runs`	`string`	`AssetWorkflowRun[]`
`GET`	`/assets/workflows/runs/{runId}`	`AssetWorkflowsClient.runDetail`	`string`	`{ run: AssetWorkflowRun; nodes: AssetWorkflowNodeExecution[] }`
`POST`	`/assets/workflows/runs/{runId}/cancel`	`AssetWorkflowsClient.cancelRun`	`string`	`AssetWorkflowRun`
`POST`	`/assets/workflows/runs/{runId}/retry`	`AssetWorkflowsClient.retryRun`	`string`	`AssetWorkflowRun`
`GET`	`/assets/workflows/approvals`	`AssetWorkflowsClient.approvals`	`AssetWorkflowApproval['status']`	`AssetWorkflowApproval[]`
`POST`	`/assets/workflows/approvals/{approvalId}/approve`	`AssetWorkflowsClient.approve`	`{ reason?: string; expires_at?: string; }`	`AssetWorkflowApproval`
`POST`	`/assets/workflows/approvals/{approvalId}/reject`	`AssetWorkflowsClient.reject`	`{ reason?: string; }`	`AssetWorkflowApproval`
`GET`	`/assets/workflows/connections`	`t.ListWorkflowHTTPConnections`	`None`	`AssetWorkflowHTTPConnection`
`POST`	`/assets/workflows/connections`	`AssetWorkflowsClient.connections`	`SDK request object`	`AssetWorkflowHTTPConnection[]`
`POST`	`/assets/workflows/connections/{connectionId}/credential/rotate`	`AssetWorkflowsClient.rotateConnectionCredential`	`AssetWorkflowHTTPCredentialInput`	`{ id: string; name: string; header: string; prefix?: string; revision: number }`
`POST`	`/assets/workflows/{workflowId}/inbound-hook/rotate`	`AssetWorkflowsClient.rotateInboundHook`	`string`	`{ hook: { id: string; workflow_id: string; secret_version: number; enabled: boolean }; token: string; secret: string }`
`POST`	`/assets/workflow-hooks/{token}`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`DELETE`	`/assets/transformations/{name}`	`AssetsClient.deleteTransformation`	`string`	`{ deleted: boolean }`
`POST`	`/assets/lifecycle-rules`	`AssetsClient.createLifecycleRule`	`{ name: string; prefix?: string; action: "delete" \| "expire_versions"; age_days: number; enabled?: boolean; }`	`AssetLifecycleRule`
`GET`	`/assets/lifecycle-rules`	`AssetsClient.listLifecycleRules`	`None`	`{ lifecycle_rules: AssetLifecycleRule[] }`
`DELETE`	`/assets/lifecycle-rules/{ruleID}`	`AssetsClient.deleteLifecycleRule`	`string`	`{ deleted: boolean }`
`POST`	`/assets/domains`	`AssetsClient.createDomain`	`string`	`AssetCustomDomain`
`GET`	`/assets/domains`	`AssetsClient.listDomains`	`None`	`{ domains: AssetCustomDomain[] }`
`POST`	`/assets/domains/{domainID}/verify`	`AssetsClient.verifyDomain`	`string`	`AssetCustomDomain`
`DELETE`	`/assets/domains/{domainID}`	`AssetsClient.deleteDomain`	`string`	`{ deleted: boolean }`
`GET`	`/assets/analytics`	`AssetsClient.analytics`	`None`	`AssetUsageSummary`
`GET`	`/assets/summary`	`AssetsClient.usageSummary`	`None`	`AssetUsageSummary`
`GET`	`/assets/events`	`AssetsClient.events`	`None`	`{ events: AssetEvent[]; total: number }`
`POST`	`/assets/webhooks`	`AssetsClient.createWebhook`	`{ url: string; eventTypes?: string[] }`	`{ webhook: AssetWebhook; secret: string }`
`GET`	`/assets/webhooks`	`AssetsClient.listWebhooks`	`None`	`{ webhooks: AssetWebhook[] }`
`DELETE`	`/assets/webhooks/{webhookID}`	`AssetsClient.deleteWebhook`	`string`	`{ deleted: boolean }`
`GET`	`/assets/webhooks/{webhookID}/deliveries`	`AssetsClient.listWebhookDeliveries`	`string`	`{ deliveries: AssetWebhookDelivery[] }`
`POST`	`/assets/webhook-deliveries/{deliveryID}/retry`	`AssetsClient.retryWebhookDelivery`	`string`	`AssetWebhookDelivery`
`POST`	`/assets/bulk`	`AssetsClient.bulk`	`{ action: "delete" \| "visibility" \| "add_tags"; items: { asset_id: string; revision: number; }[]; visibility?: string; tags?: string[]; idempotencyKey?: string; }`	`AssetJobSubmission`
`GET`	`/assets/collections`	`AssetsClient.collections`	`None`	`{ collections: AssetCollection[] }`
`POST`	`/assets/collections`	`AssetsClient.createCollection`	`{ name: string; description?: string; asset_ids?: string[]; }`	`AssetCollection`
`PUT`	`/assets/collections/{collectionID}`	`AssetsClient.updateCollection`	`{ name: string; description?: string; asset_ids?: string[]; }`	`AssetCollection`
`DELETE`	`/assets/collections/{collectionID}`	`AssetsClient.deleteCollection`	`string`	`{ deleted: boolean }`
`GET`	`/assets/saved-searches`	`AssetsClient.savedSearches`	`None`	`{ saved_searches: AssetSavedSearch[] }`
`POST`	`/assets/saved-searches`	`AssetsClient.saveSearch`	`{ name: string; filters: Record<string, unknown>; }`	`AssetSavedSearch`
`PUT`	`/assets/saved-searches/{searchID}`	`AssetsClient.updateSavedSearch`	`{ name: string; filters: Record<string, unknown>; }`	`AssetSavedSearch`
`DELETE`	`/assets/saved-searches/{searchID}`	`AssetsClient.deleteSavedSearch`	`string`	`{ deleted: boolean }`
`GET`	`/assets/ai/config`	`AssetsClient.getAIConfig`	`None`	`AssetAIAccountConfig`
`PUT`	`/assets/ai/config`	`AssetsClient.updateAIConfig`	`{ enabledActions: string[]; monthlySpendCapMicros: number }`	`AssetAIAccountConfig['policy']`
`GET`	`/assets/jobs/{jobID}`	`AssetsClient.job`	`string`	`AssetJob`
`POST`	`/assets/jobs/{jobID}/cancel`	`AssetsClient.cancelJob`	`string`	`AssetJob`
`GET`	`/assets`	`AssetsClient.list`	`AssetListOptions`	`AssetListResult`
`GET`	`/assets/{assetID}`	`AssetsClient.get`	`string`	`Asset`
`POST`	`/assets/{assetID}/text-extraction`	`AssetTextClient.start`	`AssetTextExtractionInput`	`AssetTextExtraction`
`GET`	`/assets/{assetID}/text-extraction`	`AssetTextClient.get`	`string`	`AssetTextExtraction`
`POST`	`/assets/text-extractions/{extractionID}/retry`	`AssetTextClient.retry`	`string`	`AssetTextExtraction`
`PATCH`	`/assets/{assetID}`	`AssetsClient.patch`	`AssetPatchInput`	`Asset`
`GET`	`/assets/{assetID}/ai`	`AssetsClient.ai`	`string`	`AssetAIInfo`
`POST`	`/assets/{assetID}/ai/analyze`	`AssetsClient.analyze`	`None`	`SDK response type`
`POST`	`/assets/{assetID}/moderation`	`AssetsClient.moderate`	`None`	`SDK response type`
`GET`	`/assets/{assetID}/transcript`	`AssetsClient.transcript`	`string`	`AssetTranscript`
`POST`	`/assets/{assetID}/transcript`	`AssetsClient.requestTranscript`	`None`	`SDK response type`
`POST`	`/assets/{assetID}/smart-crop`	`AssetsClient.requestSmartCrop`	`None`	`SDK response type`
`POST`	`/assets/{assetID}/background-remove`	`AssetsClient.requestBackgroundRemoval`	`None`	`SDK response type`
`GET`	`/assets/{assetID}/versions`	`AssetsClient.versions`	`string`	`{ versions: AssetVersion[] }`
`POST`	`/assets/{assetID}/branches`	`AssetsClient.createBranch`	`{ name: string; fromVersionId?: string }`	`AssetVersionBranch`
`POST`	`/assets/{assetID}/versions/{versionID}/restore`	`AssetsClient.restoreVersion`	`string`	`{ restored: boolean }`
`POST`	`/assets/{assetID}/branches/{branch}/promote`	`AssetsClient.promoteBranch`	`string`	`{ promoted: boolean }`
`DELETE`	`/assets/{assetID}`	`AssetsClient.delete`	`string`	`AssetJobSubmission`
`PUT`	`/assets/{assetID}/replace`	`AssetsClient.replace`	`{ file: Blob; options?: Pick<AssetUploadOptions, "cacheControl" \| "metadata"> }`	`Asset`
`POST`	`/assets/{assetID}/signed-url`	`AssetsClient.signedUrl`	`AssetSignedUrlOptions`	`AssetSignedUrl`
`POST`	`/assets/{assetID}/transform-url`	`AssetsClient.signedTransformUrl`	`AssetSignedTransformOptions`	`AssetSignedUrl`
`PUT`	`/assets/{assetID}/tags`	`AssetsClient.setTags`	`string`	`{ tags: string[]; revision: number }`
`PATCH`	`/assets/{assetID}/metadata`	`AssetsClient.patchMetadata`	`Record<string, unknown>`	`{ updated: boolean; revision: number }`
`POST`	`/assets/{assetID}/purge`	`AssetsClient.purge`	`string`	`{ purged: boolean; asset_id: string }`
`POST`	`/assets/widget/sessions`	`CapabilityUploadTransport.request`	`SDK request object`	`SignedSession`
`GET`	`/assets/widget/sessions/current`	`CapabilityUploadTransport.request`	`None`	`SessionStatus`
`PUT`	`/assets/widget/uploads/{sessionToken}/parts/{partNumber}`	`CapabilityUploadTransport.uploadPart`	`ChunkUploadSession`	`SDK response type`
`POST`	`/assets/widget/sessions/current/complete`	`CapabilityUploadTransport.complete`	`ChunkUploadSession`	`Asset`
`DELETE`	`/assets/widget/sessions/current`	`CapabilityUploadTransport.cancel`	`ChunkUploadSession`	`SDK response type`
`POST`	`/assets/widget/remote-url`	`CapabilityUploadTransport.ingestUrl`	`string`	`Asset`
`GET`	`/assets/spaces`	`AssetDAMClient.spaces`	`None`	`{spaces: AssetSpaceAccess[]}`
`GET`	`/assets/collaborators`	`AssetDAMClient.collaborators`	`None`	`{collaborators: AssetCollaborator[]}`
`POST`	`/assets/collaborators`	`AssetDAMClient.invite`	`{ email: string; actions: AssetAction[]; collection_id?: string; expires_at: string; }`	`AssetCollaborator`
`PUT`	`/assets/collaborators/{collaboratorID}`	`AssetDAMClient.updateCollaborator`	`{ actions: AssetAction[]; }`	`{saved: boolean}`
`DELETE`	`/assets/collaborators/{collaboratorID}`	`AssetDAMClient.revokeCollaborator`	`None`	`{saved: boolean}`
`POST`	`/assets/invitations/{invitationID}/accept`	`AssetDAMClient.acceptInvitation`	`None`	`AssetCollaborator`
`GET`	`/assets/metadata-schemas`	`AssetDAMClient.metadataSchemas`	`None`	`{schemas: AssetMetadataSchema[]}`
`POST`	`/assets/metadata-schemas`	`AssetDAMClient.createMetadataSchema`	`{ name: string; fields: AssetMetadataField[]; }`	`AssetMetadataSchema`
`PUT`	`/assets/metadata-schemas/{schemaID}`	`AssetDAMClient.updateMetadataSchema`	`{ name: string; fields: AssetMetadataField[]; }`	`AssetMetadataSchema`
`POST`	`/assets/metadata-schemas/{schemaID}/publish`	`AssetDAMClient.publishMetadataSchema`	`None`	`AssetMetadataSchema`
`GET`	`/assets/buckets/{bucketID}/governance`	`AssetDAMClient.bucketGovernance`	`None`	`AssetBucketGovernance`
`PUT`	`/assets/buckets/{bucketID}/governance`	`AssetDAMClient.saveBucketGovernance`	`Omit<AssetBucketGovernance, "bucket_id" \| "migrating">`	`AssetBucketGovernance`
`GET`	`/assets/{assetID}/metadata-editor`	`AssetDAMClient.metadataEditor`	`None`	`{fields: AssetMetadataField[]; metadata: Record<string, unknown>; revision: number; metadata_revision: number; can_edit: boolean}`
`GET`	`/assets/publications`	`AssetDAMClient.publications`	`None`	`{publications: AssetPublication[]; next_cursor: string}`
`POST`	`/assets/publications`	`AssetDAMClient.createPublication`	`AssetPublicationInput`	`AssetPublication`
`PUT`	`/assets/publications/{publicationID}`	`AssetDAMClient.updatePublication`	`AssetPublicationInput`	`AssetPublication`
`POST`	`/assets/publications/{publicationID}/{action}`	`AssetDAMClient.transitionPublication`	`{ note: string; }`	`AssetPublication`
`GET`	`/assets/publications/{publicationID}/resolve`	`AssetDAMClient.resolvePublication`	`None`	`AssetPublicationDelivery`
`GET`	`/assets/{assetID}/publication-renditions`	`AssetDAMClient.publicationRenditions`	`None`	`{renditions: AssetMediaReference[]}`
`GET`	`/assets/publications/{publicationID}/preview`	`AssetDAMClient.resolvePublication`	`None`	`AssetPublicationDelivery`
`POST`	`/assets/buckets/{bucketID}/governance/migrate`	`AssetDAMClient.migrateBucketGovernance`	`None`	`AssetBucketGovernance`
`POST`	`/assets/picker-capabilities`	`AssetDAMClient.createPickerCapability`	`AssetPickerCapabilityInput`	`{token: string; capability: AssetPickerCapability}`
`DELETE`	`/assets/picker-capabilities/{capabilityID}`	`AssetDAMClient.revokePickerCapability`	`None`	`{revoked: boolean}`
`GET`	`/assets/{assetID}/models`	`AssetDAMClient.models`	`None`	`{packages: AssetModelPackage[]; pilot_enabled: boolean; daily_jobs: number; rendering: AssetRenderingInfo}`
`POST`	`/assets/{assetID}/models`	`AssetDAMClient.estimateRender`	`{ operation: string; version_id: string; source_checksum: string; recipe: AssetRenderRecipe; outputs: AssetRenderOutput[]; variant_id?: string; variant_revision?: number; }`	`AssetRenderEstimate`
`GET`	`/assets/{assetID}/model-variants`	`AssetDAMClient.modelVariants`	`None`	`AssetModelVariant[]`
`POST`	`/assets/{assetID}/model-variants`	`AssetDAMClient.createModelVariant`	`AssetModelVariantInput`	`AssetModelVariant`
`PUT`	`/assets/{assetID}/model-variants/{variantID}`	`AssetDAMClient.updateModelVariant`	`AssetModelVariantInput`	`AssetModelVariant`
`DELETE`	`/assets/{assetID}/model-variants/{variantID}`	`AssetDAMClient.deleteModelVariant`	`None`	`{deleted: boolean}`
`POST`	`/assets/publications/{publicationID}/ar`	`AssetDAMClient.resolvePublicationAR`	`None`	`AssetPublicationDelivery`
`POST`	`/assets/publications/{publicationID}/ar-handoff`	`AssetDAMClient.createPublicationARHandoff`	`None`	`{handoff_url: string; expires_at: string}`
`GET`	`/assets/ar-handoff/{token}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/galleries`	`AssetDAMClient.galleries`	`None`	`{galleries: AssetGallery[]; next_cursor: string}`
`POST`	`/assets/galleries`	`AssetDAMClient.createGallery`	`{ name: string; entries: AssetGalleryEntryInput[]; }`	`AssetGallery`
`PUT`	`/assets/galleries/{galleryID}`	`AssetDAMClient.updateGallery`	`{ name: string; entries: AssetGalleryEntryInput[]; }`	`AssetGallery`
`POST`	`/assets/galleries/{galleryID}/{action}`	`AssetDAMClient.transitionGallery`	`None`	`AssetGallery`
`GET`	`/assets/galleries/{galleryID}/resolve`	`AssetDAMClient.resolveGallery`	`None`	`AssetGalleryDelivery`
`POST`	`/assets/galleries/{galleryID}/ar`	`AssetDAMClient.resolveGalleryAR`	`{ publication_id: string; }`	`AssetPublicationDelivery`
`POST`	`/assets/picker/search`	`pickerTransport.search`	`SDK request object`	`PickerPage`
`POST`	`/assets/picker/select`	`pickerTransport.select`	`SDK request object`	`{ items: PickerSelection[] }`
`GET`	`/assets/portals`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/portals`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`PUT`	`/assets/portals/{portalID}`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/portals/{portalID}/{action:publish\|withdraw\|grants}`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/proofs`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/proofs`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/proofs/{proofID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`PUT`	`/assets/proofs/{proofID}`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/proofs/{proofID}/decisions`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/proofs/{proofID}/comments`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/proofs/{proofID}/invitations`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/guest-grants`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`DELETE`	`/assets/guest-grants/{grantID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/insights`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`PUT`	`/assets/insights`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/player-profiles`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/player-profiles`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/player-profiles/{profileID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`PUT`	`/assets/player-profiles/{profileID}`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`DELETE`	`/assets/player-profiles/{profileID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/{assetID}/player-profile`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`PUT`	`/assets/{assetID}/player-profile`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/folders/move`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/folders`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/folders`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`DELETE`	`/assets/folders`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/samples`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/samples/{sampleID}/preview`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/samples/{sampleID}/copy`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/capabilities`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/moderation-reviews`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/moderation-reviews`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/moderation-reviews/{assetID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/integrations`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/integrations`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`DELETE`	`/assets/integrations/{integrationID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`GET`	`/assets/integrations/current`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/integrations/current`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`DELETE`	`/assets/integrations/current`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/webhooks/{webhookID}/test`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/generations/estimate`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/generations`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/generations/{requestID}/retry`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/generations/{requestID}/cancel`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/{assetID}/preview`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/{assetID}/studio/preview`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/{assetID}/derivatives/{outputID}/save`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`POST`	`/assets/{assetID}/derivatives/{outputID}/signed-url`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`
`GET`	`/assets/{assetID}/derivatives/{outputID}`	`Contract-only (no SDK wrapper)`	`None`	`SDK response type`
`POST`	`/assets/transformations/{name}/publish`	`Contract-only (no SDK wrapper)`	`SDK request object`	`SDK response type`

Error envelope

Non-2xx responses use the StackShift response envelope. Check success: false, then read the structured error value and HTTP status. SDK clients surface the status, code, message, and details through their native error type.

Examples

These static examples show the verified route and authentication boundary. Use the official SDK method shown in each heading so serialization and response unwrapping remain consistent with the contract.

`GET /assets/{assetID}/video`

curl -X GET "https://api.stackshift.cloud/api/v1/assets/example-id/video"   -H "Authorization: Bearer $STACKSHIFT_API_KEY"

The SDK serializes any supported query options for this operation. Response:

{
  "success": true,
  "data": {
    "renditions": [
      {
        "id": "example-id",
        "asset_id": "example-id",
        "source_checksum_sha256": "example",
        "kind": "hls",
        "profile": "example",
        "mime_type": "example",
        "size": 1,
        "width": 1,
        "height": 1,
        "status": "example",
        "created_at": "2026-08-03T00:00:00Z",
        "updated_at": "2026-08-03T00:00:00Z"
      }
    ],
    "admission_enabled": true
  }
}

`POST /assets/{assetID}/versions/{versionID}/video`

curl -X POST "https://api.stackshift.cloud/api/v1/assets/example-id/versions/example-id/video"   -H "Authorization: Bearer $STACKSHIFT_API_KEY"

The SDK serializes any supported query options for this operation. Response:

{
  "success": true,
  "data": {
    "id": "example-id",
    "asset_space_id": "example-id",
    "asset_id": "example-id",
    "version_id": "example-id",
    "source_checksum_sha256": "example",
    "recipe_hash": "example",
    "recipe": "example",
    "processor_revision": "example",
    "status": "queued",
    "phase": "example",
    "progress_percent": 1,
    "metadata": {
      "asset_id": "example-id",
      "duration_seconds": 1,
      "width": 1,
      "height": 1,
      "codec": "example",
      "bitrate": 1,
      "frame_rate": 1,
      "has_audio": true,
      "rotation": 1,
      "created_at": "2026-08-03T00:00:00Z",
      "updated_at": "2026-08-03T00:00:00Z"
    },
    "failure_code": "example",
    "created_at": "2026-08-03T00:00:00Z",
    "updated_at": "2026-08-03T00:00:00Z"
  }
}

Overview

API Reference

AI Sandboxes

Introduction

StackShift CLI

Getting Started

Assets

StackShift Mail

Durable Jobs

Projects

Applications

Workload Security

Stacks

Templates

WordPress

Ghost

Shopify Hosting

Nodes

Compute

Databases

Operations

Domains & Email

Terminal & Operations

Mobile Distribution

Team & Access

Billing

AI Features

S2 Object Storage

Infrastructure as Code

Settings

StackShift Support

Error envelope

Examples

`GET /assets/{assetID}/video`

`POST /assets/{assetID}/versions/{versionID}/video`

​Error envelope

​Examples

​GET /assets/{assetID}/video

​POST /assets/{assetID}/versions/{versionID}/video

Error envelope

Examples

`GET /assets/{assetID}/video`

`POST /assets/{assetID}/versions/{versionID}/video`