Catalog — API Reference

curl -sS "https://api.dev.dodil.io/v1/ignite/catalog/acme-corp?limit=50&filterSourceType=CATALOG_SOURCE_FUNCTION&filterTags=rag" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc ListCatalog(ListCatalogRequest) returns (ListCatalogResponse);
 
message ListCatalogRequest {
  string organization_name = 1;
  int32 limit = 2;
  string cursor = 3;
  repeated string filter_tags = 4;
  repeated string filter_category = 5;
  string filter_name_pattern = 6;
  string filter_input_modality = 7;
  optional CatalogSourceType filter_source_type = 8;   // FUNCTION (app) | MODEL
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "limit": 50,
    "filter_source_type": "CATALOG_SOURCE_FUNCTION",
    "filter_tags": ["rag"]
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/ListCatalog

{
  "items": [
    {
      "id": "acme-corp/search-knowledge-base",
      "name": "search-knowledge-base",
      "description": "Searches the knowledge base and returns relevant results",
      "tags": ["rag", "search"],
      "inputModality": "text",
      "app": { "runtime": "python", "mcpEnabled": true, "hasStreaming": false, "modelCount": 1 }
    }
  ],
  "nextCursor": "",
  "totalCount": "1"
}

message ListCatalogResponse {
  repeated CatalogItem items = 1;
  string next_cursor = 2;        // empty when no more pages
  uint32 total_count = 3;
}

# no auth required
curl -sS "https://api.dev.dodil.io/v1/ignite/public/catalog?limit=50&filterSourceType=CATALOG_SOURCE_MODEL"

rpc ListPublicCatalog(ListPublicCatalogRequest) returns (ListPublicCatalogResponse);
 
message ListPublicCatalogRequest {
  int32 limit = 1;
  string cursor = 2;
  repeated string filter_tags = 3;
  repeated string filter_category = 4;
  string filter_name_pattern = 5;
  string filter_input_modality = 6;
  optional CatalogSourceType filter_source_type = 7;
}

# no auth required
grpcurl \
  -d '{ "limit": 50, "filter_source_type": "CATALOG_SOURCE_MODEL" }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/ListPublicCatalog

# no auth required
curl -sS "https://api.dev.dodil.io/v1/ignite/public/catalog/kimi-k2-5"

rpc GetPublicCatalogDetail(CatalogDetailRequest) returns (CatalogDetailResponse);
 
message CatalogDetailRequest { string name = 1; }

# no auth required
grpcurl \
  -d '{ "name": "kimi-k2-5" }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/GetPublicCatalogDetail

{
  "id": "models/kimi-k2-5",
  "name": "kimi-k2-5",
  "description": "Long-context chat model",
  "category": ["chat"],
  "inputModality": "text",
  "model": {
    "family": "kimi",
    "provider": "moonshot",
    "task": "generation",
    "parameters": "1.5B",
    "contextWindow": "131072",
    "precision": "float16",
    "useCases": ["chat", "summarization"]
  }
}

message CatalogDetailResponse {
  string id = 1;
  string name = 2;
  string description = 3;
  repeated string tags = 4;
  repeated string category = 5;
  string author = 6;
  string input_modality = 7;
  int64 created_at_ms = 8;
  int64 updated_at_ms = 9;
  oneof detail {
    CatalogAppDetail   app   = 10;
    CatalogModelDetail model = 11;
  }
}
 
message CatalogAppDetail {
  string runtime = 1;
  string input_schema = 2;            // JSON Schema string
  string output_schema = 3;
  bool mcp_enabled = 4;
  map<string, string> labels = 5;
  repeated ConnectedModel models = 6;
  StreamingInfo streaming = 7;
  repeated AppExample examples = 8;
  repeated AppAsset assets = 9;
  repeated string related_apps = 10;
}
 
message CatalogModelDetail {
  string family = 1;
  string provider = 2;
  string license = 3;
  string architecture = 4;
  string input_schema = 5;            // executor input JSON Schema
  string output_spec = 6;             // e.g. {"type":"logits","labels":[...]}
  string task = 7;
  string parameters = 8;              // "1.5B", "66M"
  uint64 context_window = 9;
  string quantization = 10;           // "Q4_K_M", "INT8", "" = full precision
  string precision = 11;              // "float32" | "float16" | "int8"
  uint32 embedding_dim = 12;          // embedding models
  repeated string languages = 13;     // ISO 639-1 or "multilingual"
  repeated string use_cases = 14;
  string output_schema = 15;
  repeated IOExample examples = 16;
}

curl -sS "https://api.dev.dodil.io/v1/ignite/health"

rpc HealthCheck(HealthCheckServiceRequest) returns (HealthCheckServiceResponse);
 
message HealthCheckServiceRequest {}

grpcurl $IGNITE_GRPC dodil.ignite.v1.ComputeService/HealthCheck