{ "components": { "schemas": { "Asset": { "description": "Asset model. It is used to represent an asset in asset library.", "properties": { "asset_type": { "$ref": "#/components/schemas/AssetType" }, "created_at": { "description": "Asset creation time.", "title": "Created At", "type": "string" }, "data": { "description": "Asset data. It shows the type of data for an asset.", "discriminator": { "mapping": { "checkpoint": "#/components/schemas/CheckpointData", "file": "#/components/schemas/FileData", "latent": "#/components/schemas/LatentData", "lora": "#/components/schemas/LoraData", "textual_inversion": "#/components/schemas/TextualInversionData", "vae": "#/components/schemas/VAEData" }, "propertyName": "asset_type" }, "oneOf": [ { "$ref": "#/components/schemas/FileData" }, { "$ref": "#/components/schemas/CheckpointData" }, { "$ref": "#/components/schemas/LoraData" }, { "$ref": "#/components/schemas/TextualInversionData" }, { "$ref": "#/components/schemas/VAEData" }, { "$ref": "#/components/schemas/LatentData" } ], "title": "Data" }, "description": { "description": "Asset description. It is used to provide more information.", "title": "Description", "type": "string" }, "file_structure": { "allOf": [ { "$ref": "#/components/schemas/FileStructure" } ], "default": "single_file", "description": "File structure." }, "hf_repo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Hugging Face repository.", "title": "Hf Repo" }, "id": { "description": "Asset id. A unique identifier for the asset.", "title": "Id", "type": "string" }, "is_public": { "default": false, "description": "True if asset is public.", "title": "Is Public", "type": "boolean" }, "name": { "description": "Asset name. A unique name for the asset.", "title": "Name", "type": "string" }, "size_bytes": { "description": "Asset size in bytes.", "format": "int64", "title": "Size Bytes", "type": "integer" }, "status": { "allOf": [ { "$ref": "#/components/schemas/Status" } ], "description": "Asset status. It shows the current status of the asset in asset library." }, "status_details": { "description": "Asset status details.", "title": "Status Details", "type": "string" }, "status_info": { "default": {}, "description": "Asset status info. Provides extra information about the asset.", "title": "Status Info", "type": "object" }, "tenant_uuid": { "description": "Asset tenant ID. This is unique for each OctoAI user.", "format": "uuid", "title": "Tenant Uuid", "type": "string" }, "url": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "null" } ], "description": "A unique URL for the asset.", "title": "Url" } }, "required": [ "id", "asset_type", "name", "description", "size_bytes", "status", "status_details", "created_at", "data", "tenant_uuid" ], "title": "Asset", "type": "object" }, "AssetType": { "description": "Asset type. It is used to distinguish between different supported assets.", "enum": [ "file", "checkpoint", "lora", "textual_inversion", "vae", "latent" ], "title": "AssetType", "type": "string" }, "BaseEngine": { "description": "Base Engine names supported by asset library.", "enum": [ "text/llama-2-7b", "text/llama-2-13b", "text/llama-2-70b", "text/llama-3-8b", "text/llama-3-70b", "text/codellama-7b", "text/codellama-13b", "text/codellama-34b", "text/codellama-70b", "text/mistral-7b", "text/mistral-nemo", "text/mixtral-8x7b", "text/llama-3.1-8b", "text/llama-3.1-70b", "text/llama-3.1-405b", "image/controlnet-sd15", "image/controlnet-sdxl", "image/stable-diffusion-v1-5", "image/stable-diffusion-xl-v1-0", "image/stable-diffusion-v3-medium", "image/stable-diffusion-ssd", "image/flux-dev", "image/flux-schnell", "audio/tortoise-tts", "audio/rvc", "video/svd" ], "title": "BaseEngine", "type": "string" }, "BaseEngineType": { "description": "Base Engine types supported by asset library.", "enum": [ "text", "image", "audio", "video" ], "title": "BaseEngineType", "type": "string" }, "CheckpointData": { "description": "Data class for `checkpoint` asset type.", "properties": { "asset_type": { "const": "checkpoint", "default": "checkpoint", "description": "Asset type. It is used to distinguish between different supported assets.", "title": "Asset Type" }, "data_type": { "allOf": [ { "$ref": "#/components/schemas/DataType" } ], "default": "fp16", "description": "Data type." }, "engine": { "allOf": [ { "$ref": "#/components/schemas/BaseEngine" } ], "description": "Engine type." }, "file_format": { "allOf": [ { "$ref": "#/components/schemas/FileFormat" } ], "default": "safetensors", "description": "File format." } }, "required": [ "engine" ], "title": "CheckpointData", "type": "object" }, "CompleteAssetUploadRequest": { "description": "Complete asset upload request.", "properties": { "skip_validation": { "default": false, "description": "Skip asset validation.", "title": "Skip Validation", "type": "boolean" }, "token": { "default": "", "deprecated": true, "description": "Unused. User OctoAI token.", "title": "Token", "type": "string" } }, "title": "CompleteAssetUploadRequest", "type": "object" }, "CompleteAssetUploadResponse": { "description": "Complete asset upload response.", "properties": { "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Error message in asset upload.", "title": "Error" } }, "title": "CompleteAssetUploadResponse", "type": "object" }, "CreateAssetRequest": { "description": "Create asset request.\nIt is used to represent the request of create asset API.", "properties": { "asset_type": { "$ref": "#/components/schemas/AssetType" }, "data": { "description": "Asset data. It shows the type of data for an asset.", "discriminator": { "mapping": { "checkpoint": "#/components/schemas/CheckpointData", "file": "#/components/schemas/FileData", "latent": "#/components/schemas/LatentData", "lora": "#/components/schemas/LoraData", "textual_inversion": "#/components/schemas/TextualInversionData", "vae": "#/components/schemas/VAEData" }, "propertyName": "asset_type" }, "oneOf": [ { "$ref": "#/components/schemas/FileData" }, { "$ref": "#/components/schemas/CheckpointData" }, { "$ref": "#/components/schemas/LoraData" }, { "$ref": "#/components/schemas/TextualInversionData" }, { "$ref": "#/components/schemas/VAEData" }, { "$ref": "#/components/schemas/LatentData" } ], "title": "Data" }, "description": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Asset description. It is used to provide more information.", "title": "Description" }, "hf_repo": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "HuggingFace repository.", "title": "Hf Repo" }, "hf_token_secret": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "OctoAI secret name for HuggingFace token.", "title": "Hf Token Secret" }, "is_public": { "default": false, "description": "True if asset is public.", "title": "Is Public", "type": "boolean" }, "name": { "description": "Asset name. A unique name for the asset.", "title": "Name", "type": "string" }, "skip_validation": { "default": false, "description": "Skip asset validation.", "title": "Skip Validation", "type": "boolean" }, "transfer_api_type": { "allOf": [ { "$ref": "#/components/schemas/TransferApiType" } ], "default": "presigned-url", "description": "Transfer API type." }, "url": { "anyOf": [ { "format": "uri", "maxLength": 2083, "minLength": 1, "type": "string" }, { "type": "null" } ], "description": "Upload the contents of the url as the asset.", "title": "Url" } }, "required": [ "asset_type", "name", "description", "data" ], "title": "CreateAssetRequest", "type": "object" }, "CreateAssetResponse": { "description": "Create asset response.\nIt is used to represent the response of create asset API.", "properties": { "asset": { "allOf": [ { "$ref": "#/components/schemas/Asset" } ], "description": "Asset." }, "token": { "default": "", "deprecated": true, "description": "Unused. Present for compatibility purposes.", "title": "Token", "type": "string" }, "transfer_api": { "description": "Asset transfer API type.", "discriminator": { "mapping": { "gcp-oauth": "#/components/schemas/GcsOauthTransferApi", "none": "#/components/schemas/NoTransferApi", "presigned-url": "#/components/schemas/PresignedUrlTransferApi", "sts": "#/components/schemas/StsTransferApi" }, "propertyName": "type" }, "oneOf": [ { "$ref": "#/components/schemas/PresignedUrlTransferApi" }, { "$ref": "#/components/schemas/StsTransferApi" }, { "$ref": "#/components/schemas/GcsOauthTransferApi" }, { "$ref": "#/components/schemas/NoTransferApi" } ], "title": "Transfer Api" } }, "required": [ "asset", "transfer_api" ], "title": "CreateAssetResponse", "type": "object" }, "DataType": { "description": "Data type for the asset.", "enum": [ "fp16", "fp32", "int4", "int8" ], "title": "DataType", "type": "string" }, "DeleteAssetResponse": { "description": "Delete asset response.", "properties": { "deleted_at": { "description": "Asset deletion time.", "title": "Deleted At", "type": "string" }, "id": { "description": "Unique ID for this asset.", "title": "Id", "type": "string" } }, "required": [ "id", "deleted_at" ], "title": "DeleteAssetResponse", "type": "object" }, "FileData": { "description": "Data class for `file` asset type.", "properties": { "asset_type": { "const": "file", "default": "file", "description": "Asset type. It is used to distinguish between different supported assets.", "title": "Asset Type" }, "file_format": { "allOf": [ { "$ref": "#/components/schemas/FileExtension" } ], "default": "unknown", "description": "File format." }, "preview_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Preview URL for this asset.", "title": "Preview Url" }, "version": { "default": "", "description": "Asset version. Default value is empty.", "title": "Version", "type": "string" } }, "title": "FileData", "type": "object" }, "FileExtension": { "description": "File extension supported for the asset.", "enum": [ "unknown", "png", "jpg", "jpeg", "txt", "mp3", "wav", "jsonl" ], "title": "FileExtension", "type": "string" }, "FileFormat": { "description": "File format for the asset.", "enum": [ "safetensors", "pt" ], "title": "FileFormat", "type": "string" }, "FileStructure": { "description": "File structure for the asset.", "enum": [ "unknown", "single_file", "multiple_files" ], "title": "FileStructure", "type": "string" }, "GcsOauthTransferApi": { "description": "STS asset transfer API.", "properties": { "gcp_region": { "description": "GCP region. Used for asset transfer.", "title": "Gcp Region", "type": "string" }, "gs_bucket": { "description": "GS bucket. Used for asset transfer.", "title": "Gs Bucket", "type": "string" }, "gs_key": { "description": "GS key. Used for asset transfer.", "title": "Gs Key", "type": "string" }, "gs_url": { "description": "GS full URL. Used for asset transfer.", "title": "Gs Url", "type": "string" }, "token": { "description": "GCS oauth token. Used for asset transfer.", "title": "Token", "type": "string" }, "type": { "const": "gcp-oauth", "default": "gcp-oauth", "description": "URL type for the asset.", "title": "Type" } }, "required": [ "gcp_region", "token", "gs_bucket", "gs_key", "gs_url" ], "title": "GcsOauthTransferApi", "type": "object" }, "HTTPValidationError": { "description": "HTTP validation error in API.", "properties": { "detail": { "description": "Detail of the http validation error.", "items": { "$ref": "#/components/schemas/ValidationError" }, "title": "Detail", "type": "array" } }, "title": "HTTPValidationError", "type": "object" }, "LatentData": { "description": "Data class for `latent` asset type.", "properties": { "asset_type": { "const": "latent", "default": "latent", "description": "Asset type. It is used to distinguish between different supported assets.", "title": "Asset Type" }, "engine": { "allOf": [ { "$ref": "#/components/schemas/BaseEngine" } ], "description": "Engine type." }, "file_format": { "allOf": [ { "$ref": "#/components/schemas/FileFormat" } ], "default": "safetensors", "description": "File format." } }, "required": [ "engine" ], "title": "LatentData", "type": "object" }, "ListAssetsResponse": { "description": "List assets response.", "properties": { "data": { "description": "List of retrieved assets.", "items": { "$ref": "#/components/schemas/Asset" }, "title": "Data", "type": "array" }, "has_more": { "description": "True if there are more asset to show.", "title": "Has More", "type": "boolean" }, "total": { "description": "Total number of assets.", "title": "Total", "type": "integer" } }, "required": [ "has_more", "total", "data" ], "title": "ListAssetsResponse", "type": "object" }, "LoraData": { "description": "Data class for `lora` asset type.", "properties": { "asset_type": { "const": "lora", "default": "lora", "description": "Asset type. It is used to distinguish between different supported assets.", "title": "Asset Type" }, "checkpoint": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Base checkpoint used with LoRA.", "title": "Checkpoint" }, "data_type": { "allOf": [ { "$ref": "#/components/schemas/DataType" } ], "default": "fp16", "description": "Data type." }, "engine": { "allOf": [ { "$ref": "#/components/schemas/BaseEngine" } ], "description": "Engine type." }, "file_format": { "allOf": [ { "$ref": "#/components/schemas/FileFormat" } ], "default": "safetensors", "description": "File format." }, "trigger_words": { "anyOf": [ { "items": { "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Trigger words used for tuning.", "title": "Trigger Words" } }, "required": [ "engine" ], "title": "LoraData", "type": "object" }, "NoTransferApi": { "description": "Type to avoid Optional[TransferApi] so openapi-generator can work.\n\nIn this class, type is not added to TransferApiType because it is not a valid\nTransferApiType. It exists only to note that no TransferApi is defined.", "properties": { "type": { "const": "none", "default": "none", "description": "URL type for the asset.", "title": "Type" } }, "title": "NoTransferApi", "type": "object" }, "PresignedUrlTransferApi": { "description": "Presigned URL asset transfer API.", "properties": { "get_url": { "description": "Get asset URL. Used to download the asset.", "title": "Get Url", "type": "string" }, "put_url": { "description": "Asset URL to upload.", "title": "Put Url", "type": "string" }, "type": { "const": "presigned-url", "default": "presigned-url", "description": "URL type for the asset.", "title": "Type" } }, "required": [ "get_url", "put_url" ], "title": "PresignedUrlTransferApi", "type": "object" }, "RetrieveAssetResponse": { "description": "Retrieve asset response.", "properties": { "asset": { "allOf": [ { "$ref": "#/components/schemas/Asset" } ], "description": "Asset." }, "transfer_api": { "description": "Transfer API used to retrieve the asset.", "discriminator": { "mapping": { "gcp-oauth": "#/components/schemas/GcsOauthTransferApi", "none": "#/components/schemas/NoTransferApi", "presigned-url": "#/components/schemas/PresignedUrlTransferApi", "sts": "#/components/schemas/StsTransferApi" }, "propertyName": "type" }, "oneOf": [ { "$ref": "#/components/schemas/PresignedUrlTransferApi" }, { "$ref": "#/components/schemas/StsTransferApi" }, { "$ref": "#/components/schemas/GcsOauthTransferApi" }, { "$ref": "#/components/schemas/NoTransferApi" } ], "title": "Transfer Api" } }, "required": [ "asset", "transfer_api" ], "title": "RetrieveAssetResponse", "type": "object" }, "Status": { "description": "Status of an asset in asset library.", "enum": [ "ready_to_upload", "uploaded", "ready", "deleted", "rejected", "error", "uploading" ], "title": "Status", "type": "string" }, "StsTransferApi": { "description": "STS asset transfer API.", "properties": { "aws_access_key_id": { "description": "AWS access key. Used for asset transfer.", "title": "Aws Access Key Id", "type": "string" }, "aws_region": { "description": "AWS region. Used for asset transfer.", "title": "Aws Region", "type": "string" }, "aws_secret_access_key": { "description": "AWS secret access key.", "title": "Aws Secret Access Key", "type": "string" }, "aws_session_token": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "AWS session token. Used for asset transfer.", "title": "Aws Session Token" }, "s3_bucket": { "description": "S3 bucket. Used for asset transfer.", "title": "S3 Bucket", "type": "string" }, "s3_endpoint_url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "S3 endpoint URL. Used for asset transfer.", "title": "S3 Endpoint Url" }, "s3_key": { "description": "S3 key. Used for asset transfer.", "title": "S3 Key", "type": "string" }, "s3_url": { "description": "S3 full URL. Used for asset transfer.", "title": "S3 Url", "type": "string" }, "type": { "const": "sts", "default": "sts", "description": "URL type for the asset.", "title": "Type" } }, "required": [ "aws_region", "aws_access_key_id", "aws_secret_access_key", "s3_bucket", "s3_key", "s3_url" ], "title": "StsTransferApi", "type": "object" }, "TextualInversionData": { "description": "Data class for `textual_inversion` asset type.", "properties": { "asset_type": { "const": "textual_inversion", "default": "textual_inversion", "description": "Asset type. It is used to distinguish between different supported assets.", "title": "Asset Type" }, "data_type": { "allOf": [ { "$ref": "#/components/schemas/DataType" } ], "default": "fp16", "description": "Data type." }, "engine": { "allOf": [ { "$ref": "#/components/schemas/BaseEngine" } ], "description": "Engine type." }, "file_format": { "allOf": [ { "$ref": "#/components/schemas/FileFormat" } ], "default": "safetensors", "description": "File format." }, "trigger_words": { "default": [], "description": "Trigger words using for tuning.", "items": { "type": "string" }, "title": "Trigger Words", "type": "array" } }, "required": [ "engine" ], "title": "TextualInversionData", "type": "object" }, "TransferApiType": { "description": "Asset transfer API types.", "enum": [ "presigned-url", "sts", "gcp-oauth", "any" ], "title": "TransferApiType", "type": "string" }, "VAEData": { "description": "Data class for `vae` asset type.", "properties": { "asset_type": { "const": "vae", "default": "vae", "description": "Asset type. It is used to distinguish between different supported assets.", "title": "Asset Type" }, "data_type": { "allOf": [ { "$ref": "#/components/schemas/DataType" } ], "default": "fp16", "description": "Data type." }, "engine": { "allOf": [ { "$ref": "#/components/schemas/BaseEngine" } ], "description": "Engine type." }, "file_format": { "allOf": [ { "$ref": "#/components/schemas/FileFormat" } ], "default": "safetensors", "description": "File format." } }, "required": [ "engine" ], "title": "VAEData", "type": "object" }, "ValidationError": { "description": "Validation error in API.", "properties": { "loc": { "description": "Error location in ValidationError.", "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "title": "Location", "type": "array" }, "msg": { "description": "Error message in ValidationError.", "title": "Message", "type": "string" }, "type": { "description": "Error type in ValidationError.", "title": "Error Type", "type": "string" } }, "required": [ "loc", "msg", "type" ], "title": "ValidationError", "type": "object" } } }, "info": { "description": "Asset Library API", "title": "asset-library-api", "version": "0.1" }, "openapi": "3.1.0", "paths": { "/v1/assets": { "get": { "description": "List assets with optional filtering.", "operationId": "list_assets_v1_assets_get", "parameters": [ { "description": "Filter based on asset name.", "in": "query", "name": "name", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter based on asset name.", "title": "Name" } }, { "description": "Filter based on asset visibility.", "in": "query", "name": "is_public", "required": false, "schema": { "default": false, "description": "Filter based on asset visibility.", "title": "Is Public", "type": "boolean" } }, { "description": "Filter based on data type.", "in": "query", "name": "data_type", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/DataType" }, { "type": "null" } ], "description": "Filter based on data type.", "title": "Data Type" } }, { "description": "Filter based on engine type.", "in": "query", "name": "asset_type", "required": false, "schema": { "description": "Filter based on engine type.", "items": { "$ref": "#/components/schemas/AssetType" }, "title": "Asset Type", "type": "array" } }, { "description": "Filter based on engine.", "in": "query", "name": "engine", "required": false, "schema": { "description": "Filter based on engine.", "items": { "$ref": "#/components/schemas/BaseEngine" }, "title": "Engine", "type": "array" } }, { "description": "Filter based on engine type.", "in": "query", "name": "engine_type", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/BaseEngineType" }, { "type": "null" } ], "description": "Filter based on engine type.", "title": "Engine Type" } }, { "description": "Max number of assets to return.", "in": "query", "name": "limit", "required": false, "schema": { "default": 100, "description": "Max number of assets to return.", "maximum": 100, "minimum": 1, "title": "Limit", "type": "integer" } }, { "description": "Offset to start listing assets.", "in": "query", "name": "offset", "required": false, "schema": { "default": 0, "description": "Offset to start listing assets.", "minimum": 0, "title": "Offset", "type": "integer" } }, { "description": "Include preview URLs for assets.", "in": "query", "name": "get_preview_urls", "required": false, "schema": { "default": false, "description": "Include preview URLs for assets.", "title": "Get Preview Urls", "type": "boolean" } }, { "description": "Filter based on asset IDs.", "in": "query", "name": "asset_ids", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter based on asset IDs.", "title": "Asset Ids" } }, { "description": "Filter based on asset owener.", "in": "query", "name": "owner", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "description": "Filter based on asset owener.", "title": "Owner" } }, { "description": "Filter based on file format.", "in": "query", "name": "file_format", "required": false, "schema": { "description": "Filter based on file format.", "items": { "anyOf": [ { "$ref": "#/components/schemas/FileFormat" }, { "$ref": "#/components/schemas/FileExtension" } ] }, "title": "File Format", "type": "array" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListAssetsResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "List Assets", "tags": [ "assets" ] }, "post": { "description": "Create an asset on the asset library.", "operationId": "create_asset_v1_assets_post", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAssetRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAssetResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Create Asset", "tags": [ "assets" ] } }, "/v1/assets/{asset_id}": { "delete": { "description": "Delete an asset from the asset library.", "operationId": "delete_asset_v1_assets__asset_id__delete", "parameters": [ { "description": "The asset unique ID.", "in": "path", "name": "asset_id", "required": true, "schema": { "description": "The asset unique ID.", "title": "Asset Id", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteAssetResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Delete Asset", "tags": [ "assets" ] } }, "/v1/assets/{asset_id}/complete-upload": { "post": { "description": "Complete the upload of an asset.", "operationId": "complete_asset_upload_v1_assets__asset_id__complete_upload_post", "parameters": [ { "description": "The asset unique ID.", "in": "path", "name": "asset_id", "required": true, "schema": { "description": "The asset unique ID.", "title": "Asset Id", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompleteAssetUploadRequest" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompleteAssetUploadResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Complete Asset Upload", "tags": [ "assets" ] } }, "/v1/assets/{asset_owner_and_name_or_id}": { "get": { "description": "Retrieve asset with the given owner and name or id.", "operationId": "retrieve_asset_v1_assets__asset_owner_and_name_or_id__get", "parameters": [ { "description": "Owner and name or id of the asset.", "in": "path", "name": "asset_owner_and_name_or_id", "required": true, "schema": { "description": "Owner and name or id of the asset.", "title": "Asset Owner And Name Or Id", "type": "string" } }, { "description": "Type of transfer API to generate.", "in": "query", "name": "transfer_api_type", "required": false, "schema": { "anyOf": [ { "$ref": "#/components/schemas/TransferApiType" }, { "type": "null" } ], "default": "presigned-url", "description": "Type of transfer API to generate.", "title": "Transfer Api Type" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RetrieveAssetResponse" } } }, "description": "Successful Response" }, "422": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } }, "description": "Validation Error" } }, "summary": "Retrieve Asset", "tags": [ "assets" ] } } }, "servers": [ { "url": "https://api.octoai.cloud" }, { "url": "" } ] }