Drafts — API Reference

# `sourceCode` is base64-encoded source bytes (truncated placeholder below).
curl -sS -X POST "https://api.dev.dodil.io/v1/ignite/app/acme-corp/my-data-processor/draft" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "code": {
      "compile": {
        "runtime": { "rust": { "target": "RUST_COMPILATION_TARGET_NATIVE", "toolchainVersion": "1.82" } },
        "sourceCode": "dXNlIGlnbml0ZTo6cHJlbHVkZTo6Kjsg..."
      }
    }
  }'

rpc SaveDraft(SaveDraftRequest) returns (SaveDraftResponse);
 
message SaveDraftRequest {
  string organization_name = 1;
  string app_name = 2;
  CodeSource code = 3;                          // REQUIRED — compile vs image branch
  string input_schema = 4;                      // per-draft override; empty = inherit
  string output_schema = 5;
}
 
// Top-level oneof picks the deployment mode (no explicit mode field).
message CodeSource {
  oneof source {
    CompileSource compile = 1;                  // platform compiles your source
    ImageSource   image   = 2;                  // run/build an image
  }
}
 
// Compile path — runtime picks the compile pipeline.
message CompileSource {
  Runtime runtime = 1;                          // REQUIRED (python / rust / go / deno)
  oneof body {
    bytes source_code = 2;                      // single-file source, auto-wrapped
    bytes archive = 3;                          // multi-file ZIP or tar.gz
  }
  map<string, string> build_args = 4;
}
 
// Image path — supply an image, or build one from code/git.
message ImageSource {
  oneof variant {
    PrebuiltImage prebuilt  = 1;                // BYOI: image_ref + registry_secret_ref
    ImageFromCode from_code = 2;                // archive + dockerfile_path (empty → Buildpacks)
    ImageFromGit  from_git  = 3;                // url + reference + sub_path + dockerfile_path
  }
}

# Compile path. `sourceCode` / `archive` are bytes → base64 in JSON;
# the value below is a truncated placeholder for the real base64 blob.
grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "organization_name": "acme-corp",
    "app_name": "my-data-processor",
    "code": {
      "compile": {
        "runtime": { "rust": { "target": "RUST_COMPILATION_TARGET_NATIVE", "toolchain_version": "1.82" } },
        "source_code": "dXNlIGlnbml0ZTo6cHJlbHVkZTo6Kjsg..."
      }
    }
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/SaveDraft

{
  "draft": {
    "status": "VERSION_STATUS_DRAFT",
    "codeHash": "9f1c2a7e",
    "createdAtMs": "1716900000000",
    "codeKind": "CODE_KIND_SDK"
  }
}

message SaveDraftResponse {
  DraftInfo draft = 1;
}

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

rpc GetDraftInfo(GetDraftInfoRequest) returns (GetDraftInfoResponse);
 
message GetDraftInfoRequest {
  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/GetDraftInfo

{
  "draft": {
    "status": "VERSION_STATUS_DRAFT",
    "codeHash": "9f1c2a7e",
    "createdAtMs": "1716900000000",
    "lastDeploymentAtMs": "1716900300000",
    "runtime": { "rust": { "target": "RUST_COMPILATION_TARGET_NATIVE", "toolchainVersion": "1.82" } },
    "codeKind": "CODE_KIND_SDK"
  }
}

message GetDraftInfoResponse {
  DraftInfo draft = 1;                          // nil if no draft exists
}
 
message DraftInfo {
  VersionStatus status = 1;                     // DRAFT, COMPILING, or FAILED
  string deploy_id = 2;                         // set while compiling (StreamCompileLogs)
  string error = 3;                             // set when status is FAILED
  string code_hash = 4;
  int64 created_at_ms = 5;
  string image_ref = 6;                         // compiled image ref, after success
  int64 last_deployment_at_ms = 7;              // last successful compilation
  Runtime runtime = 8;                          // authoritative draft runtime
  DeploymentMode deployment_mode = 9;
  ResourceLimits limits = 10;
  ScalingConfig scaling = 11;
  CodeKind code_kind = 15;                      // source classification
}

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

rpc CompileDraft(CompileDraftRequest) returns (CompileDraftResponse);
 
message CompileDraftRequest {
  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/CompileDraft

{
  "draft": {
    "status": "VERSION_STATUS_COMPILING",
    "deployId": "deploy-7c3a91",
    "codeKind": "CODE_KIND_SDK"
  },
  "deployId": "deploy-7c3a91"
}

message CompileDraftResponse {
  DraftInfo draft = 1;
  string deploy_id = 2;                         // for StreamCompileLogs
}

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

rpc PublishDraft(PublishDraftRequest) returns (PublishDraftResponse);
 
message PublishDraftRequest {
  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/PublishDraft

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

message PublishDraftResponse {
  AppMeta app = 1;
  uint32 published_version = 2;                 // the new version number
}

# `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/draft/test" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "payload": "eyJuYW1lIjoid29ybGQifQ=="
  }'

rpc TestDraft(TestDraftRequest) returns (TestDraftResponse);
 
message TestDraftRequest {
  string organization_name = 1;
  string app_name = 2;
  bytes payload = 3;                            // 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",
    "payload": "eyJuYW1lIjoid29ybGQifQ=="
  }' \
  $IGNITE_GRPC \
  dodil.ignite.v1.ComputeService/TestDraft

{
  "executionId": "exec-3f9a12",
  "appId": "acme-corp/my-data-processor"
}

message TestDraftResponse {
  string execution_id = 1;
  string app_id = 2;
}