Versions — API Reference

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

rpc ListAppVersions(ListAppVersionsRequest) returns (ListAppVersionsResponse);
 
message ListAppVersionsRequest {
  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/ListAppVersions

{
  "versions": [
    {
      "version": 4,
      "codeHash": "9f1c2a7e",
      "createdAtMs": "1716900300000",
      "status": "VERSION_STATUS_ACTIVE",
      "resourceTier": "RESOURCE_TIER_MEDIUM",
      "runtime": { "rust": { "target": "RUST_COMPILATION_TARGET_NATIVE", "toolchainVersion": "1.82" } }
    },
    {
      "version": 3,
      "codeHash": "1b8e4d02",
      "createdAtMs": "1716800000000",
      "status": "VERSION_STATUS_SUPERSEDED"
    }
  ]
}

message ListAppVersionsResponse {
  repeated AppVersionInfo versions = 1;
}
 
message AppVersionInfo {
  uint32 version = 1;
  string code_uri = 2;
  int64 created_at_ms = 3;
  string code_hash = 4;
  VersionStatus status = 5;                     // ACTIVE, SUPERSEDED, DRAFT, COMPILING, FAILED
  string error = 6;                             // set when status is FAILED
  string input_schema = 7;                      // version-specific schema
  string output_schema = 8;
  ResourceTier resource_tier = 9;               // config snapshot at publish time
  ResourceLimits limits = 10;
  ScalingConfig scaling = 11;
  Runtime runtime = 12;
  string image_ref = 14;                        // compiled / built image ref
}

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

rpc GetAppVersion(GetAppVersionRequest) returns (GetAppVersionResponse);
 
message GetAppVersionRequest {
  string organization_name = 1;
  string app_name = 2;
  uint32 version = 3;                           // version number to retrieve
}

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

curl -sS -X POST "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/rollback" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "targetVersion": 3
  }'

rpc RollbackApp(RollbackAppRequest) returns (RollbackAppResponse);
 
message RollbackAppRequest {
  string organization_name = 1;
  string app_name = 2;
  uint32 target_version = 3;                    // version number to roll back to
}

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

{
  "app": { "id": "acme-corp/my-data-processor", "name": "my-data-processor", "activeVersion": 3 }
}

message RollbackAppResponse {
  AppMeta app = 1;                              // active_version now = target
}

# `payload` is the JSON input, base64-encoded (here: {"name":"world"}).
curl -sS -X POST "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/versions/5/test" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "eyJuYW1lIjoid29ybGQifQ=="
  }'

rpc TestAppVersion(TestAppVersionRequest) returns (TestAppVersionResponse);
 
message TestAppVersionRequest {
  string organization_name = 1;
  string app_name = 2;
  uint32 version = 3;                           // version to test (must be DRAFT)
  bytes payload = 4;                            // JSON-encoded input → base64 in JSON
}

# `payload` is the JSON input, base64-encoded (here: {"name":"world"}).
grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor",
    "version": 5,
    "payload": "eyJuYW1lIjoid29ybGQifQ=="
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/TestAppVersion

{
  "executionId": "exec-8b21cd",
  "appId": "acme-corp/my-data-processor",
  "version": 5
}

message TestAppVersionResponse {
  string execution_id = 1;
  string app_id = 2;
  uint32 version = 3;
}

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

rpc GetAppCode(GetAppCodeRequest) returns (GetAppCodeResponse);
 
message GetAppCodeRequest {
  string organization_name = 1;
  string app_name = 2;
  uint32 version = 3;                           // 0 = current/latest
}

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

{
  "codeFormat": "CODE_FORMAT_INTERNAL_SOURCE",
  "version": 4,
  "codeHash": "9f1c2a7e",
  "files": [
    {
      "path": "src/main.rs",
      "content": "dXNlIGlnbml0ZTo6cHJlbHVkZTo6Kjsg...",
      "isBinary": false,
      "sizeBytes": "412"
    }
  ]
}

message GetAppCodeResponse {
  CodeFormatInternal code_format = 1;           // SOURCE, ZIPPED, WASM_BINARY, PREBUILT_IMAGE, …
  uint32 version = 2;
  string code_hash = 3;
  repeated CodeFile files = 4;
}
 
message CodeFile {
  string path = 1;                              // e.g. "handler.py", "src/main.rs"
  bytes content = 2;                            // file content → base64 in JSON
  bool is_binary = 3;                           // true if not UTF-8 displayable
  uint64 size_bytes = 4;
}