# Create a new plot

Creates a new plot based on the given geojson and metadata

Endpoint: POST /plots/make_plot
Version: 3.0.1

## Header parameters:

  - `Authorization` (string)
    Authorization header with a Bearer token, formatted as 'Bearer [JWT]' where [JWT] is the JSON Web Token used for user authentication and authorization.
    Example: "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.your-payload-here.signature"

## Request fields (application/json):

  - `geojson` (object, required)
    GeoJSON representation of the plot's geographical data
    Example: {"type":"FeatureCollection","features":[{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[20.01750003723791,-0.03010959663886581],[20.01857837976968,-0.029779656058593673],[20.01958831997618,-0.031143678695514154],[20.018349030798674,-0.03160640023472183],[20.017491989905864,-0.03011764397074046]]]}}]}

  - `geojson.type` (string, required)
    Example: "FeatureCollection"

  - `geojson.features` (array, required)
    A list of GeoJson Features that this FeatureCollection is made of
    Example: [{"type":"Feature","geometry":{"type":"Polygon","coordinates":[[[20.01750003723791,-0.03010959663886581],[20.01857837976968,-0.029779656058593673],[20.01958831997618,-0.031143678695514154],[20.018349030798674,-0.03160640023472183],[20.017491989905864,-0.03011764397074046]]]}}]

  - `geojson.features.geometry` (any, required)
    Geometry object defining the spatial aspect of the feature, can be either Point or Polygon

  - `geojson.features.properties` (object)
    Additional properties for the feature as key-value pairs. Optional properties include point_ha (float < 4.0)
    Example: {"point_ha":3.5}

  - `geojson.features.type` (string, required)
    Type of the GeoJSON feature
    Example: "Feature"

  - `harvest_date` (string)
    The harvest date of the plot and the end date of analysis, in the format yyyy-MM-dd; if not provided here, it must be specified when executing the job
    Example: "2023-11-01"

  - `commodity` (string)
    The commodity type planted in the plot for analysis; if not provided here, it must be specified when executing the job
    Enum: "wood", "soy", "cocoa", "coffee", "palm_oil", "beef", "rubber"

  - `plot_name` (string)
    Name assigned to the plot
    Example: "My sustainable plot"

  - `notes` (string)
    Additional notes related to the plot
    Example: "GeoJSON needs to be revised"

  - `additional_info` (object)
    Additional information as key-value pairs
    Example: {"previous_risk_assessment":"high","urgency":"low"}

## Response 200 fields (application/json):

  - `username` (string)
    Username of the account that created the plot, the plot owner
    Example: "jdoe"

  - `country` (string)
    Country where the plot is located
    Example: "United States"

  - `state` (string)
    State or region where the plot is located
    Example: "California"

  - `notes` (string)
    Additional notes related to the plot
    Example: "This plot requires frequent irrigation."

  - `analysis` (object)
    Complete analysis data for a plot

  - `analysis.analysisEnd` (string)
    End date of the analysis
    Example: "2024-02-29"

  - `analysis.analysis_end` (string)
    End date of the analysis
    Example: "2024-02-29"

  - `analysis.risk_level` (string)
    Risk level assessment
    Example: "Low"

  - `analysis.forest_percentage_2020` (number)
    Forest percentage in 2020
    Example: 93.07

  - `analysis.indigenous_land` (object)
    Analysis of indigenous lands overlapping with a plot

  - `analysis.indigenous_land.indigenous_land_overlap_summary` (object)
    Summary of indigenous land overlap with plot

  - `analysis.indigenous_land.indigenous_land_overlap_summary.indigenous_land_overlap` (boolean, required)
    Indicates if the plot overlaps with any indigenous land

  - `analysis.indigenous_land.indigenous_land_overlap_summary.total_overlap_percentage` (number)
    Percentage of plot area that overlaps with indigenous land
    Example: 25.3

  - `analysis.indigenous_land.indigenous_land_overlap_summary.total_overlap_area_ha` (number)
    Plot area (in hectares) that overlaps with indigenous land
    Example: 155.3

  - `analysis.indigenous_land.indigenous_land_details` (array)
    Detailed information about each overlapping indigenous land

  - `analysis.indigenous_land.indigenous_land_details.id` (string, required)
    Unique identifier of the indigenous land
    Example: "IL-202"

  - `analysis.indigenous_land.indigenous_land_details.name` (string)
    Name of the indigenous land
    Example: "Yanomami Territory"

  - `analysis.indigenous_land.indigenous_land_details.government_acknowledged` (boolean)
    Acknowledgment of government
    Example: true

  - `analysis.indigenous_land.indigenous_land_details.overlap_area_ha` (number)
    Overlap area in hectares
    Example: 3.1

  - `analysis.indigenous_land.indigenous_land_details.land_status` (string)
    Status of the land, e.g. 'Community'
    Example: "Community"

  - `analysis.indigenous_land.sources` (array)
    Sources of indigenous land data

  - `analysis.indigenous_land.sources.source_name` (string, required)
    Name of the data source
    Example: "CNUC"

  - `analysis.indigenous_land.sources.data_version` (string)
    Version or date of the data
    Example: "2024-11-20"

  - `analysis.logging_area` (number)
    Logging area in hectares
    Example: 1.08

  - `analysis.forest_area_2020` (number)
    Forest area in 2020 in hectares
    Example: 145.31

  - `analysis.risk_reason` (string)
    Reason for risk assessment
    Example: "Low: Low deforestation detection"

  - `analysis.version` (string)
    Version of the analysis
    Example: "2024-11-13"

  - `analysis.areaHa` (number)
    Total area in hectares
    Example: 156.13

  - `analysis.protected_areas` (object)
    Analysis of protected areas overlapping with a plot

  - `analysis.protected_areas.protected_area_overlap_summary` (object)
    Summary of protected area overlap with plot

  - `analysis.protected_areas.protected_area_overlap_summary.protected_area_overlap` (boolean, required)
    Indicates if the plot overlaps with any protected area

  - `analysis.protected_areas.protected_area_overlap_summary.total_overlap_percentage` (number)
    Percentage of plot area that overlaps with protected areas
    Example: 25.3

  - `analysis.protected_areas.protected_area_overlap_summary.total_overlap_area_ha` (number)
    Plot area (in hectares) that overlaps with protected areas
    Example: 155.3

  - `analysis.protected_areas.protected_area_overlap_summary.most_restrictive_extractive_activity_legality` (string)
    Legality status of the most restrictive extractive activities of all the extractive activities returned with the protected areas
    Example: "prohibited"

  - `analysis.protected_areas.protected_area_details` (array)
    Detailed information about each overlapping protected area

  - `analysis.protected_areas.protected_area_details.area_id` (string, required)
    Unique identifier of the protected area
    Example: "37514"

  - `analysis.protected_areas.protected_area_details.area_name` (string)
    Name of the protected area
    Example: "Cordillera Beata"

  - `analysis.protected_areas.protected_area_details.local_name` (string)
    Local name of the protected area
    Example: "Cordillera Beata"

  - `analysis.protected_areas.protected_area_details.source_name` (string)
    Source/authority providing the protected area data
    Example: "Parques Nacionales Naturales de Colombia"

  - `analysis.protected_areas.protected_area_details.iucn_category` (string)
    IUCN protected area category
    Enum: "Ia", "Ib", "II", "III", "IV", "V", "VI"

  - `analysis.protected_areas.protected_area_details.overlap_area_ha` (number)
    Area of overlap in hectares
    Example: 2208.6384

  - `analysis.protected_areas.protected_area_details.extractive_activity_legality` (string)
    Legality status of extractive activities within the protected area
    Example: "limited"

  - `analysis.protected_areas.protected_area_details.extractive_activity_conditions` (string)
    Conditions or notes describing what extractive activities are permitted
    Example: "Activities permitted: Research, education, and eco-tourism."

  - `analysis.protected_areas.protected_area_details.regulation_names` (array)
    Names/titles of applicable regulations
    Example: ["DECRETO 622 DE MARZO 16 DE 1977","LEY 99 DE 1993"]

  - `analysis.protected_areas.protected_area_details.regulation_urls` (array)
    URLs linking to applicable regulations
    Example: ["https://old.parquesnacionales.gov.co/portal/wp-content/uploads/2018/07/Decreto_622_de_1977.pdf","https://www.minambiente.gov.co/wp-content/uploads/2021/08/ley-99-1993.pdf","https://www.funcionpublica.gov.co/eva/gestornormativo/norma.php"]

  - `analysis.protected_areas.protected_area_details.type` (string)
    Type/classification of the protected area
    Example: "Reserva Natural"

  - `analysis.protected_areas.sources` (array)
    Sources of protected area data

  - `analysis.deforestation` (object)
    Deforestation data for a plot

  - `analysis.deforestation.total_yearly` (object)
    Total yearly deforestation data

  - `analysis.deforestation.total_yearly_jrc` (object)
    Total yearly JRC deforestation data

  - `analysis.deforestation.total` (number)
    Total deforestation
    Example: 0.069

  - `analysis.deforestation.total_jrc` (number)
    Total JRC deforestation
    Example: 0.069

  - `analysis.deforestation_percentage` (number)
    Deforestation percentage
    Example: 0.044

  - `analysis.protectedAreas` (array)
    List of protected area names and their overlap areas in hectares
    Example: [["Área De Proteção Ambiental",0.24],["Rio Negro",156.13]]

  - `analysis.indigenous_overlap` (object)
    Indigenous territories overlap analysis

  - `analysis.indigenous_overlap.total_overlap_area` (number)
    Total area of overlap with indigenous territories in hectares
    Example: 150.5

  - `analysis.indigenous_overlap.overlapping_territories` (array)
    List of overlapping indigenous territories

  - `analysis.indigenous_overlap.overlap_percentage` (number)
    Percentage of overlap with indigenous territories
    Example: 25.5

  - `plot_id` (string)
    Unique identifier for the plot
    Example: "ef6f5727-377f-4e9d-abcb-74a8a6bf0366"

  - `plot_name` (string)
    Name of the plot
    Example: "East Field"

  - `geojson_features` (array)

  - `geojson_features.geometry` (any, required)
    Geometry object defining the spatial aspect of the feature, can be either Point or Polygon

  - `geojson_features.properties` (object)
    Additional properties for the feature as key-value pairs. Optional properties include point_ha (float < 4.0)
    Example: {"point_ha":3.5}

  - `geojson_features.type` (string, required)
    Type of the GeoJSON feature
    Example: "Feature"

  - `harvest_dates` (array)
    Example: ["2024-11-01"]

  - `commodity` (string)
    Type of commodity planted in the plot to do analysis on
    Enum: "wood", "soy", "cocoa", "coffee", "palm_oil", "beef", "rubber"

  - `lat` (string)
    Latitude of the plot's center
    Example: "34.052235"

  - `lon` (string)
    Longitude of the plot's center
    Example: "-118.243683"

  - `area_ha` (number)
    Area of the plot in hectares
    Example: 12.5

  - `tokens_cost` (integer)
    Cost of the analyzing the plot in tokens
    Example: 150

  - `created_at` (string)
    Timestamp of plot creation

  - `updated_at` (string)
    Timestamp of the last plot update

  - `analysis_image` (string)
    URL for the visualization of the analysis of the plot
    Example: "https://example.com/images/plot-analysis.jpg"

  - `additional_info` (object)
    Additional information about the plot as key-value pairs
    Example: {"soil_quality":"high","access":"restricted"}


## Response 400 fields

## Response 500 fields