Local HTTP API exposed by Anaconda Desktop for model and inference-server management — list the model catalog, inspect and delete model files, track download status, and create, start, stop and delete local model servers. OpenAPI 3.0.0 with a bearer (UUID API key) scheme; runs on the developer's own machine so no servers[] host is published.
{
"openapi": "3.0.0",
"info": {
"title": "Desktop API",
"version": "1.0.0",
"description": "API documentation for Desktop"
},
"components": {
"securitySchemes": {
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "UUID",
"description": "Enter your API key here"
}
},
"schemas": {
"TrainedFor": {
"type": "string",
"enum": [
"text-generation",
"sentence-similarity"
],
"description": "The primary task the model was trained for"
},
"ModelFile": {
"type": "object",
"required": [
"id",
"name",
"downloadUrl",
"sizeBytes",
"sha256checksum",
"quantization",
"format",
"maxRamUsage"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the model file"
},
"name": {
"type": "string",
"description": "Name of the model file"
},
"downloadUrl": {
"type": "string",
"description": "URL to download the model file"
},
"sizeBytes": {
"type": "number",
"description": "Size of the model file in bytes"
},
"sha256checksum": {
"type": "string",
"description": "SHA-256 hash of the model file for integrity verification"
},
"quantization": {
"type": "string",
"description": "Quantization method used for the model"
},
"format": {
"type": "string",
"description": "File format of the model"
},
"isDownloaded": {
"type": "boolean",
"description": "Whether the model file has been downloaded locally"
},
"maxRamUsage": {
"type": "number",
"description": "Maximum RAM required to run the model in bytes"
},
"downloadStatus": {
"type": "object",
"description": "Information about the download status of the file",
"properties": {
"status": {
"type": "string",
"enum": [
"not_started",
"in_progress",
"paused",
"completed"
],
"description": "Current status of the download"
},
"progress": {
"$ref": "#/components/schemas/Download"
},
"localPath": {
"type": "string",
"description": "Local path where the file is stored (only when status is completed)"
}
}
}
}
},
"LocalModelFile": {
"allOf": [
{
"$ref": "#/components/schemas/ModelFile"
},
{
"type": "object",
"required": [
"localPath",
"isDownloaded"
],
"properties": {
"localPath": {
"type": "string",
"description": "Local file system path where the model is stored"
},
"isDownloaded": {
"type": "boolean",
"description": "Whether the model file has been downloaded"
}
}
}
]
},
"ModelSummary": {
"type": "object",
"required": [
"id",
"name",
"metadata"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the model"
},
"name": {
"type": "string",
"description": "Name of the model"
},
"metadata": {
"type": "object",
"required": [
"numParameters",
"trainedFor",
"description",
"quantizations"
],
"properties": {
"numParameters": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Number of parameters in the model (string for legacy models)"
},
"contextWindowSize": {
"type": "number",
"description": "Maximum context window size for the model"
},
"trainedFor": {
"type": "string",
"description": "Primary task the model was trained for"
},
"description": {
"type": "string",
"description": "Description of the model"
},
"quantizations": {
"type": "array",
"items": {
"type": "object",
"required": [
"modelFileName",
"method",
"sizeBytes",
"maxRamUsage"
],
"properties": {
"modelFileName": {
"type": "string",
"description": "Name of the model file"
},
"method": {
"type": "string",
"description": "Quantization method used"
},
"sizeBytes": {
"type": "number",
"description": "Size of the quantized model in bytes"
},
"maxRamUsage": {
"type": "number",
"description": "Maximum RAM usage of the quantized model"
}
}
}
}
}
}
}
},
"Model": {
"type": "object",
"required": [
"datePublished",
"publisher",
"name",
"id",
"resources",
"license",
"languages",
"library_name",
"trainedFor",
"numParameters",
"model_type",
"description",
"contextWindowSize",
"files"
],
"properties": {
"datePublished": {
"type": "string",
"format": "date-time",
"description": "Date when the model was published"
},
"publisher": {
"type": "string",
"description": "Publisher or organization that released the model"
},
"name": {
"type": "string",
"description": "Name of the model"
},
"id": {
"type": "string",
"description": "Unique identifier for the model"
},
"resources": {
"type": "object",
"required": [
"canonicalUrl"
],
"properties": {
"canonicalUrl": {
"type": "string",
"description": "Official URL for the model"
},
"paperUrl": {
"type": "string",
"description": "URL to the research paper associated with the model"
}
}
},
"license": {
"type": "string",
"description": "License under which the model is distributed"
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Languages supported by the model"
},
"library_name": {
"type": "string",
"description": "Library or framework the model is designed for"
},
"trainedFor": {
"$ref": "#/components/schemas/TrainedFor"
},
"numParameters": {
"type": "number",
"description": "Number of parameters in the model"
},
"model_type": {
"type": "string",
"description": "Type or architecture of the model"
},
"description": {
"type": "string",
"description": "Detailed description of the model"
},
"contextWindowSize": {
"type": "number",
"description": "Maximum context window size in tokens"
},
"files": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ModelFile"
},
"description": "Files associated with the model"
}
}
},
"LocalModel": {
"allOf": [
{
"type": "object",
"required": [
"datePublished",
"publisher",
"name",
"id",
"resources",
"license",
"languages",
"library_name",
"trainedFor",
"numParameters",
"model_type",
"description",
"files"
],
"properties": {
"datePublished": {
"type": "string",
"format": "date-time",
"description": "Date when the model was published"
},
"publisher": {
"type": "string",
"description": "Publisher or organization that released the model"
},
"name": {
"type": "string",
"description": "Name of the model"
},
"id": {
"type": "string",
"description": "Unique identifier for the model"
},
"resources": {
"type": "object",
"required": [
"canonicalUrl"
],
"properties": {
"canonicalUrl": {
"type": "string",
"description": "Official URL for the model"
},
"paperUrl": {
"type": "string",
"description": "URL to the research paper associated with the model"
}
}
},
"license": {
"type": "string",
"description": "License under which the model is distributed"
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Languages supported by the model"
},
"library_name": {
"type": "string",
"description": "Library or framework the model is designed for"
},
"trainedFor": {
"$ref": "#/components/schemas/TrainedFor"
},
"model_type": {
"type": "string",
"description": "Type or architecture of the model"
},
"description": {
"type": "string",
"description": "Detailed description of the model"
},
"numParameters": {
"oneOf": [
{
"type": "number"
},
{
"type": "string"
}
],
"description": "Number of parameters in the model (string for legacy models)"
},
"contextWindowSize": {
"type": "number",
"description": "Maximum context window size (optional for legacy models)"
},
"files": {
"type": "array",
"items": {
"$ref": "#/components/schemas/LocalModelFile"
},
"description": "Files associated with the model"
}
}
}
]
},
"Download": {
"type": "object",
"required": [
"fileId",
"modelId",
"filename",
"downloadedRatio",
"transferredBytes",
"totalBytes",
"paused",
"downloadTimeTaken",
"averageMbps"
],
"properties": {
"fileId": {
"type": "string",
"description": "ID of the file being downloaded"
},
"modelId": {
"type": "string",
"description": "ID of the model being downloaded"
},
"filename": {
"type": "string",
"description": "Name of the file being downloaded"
},
"downloadedRatio": {
"type": "number",
"description": "Percentage of download completion (0-1)"
},
"transferredBytes": {
"type": "number",
"description": "Number of bytes transferred"
},
"totalBytes": {
"type": "number",
"description": "Total size of the file in bytes"
},
"paused": {
"type": "boolean",
"description": "Whether the download is paused"
},
"downloadTimeTaken": {
"type": "number",
"description": "Time taken for download in milliseconds"
},
"averageMbps": {
"type": "number",
"description": "Average download speed in Mbps"
}
}
},
"DownloadAction": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"enum": [
"start",
"pause",
"resume"
],
"description": "Action to perform on the download"
}
}
},
"DownloadStatus": {
"type": "object",
"required": [
"data"
],
"properties": {
"data": {
"type": "object",
"required": [
"status"
],
"properties": {
"status": {
"type": "string",
"enum": [
"in_progress",
"paused",
"completed"
],
"description": "Current status of the download"
},
"progress": {
"$ref": "#/components/schemas/Download",
"description": "Download progress information (only when status is in_progress or paused)"
},
"localPath": {
"type": "string",
"description": "Local path where the file is stored (only when status is completed)"
}
}
}
}
},
"Error": {
"type": "object",
"properties": {
"error": {
"type": "object",
"properties": {
"code": {
"type": "string",
"enum": [
"INVALID_REQUEST",
"DATABASE_NOT_RUNNING",
"INTERNAL_SERVER_ERROR",
"INVALID_SERVER_ID",
"SERVER_NOT_RUNNING",
"SERVER_RUNNING",
"INTERNAL_SERVER_ERROR"
]
},
"message": {
"type": "string"
}
}
}
}
},
"Server": {
"type": "object",
"required": [
"serverConfig"
],
"properties": {
"serverConfig": {
"type": "object",
"required": [
"modelFileName"
],
"properties": {
"modelFileName": {
"type": "string"
},
"apiParams": {
"type": "object"
},
"loadParams": {
"type": "object"
},
"inferParams": {
"type": "object"
},
"logsDir": {
"type": "string"
}
}
},
"startServerOnCreate": {
"type": "boolean"
}
}
},
"ServerAction": {
"type": "object",
"required": [
"action"
],
"properties": {
"action": {
"type": "string",
"enum": [
"start",
"stop"
]
}
}
},
"ServerDetails": {
"type": "object",
"properties": {
"modelFile": {
"type": "object",
"description": "Details about the model file used by the server",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"localPath": {
"type": "string"
},
"isDownloaded": {
"type": "boolean"
},
"quantization": {
"type": "string"
}
}
},
"serverConfig": {
"type": "object",
"description": "Original server configuration",
"properties": {
"modelFileName": {
"type": "string"
},
"apiParams": {
"type": "object"
},
"loadParams": {
"type": "object"
},
"inferParams": {
"type": "object"
},
"logsDir": {
"type": "string"
}
}
},
"server": {
"type": "object",
"properties": {
"host": {
"type": "string"
},
"port": {
"type": "integer"
}
}
},
"tag": {
"type": "string",
"description": "Server tag (e.g., 'inference', 'embedding')"
},
"status": {
"type": "string",
"enum": [
"STARTING",
"RUNNING",
"STOPPING",
"STOPPED",
"ERROR"
]
},
"serverProcessId": {
"type": "integer",
"nullable": true
},
"id": {
"type": "string",
"description": "Unique server identifier"
}
}
}
}
},
"security": [
{
"bearerAuth": []
}
],
"paths": {
"/api/models/health": {
"get": {
"summary": "Check the health of the models API",
"tags": [
"Models"
],
"responses": {
"200": {
"description": "Models API is healthy",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"message": {
"type": "string",
"example": "/api/models/health ok"
}
}
}
}
}
}
}
}
}
}
},
"/api/models": {
"get": {
"summary": "Get all models",
"description": "Retrieves a list of models, either from the entire catalog or only those downloaded locally",
"tags": [
"Models"
],
"parameters": [
{
"in": "query",
"name": "downloaded",
"schema": {
"type": "boolean"
},
"description": "When true, returns only models that have at least one file downloaded locally"
}
],
"responses": {
"200": {
"description": "List of models retrieved successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ModelSummary"
}
}
}
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/models/{id}": {
"get": {
"summary": "Get model details by ID",
"description": "Retrieves detailed information about a specific model, including its metadata and files",
"tags": [
"Models"
],
"parameters": [
{
"in": "path",
"name": "id",
"required": true,
"schema": {
"type": "string"
},
"description": "ID of the model to retrieve"
}
],
"responses": {
"200": {
"description": "Model details retrieved successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the model"
},
"name": {
"type": "string",
"description": "Name of the model"
},
"metadata": {
"type": "object",
"properties": {
"numParameters": {
"type": "number",
"description": "Number of parameters in the model"
},
"contextWindowSize": {
"type": "number",
"description": "Maximum context window size in tokens"
},
"trainedFor": {
"$ref": "#/components/schemas/TrainedFor"
},
"description": {
"type": "string",
"description": "Detailed description of the model"
},
"license": {
"type": "string",
"description": "License under which the model is distributed"
},
"languages": {
"type": "array",
"items": {
"type": "string"
},
"description": "Languages supported by the model"
},
"last_updated": {
"type": "string",
"format": "date-time",
"description": "Date when the model was last updated"
},
"library_name": {
"type": "string",
"description": "Library or framework the model is designed for"
},
"model_type": {
"type": "string",
"description": "Type or architecture of the model"
},
"resources": {
"type": "object",
"properties": {
"canonicalUrl": {
"type": "string",
"description": "Official URL for the model"
},
"paperUrl": {
"type": "string",
"description": "URL to the research paper associated with the model"
}
}
},
"publisher": {
"type": "string",
"description": "Publisher or organization that released the model"
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the model file"
},
"name": {
"type": "string",
"description": "Name of the model file"
},
"downloadUrl": {
"type": "string",
"description": "URL to download the model file"
},
"sizeBytes": {
"type": "number",
"description": "Size of the model file in bytes"
},
"sha256checksum": {
"type": "string",
"description": "SHA-256 hash of the model file for integrity verification"
},
"quantization": {
"type": "string",
"description": "Quantization method used for the model"
},
"format": {
"type": "string",
"description": "File format of the model"
},
"maxRamUsage": {
"type": "number",
"description": "Maximum RAM required to run the model in bytes"
},
"isDownloaded": {
"type": "boolean",
"description": "Whether the model file has been downloaded locally"
},
"localPath": {
"type": "string",
"description": "Local file system path where the model is stored"
}
}
}
}
}
}
}
}
}
}
}
}
},
"404": {
"description": "Model not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/models/{modelId}/files": {
"get": {
"summary": "List all files for a specific model",
"tags": [
"Models",
"Files"
],
"parameters": [
{
"in": "path",
"name": "modelId",
"required": true,
"schema": {
"type": "string"
},
"description": "ID of the model"
},
{
"in": "query",
"name": "downloaded",
"schema": {
"type": "boolean"
},
"description": "Filter to only show downloaded files"
}
],
"responses": {
"200": {
"description": "List of model files retrieved successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/ModelFile"
}
}
}
}
}
}
},
"404": {
"description": "Model not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
}
},
"/api/models/{modelId}/files/{fileId}": {
"get": {
"summary": "Get details of a specific model file",
"tags": [
"Models",
"Files"
],
"parameters": [
{
"in": "path",
"name": "modelId",
"required": true,
"schema": {
"type": "string"
},
"description": "ID of the model"
},
{
"in": "path",
"name": "fileId",
"required": true,
"schema": {
"type": "string"
},
"description": "ID of the file"
}
],
"responses": {
"200": {
"description": "Model file details retrieved successfully",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"data": {
"$ref": "#/components/schemas/ModelFile"
}
}
}
}
}
},
"404": {
"description": "Model or file not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
},
"500": {
"description": "Internal server error",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/Error"
}
}
}
}
}
},
"patch": {
"summary": "Update download status of a model file",
"tags": [
"Models",
"Files"
],
"parameters": [
{
"in": "path",
"name": "modelId",
# --- truncated at 32 KB (47 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/anaconda/refs/heads/main/openapi/anaconda-desktop-openapi-original.json
This is an independent, third-party profile of Anaconda Desktop API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.