ScaleODM API (0.1.0)

Download OpenAPI specification:

Kubernetes-native auto-scaling and load balancing for OpenDroneMap.

system

Health check

Returns service health status

Authorizations:
tokenAuthNone

Responses

Response samples

Content type
application/json
{}

server

Retrieves information about this node

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

Responses

Response samples

Content type
application/json
{}

Retrieves command line options for task processing

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

task

Cancels a task

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

Request Body schema: application/json
required
uuid
required
string

UUID of the task

Responses

Request samples

Content type
application/json
{
  • "uuid": "string"
}

Response samples

Content type
application/problem+json
{}

Gets the list of tasks

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Creates a new task

Creates a new task and places it at the end of the processing queue

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

header Parameters
set-uuid
string

Optional UUID to use for this task

Request Body schema: application/json
required
dateCreated
integer <int64>

Override creation timestamp (optional; defaults to current time when omitted)

name
string

Task name (optional; defaults to 'odm-project' if empty)

options
string

JSON array of processing options (optional; defaults to fast-orthophoto when empty)

readS3Path
required
string

S3 path (s3://bucket/path) to read imagery from

s3AccessKeyID
string

S3 access key ID (optional, for authenticated buckets)

s3Endpoint
string

Custom S3 endpoint (optional, for non-AWS S3 providers)

s3Region
string
Default: "us-east-1"

S3 region (default: us-east-1)

s3SecretAccessKey
string

S3 secret access key (optional, for authenticated buckets)

s3SessionToken
string

S3 session token (optional, for STS credentials)

skipPostProcessing
boolean
Default: false

Skip point cloud tiles generation (default: false)

webhook
string

Webhook URL (optional)

writeS3Path
string

S3 path (s3://bucket/path) to write final products to (default: readS3Path + 'output/')

zipurl
string

URL of zip file containing images (deprecated, use readS3Path)

Responses

Request samples

Content type
application/json
{
  • "dateCreated": 0,
  • "name": "string",
  • "options": "string",
  • "readS3Path": "string",
  • "s3AccessKeyID": "string",
  • "s3Endpoint": "string",
  • "s3Region": "us-east-1",
  • "s3SecretAccessKey": "string",
  • "s3SessionToken": "string",
  • "skipPostProcessing": false,
  • "webhook": "string",
  • "writeS3Path": "string",
  • "zipurl": "string"
}

Response samples

Content type
application/json

Removes a task and deletes all assets

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

Request Body schema: application/json
required
uuid
required
string

UUID of the task

Responses

Request samples

Content type
application/json
{
  • "uuid": "string"
}

Response samples

Content type
application/problem+json
{}

Restarts a task

Authorizations:
tokenAuthNone
query Parameters
token
string

Authentication token (optional)

Request Body schema: application/json
required
options
string

New options (optional)

uuid
required
string

UUID of the task

Responses

Request samples

Content type
application/json
{
  • "options": "string",
  • "uuid": "string"
}

Response samples

Content type
application/problem+json
{}

Download task output asset

Redirects to a pre-signed URL for downloading the asset directly from S3

Authorizations:
tokenAuthNone
path Parameters
uuid
required
string

UUID of the task

asset
required
string

Asset type (all.zip, orthophoto.tif, etc)

query Parameters
token
string

Authentication token (optional)

Responses

Response samples

Content type
application/json
"string"

Gets information about a task

Authorizations:
tokenAuthNone
path Parameters
uuid
required
string

UUID of the task

query Parameters
token
string

Authentication token (optional)

with_output
integer <int64>
Default: 0

Line number to start console output from

Responses

Response samples

Content type
application/json
{
  • "dateCreated": 0,
  • "imagesCount": 0,
  • "name": "string",
  • "options": [
    ],
  • "output": [
    ],
  • "processingTime": 0,
  • "progress": 0,
  • "status": 0,
  • "uuid": "string"
}

Retrieves console output

Authorizations:
tokenAuthNone
path Parameters
uuid
required
string

UUID of the task

query Parameters
token
string

Authentication token (optional)

line
integer <int64>
Default: 0

Line number to start from

Responses

Response samples

Content type
application/json
"string"