Sources — API Reference

curl -sS -X POST "https://k3.dev.dodil.io/kb-prod/sources" \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bucket": "kb-prod",
    "provider": "SOURCE_PROVIDER_GOOGLE_DRIVE",
    "name": "finance-drive",
    "description": "Q2 finance docs",
    "rootPath": "/Q2",
    "providerAccount": "drive-id-123",
    "syncIntervalSeconds": "3600",
    "enabled": true
  }'

rpc CreateSource(CreateSourceRequest) returns (Source);
 
message CreateSourceRequest {
  string bucket = 1;
  SourceProvider provider = 2;
  string name = 3;
  string description = 4;
  string root_path = 5;
  string provider_account = 6;
  int64 sync_interval_seconds = 7;
  bool enabled = 8;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "bucket": "kb-prod",
    "provider": "SOURCE_PROVIDER_GOOGLE_DRIVE",
    "name": "finance-drive",
    "description": "Q2 finance docs",
    "root_path": "/Q2",
    "provider_account": "drive-id-123",
    "sync_interval_seconds": "3600",
    "enabled": true
  }' \
  $K3_GRPC \
  dodil.k3.source.v1.SourceService/CreateSource

curl -sS "https://k3.dev.dodil.io/kb-prod/sources/src_a1b2..." \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc GetSource(GetSourceRequest) returns (Source);
 
message GetSourceRequest {
  string bucket = 1;
  string source_id = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "bucket": "kb-prod",
    "source_id": "src_a1b2..."
  }' \
  $K3_GRPC \
  dodil.k3.source.v1.SourceService/GetSource

curl -sS "https://k3.dev.dodil.io/kb-prod/sources?page_size=50" \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc ListSources(ListSourcesRequest) returns (ListSourcesResponse);
 
message ListSourcesRequest {
  string bucket = 1;
  dodil.k3.common.v1.PaginationRequest pagination = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "bucket": "kb-prod",
    "pagination": { "page_size": 50 }
  }' \
  $K3_GRPC \
  dodil.k3.source.v1.SourceService/ListSources

{
  "sources": [
    {
      "sourceId": "src_a1b2…",
      "bucket": "kb-prod",
      "provider": "SOURCE_PROVIDER_INTERNAL_S3",
      "name": "internal",
      "syncIntervalSeconds": "0",
      "enabled": true,
      "status": "SOURCE_STATUS_ACTIVE"
    },
    {
      "sourceId": "src_c3d4…",
      "bucket": "kb-prod",
      "provider": "SOURCE_PROVIDER_GOOGLE_DRIVE",
      "name": "finance-drive",
      "syncIntervalSeconds": "3600",
      "enabled": true,
      "status": "SOURCE_STATUS_ACTIVE"
    }
  ],
  "pagination": { "nextPageToken": "", "totalCount": "2" }
}

message ListSourcesResponse {
  repeated Source sources = 1;
  dodil.k3.common.v1.PaginationResponse pagination = 2;
}

curl -sS -X PATCH "https://k3.dev.dodil.io/kb-prod/sources/src_a1b2..." \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bucket": "kb-prod",
    "sourceId": "src_a1b2...",
    "syncIntervalSeconds": "1800",
    "enabled": true
  }'

rpc UpdateSource(UpdateSourceRequest) returns (Source);
 
message UpdateSourceRequest {
  string bucket = 1;
  string source_id = 2;
  optional string name = 3;
  optional string description = 4;
  optional string root_path = 5;
  optional int64 sync_interval_seconds = 6;
  optional bool enabled = 7;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "bucket": "kb-prod",
    "source_id": "src_a1b2...",
    "sync_interval_seconds": "1800",
    "enabled": true
  }' \
  $K3_GRPC \
  dodil.k3.source.v1.SourceService/UpdateSource

curl -sS -X DELETE "https://k3.dev.dodil.io/kb-prod/sources/src_a1b2..." \
  -H "Authorization: Bearer $DODIL_TOKEN"

rpc DeleteSource(DeleteSourceRequest) returns (DeleteSourceResponse);
 
message DeleteSourceRequest {
  string bucket = 1;
  string source_id = 2;
}

grpcurl \
  -H "Authorization: Bearer $DODIL_TOKEN" \
  -d '{
    "bucket": "kb-prod",
    "source_id": "src_a1b2..."
  }' \
  $K3_GRPC \
  dodil.k3.source.v1.SourceService/DeleteSource