---
updatedAt: 2026-09-11T18:32:36.000Z
agentTools:
  projectIndex: https://docs.canopy.umbra.space/llms.txt
---

# Feasibility Requests

## What is Feasibility Request

A Feasibility Request is the process of evaluating whether a Task, with your specified parameters, could be scheduled on the Umbra constellation. A Feasibility Request uses the same parameters as a Task - such as timeframe, imaging mode, and geometric constraints - but rather than creating a Task, it determines when those parameters can be satisfied by an Umbra satellite.

When you submit a Feasibility Request, Canopy checks your inputs against the constellation’s schedule and returns Opportunities: feasible time windows when a satellite should be able to fulfill your request. A Task can then be created based on an Opportunity.

<Callout icon="👍" theme="okay">
  **Competitive Feasibility**
  The Opportunities returned from Canopy's Feasibility Requests reflect the actual availability on the constellation schedule at the time of the request.
</Callout>

***

## Feasibility Lifecycle

A Feasibility progresses through a short lifecycle:

* `RECEIVED`: The request has been validated and is being evaluated.
* `COMPLETED`: The evaluation is finished and Opportunities are available.
* `ERROR`: The request could not be satisfied due to invalid inputs or constraints that cannot be met.

Once a Feasibility reaches `COMPLETED`, the Opportunities it contains can be used to inform the creation of a Task.

***

## Opportunities

An Opportunity is a window of time in which the Umbra constellation can image a target. Each Opportunity specifies:

* A start and end time
* Duration
* View geometry parameters (e.g., grazing angle, squint, slant range,
  azimuth)

Opportunities are returned as part of a Feasibility and can be used to create a Task.

***

## Submit a Feasibility Request

<Callout icon="📘" theme="info">
  Feasibility results are retained by the scheduler for five minutes after creation. To ensure you receive results, request the feasibility by its ID within that window (GET /feasibilities/id). After five minutes the scheduler may no longer return results.
</Callout>

For practical details on how to submit a Feasibility Request and work with Opportunities via the API or UI, see [Task Lifecycle API Guide](https://docs.canopy.umbra.space/docs/task-lifecycle-tutorial).

<br />