Skip to content

Delete a field

DELETE
/v1/fields/{id}
curl --request DELETE \
--url https://api.agrosat.uz/v1/fields/cmgz7k2qv0004l8p3a9d1x6rt \
--header 'X-API-Key: <X-API-Key>'

Removes the field from every later response. Its area stays consumed until a new contract period starts. Costs no units.

id
required
string

Example

cmgz7k2qv0004l8p3a9d1x6rt

Field id returned by registration

Deleted; no body

X-API-Key is missing, unknown, revoked or expired, or the API is not enabled.

Media typeapplication/json
object
success
required
boolean
error
required
object
code
required
string
Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error
message
required

English text; may change, branch on code

string
existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Exampleinvalid_api_key

invalid_api_key

{
"success": false,
"error": {
"code": "invalid_api_key",
"message": "Missing or invalid API key."
}
}

No such field in your organization

Media typeapplication/json
object
success
required
boolean
error
required
object
code
required
string
Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error
message
required

English text; may change, branch on code

string
existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Examplefield_not_found

field_not_found

{
"success": false,
"error": {
"code": "field_not_found",
"message": "Field not found."
}
}

Over the per-key request rate. Not billed.

Media typeapplication/json
object
success
required
boolean
error
required
object
code
required
string
Allowed values: invalid_api_key rate_limited field_not_found invalid_geometry field_too_large duplicate_geometry external_id_conflict quota_exceeded invalid_index source_not_enabled invalid_date_range date_out_of_range no_imagery_for_date data_pending invalid_request not_found internal_error
message
required

English text; may change, branch on code

string
existing_field_id

Field already holding this external_id or geometry (409 only)

string

Examples

Examplerate_limited

rate_limited

{
"success": false,
"error": {
"code": "rate_limited",
"message": "Rate limit exceeded."
}
}
Retry-After
integer
Example
30

Seconds to wait before repeating the request