Apps — API Reference

curl -sS -X POST "https://api.dev.dodil.io/v1/ignite/app/acme-corp" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-data-processor",
    "resourceTier": "RESOURCE_TIER_MEDIUM",
    "description": "Parses a PDF and extracts structured text",
    "env": { "LOG_LEVEL": "info" }
  }'

rpc CreateApp(CreateAppRequest) returns (CreateAppResponse);
 
message CreateAppRequest {
  string organization_name = 1;
  string name = 2;                            // lowercase alphanumeric + hyphens, unique in org
  map<string, string> env = 3;
  ResourceLimits limits = 4;                  // overrides resource_tier if set
  ResourceTier resource_tier = 5;             // default SMALL
  ScalingConfig scaling = 6;
  StorageMode storage_mode = 7;
  uint32 ttl_seconds = 8;                     // when storage_mode = TTL
  string description = 9;                     // also the MCP tool description
  string input_schema = 10;                   // JSON Schema string
  string output_schema = 11;
  bool mcp_enabled = 12;                      // export as MCP tool after publish
  uint32 max_concurrency = 15;
  repeated uint32 ports = 16;                 // image-mode; default [80]
  CodeSource code = 19;                       // optional initial draft (CreateApp + SaveDraft)
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "name": "my-data-processor",
    "resource_tier": "RESOURCE_TIER_MEDIUM",
    "description": "Parses a PDF and extracts structured text",
    "env": { "LOG_LEVEL": "info" }
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/CreateApp

{
  "appId": "acme-corp/my-data-processor",
  "deploymentState": "DEPLOYMENT_STATE_CREATED",
  "appliedTier": "RESOURCE_TIER_MEDIUM",
  "appliedLimits": { "memoryMb": 512, "cpuMillicores": 500 }
}

message CreateAppResponse {
  string app_id = 1;                          // "org/name"
  DeploymentState deployment_state = 2;       // CREATED
  ResourceTier applied_tier = 3;
  ResourceLimits applied_limits = 4;
}

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetApp(GetAppRequest) returns (GetAppResponse);
 
message GetAppRequest {
  string organization_name = 1;
  string app_name = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/GetApp

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp?limit=50" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc ListApps(ListAppsRequest) returns (ListAppsResponse);
 
message ListAppsRequest {
  string organization_name = 1;
  int32 limit = 2;
  string cursor = 3;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "limit": 50
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/ListApps

{
  "apps": [
    { "id": "acme-corp/my-data-processor", "name": "my-data-processor", "activeVersion": 3, "deploymentState": "DEPLOYMENT_STATE_DEPLOYED" }
  ],
  "nextCursor": "",
  "totalCount": "1"
}

message ListAppsResponse {
  repeated AppMeta apps = 1;
  string next_cursor = 2;                     // empty when no more pages
  uint32 total_count = 3;
}

curl -sS -X PATCH "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/config" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "resourceTier": "RESOURCE_TIER_LARGE",
    "scaling": { "maxReplicas": 20, "scaleMetric": "SCALE_METRIC_CONCURRENCY", "scaleThreshold": 4 }
  }'

rpc UpdateAppConfig(UpdateAppConfigRequest) returns (UpdateAppConfigResponse);
 
message UpdateAppConfigRequest {
  string organization_name = 1;
  string app_name = 2;
  map<string, string> env = 3;                // replaces all env vars
  ResourceLimits limits = 4;
  ResourceTier resource_tier = 5;
  ScalingConfig scaling = 6;
  string description = 8;
  optional bool mcp_enabled = 11;
  optional uint32 max_concurrency = 16;
  DeploymentMode deployment_mode = 21;        // UNSPECIFIED = no change
  // ... clear_tags / clear_labels / clear_ports sentinels, git_source, registry_secret_ref
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor",
    "resource_tier": "RESOURCE_TIER_LARGE",
    "scaling": { "max_replicas": 20, "scale_metric": "SCALE_METRIC_CONCURRENCY", "scale_threshold": 4 }
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/UpdateAppConfig

curl -sS -X DELETE "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc DeleteApp(DeleteAppRequest) returns (DeleteAppResponse);
 
message DeleteAppRequest {
  string organization_name = 1;
  string app_name = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/DeleteApp

curl -sS "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/state" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetAppState(GetAppStateRequest) returns (GetAppStateResponse);
 
message GetAppStateRequest {
  string organization_name = 1;
  string app_name = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor"
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/GetAppState

{
  "appId": "acme-corp/my-data-processor",
  "deploymentState": "DEPLOYMENT_STATE_DEPLOYED",
  "lastInvokedAtMs": "1748390400000"
}

message GetAppStateResponse {
  string app_id = 1;
  DeploymentState deployment_state = 2;       // CREATED | DEPLOYED (after first publish)
  int64 last_invoked_at_ms = 3;
}