How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Umbra Tasks API

The Tasks API from Umbra — 5 operation(s) for tasks.

Umbra Tasks API is one of 15 APIs that Umbra publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Task. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

This API exposes 5 operations across 5 paths, and defines 48 schemas. It is described by OpenAPI 3.2.0, at version 3.13.0.

Requests are made against 2 base URLs: https://api.canopy.umbra.space/tasking, https://api.canopy.prod.umbra-sandbox.space/tasking.

5 operations 5 paths 48 schemas 1 GET1 PATCH3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
3.13.0
Base URL
https://api.canopy.umbra.space/tasking
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Umbra Tasks API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (JWT) (bearerAuth). By default, every request must be authenticated.

Paths & Operations 5

Across 5 paths, the API surfaces 5 operations — 1 GET, 1 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Tasks 5
POST
/tasks
Create Task
create_task body → 201422
PATCH
/tasks/{id}/cancel
Cancel Task
cancel_task 1 param → 204422
GET
/tasks/{id}
Get Task
get_task 1 param → 200422
POST
/tasks/search
Post Search Tasks
post_search_tasks body → 200422
POST
/tasks/archive-tasks
Archive Tasks
create_archive_tasks body → 201422

Schemas 48

The contract defines 48 schemas that model the data the API accepts and returns. The most detailed are TaskProperties (25 properties), PostSearchTasksQueryModel (15 properties), CommercialTaskRequest (13 properties), Contract (13 properties). Each schema is shown below with its type and property counts.

ResellableTaskProductType
string
CommercialTaskRequest
object
13 properties 4 required
PostSearchTasksRequest
object
4 properties 1 required
PaginatedFeatureCollection_Task_
object
3 properties 2 required
Deramp
string
SearchQueryFilterEnum_TaskType_
object
1 property
ArchiveResellFailureResponseItem
object
3 properties 3 required
SortDirection
string
Sort direction
SearchQueryFilterEnum_TaskStatus_
object
1 property
Point
object
Point Model
3 properties 2 required
MultiPolygon
object
MultiPolygon Model
3 properties 2 required
TaskProductType
string
See https://docs.canopy.umbra.space/docs/delivered-product-types for details.
TaskStatus
string
See https://docs.canopy.umbra.space/docs/taskingtask-status for details.
LineString
object
LineString Model
3 properties 2 required
TaskStatusHistory
object
2 properties 1 required
Task
object
A reservation for an Opportunity that will generate one or more Collects It is not necessary to first generate an Opportunity. A Task can be specified with a b…
5 properties 2 required
PolarizationEnum
string
The first letter indicates the orientation of the wave as it is transmitted. The second letter indicates how the wave is filtered when received.
TaskType
string
TaskType
ValidationError
object
5 properties 3 required
Position3D
array
ArchiveResellSuccessResponseItem
object
11 properties 11 required
GeometryCollection-Input
object
GeometryCollection Model
3 properties 2 required
SceneSize
string
The requested Spotlight Scene Size in kilometers.
SearchQueryFilterGeometry
object
1 property
SortByField
object
2 properties 2 required
MultiLineString
object
MultiLineString Model
3 properties 2 required
ArchiveResellRequest
object
Request model for public-facing archive resell requests
2 properties 1 required
SpotlightConstraintsResponse
object
10 properties 1 required
ArchiveResellRequestItem
object
Request model for a single archive resell item
5 properties 1 required
ScanConstraintsResponse
object
7 properties 1 required
SearchQueryFilterArray
object
2 properties
Polygon
object
Polygon Model
3 properties 2 required
Contract
object
Contract model for Canopy Admin /contracts/{contractid} response. Here we define only a subset of fields on the contract that are relevant for commercial taski…
13 properties 13 required
Context
object
Contextual information provided to API consumers
3 properties 3 required
SpotlightConstraints
object
10 properties 1 required
SearchQueryFilterEnum_ImagingMode_
object
1 property
ArchiveResellResponse
object
Response model for public-facing archive resell requests
2 properties 2 required
HTTPValidationError
object
1 property
ScanConstraints
object
7 properties 1 required
PostSearchTasksQueryModel
object
15 properties
Position2D
array
MultiPoint
object
MultiPoint Model
3 properties 2 required
SearchQueryFilterUUID
object
2 properties
TaskProperties
object
The properties for a Task.
25 properties 11 required
ImagingMode
string
The Imaging Mode for the Task
SearchQueryFilterString
object
5 properties
GeometryCollection-Output
object
GeometryCollection Model
3 properties 2 required
SearchQueryFilterValue
object
6 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

umbra-tasks-api-openapi.yml Raw ↑

Other APIs Umbra publishes across the network.

Umbra Canopy Documentation MCP Server
Umbra Client Credentials API
Umbra Collections API
Umbra Collect Metadata API
Umbra Collects API
Umbra Delivery Config API
Umbra Feasibility API
Umbra Organizations API
Umbra Preview API
Umbra Preview Image API
Umbra Product Constraints API
Umbra Restricted Access Areas API
Where this information came from

This is an independent, third-party profile of Umbra Tasks API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.