Microsoft Azure Seasons API

The Seasons API from Microsoft Azure — 2 operation(s) for seasons.

Documentation GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /seasons List growing seasons · Microsoft Azure Get Seasons #

Ask an LLM

“Which crop seasons are defined in my agriculture data?”

“Can I filter seasons by year or start date range?”

Tell an agent

List seasons for years {years}.

List seasons starting between {minStartDateTime} and {maxStartDateTime}.

GET /seasons/{seasonId} Get a season · Microsoft Azure Get Seasons Seasonid #

Ask an LLM

“What start and end dates does a particular season have?”

“Where do I fetch one season resource by ID?”

Tell an agent

Get season {seasonId}.

Show the start and end dates of season {seasonId}.

PATCH /seasons/{seasonId} Create or update a season · Microsoft Azure Patch Seasons Seasonid #

Ask an LLM

“How do I define a new growing season with start and end dates?”

“Can I change the year or dates on an existing season?”

Tell an agent

Create season {seasonId} for year {year} from {startDateTime} to {endDateTime}.

Rename season {seasonId} to {name}.

DELETE /seasons/{seasonId} Delete a season · Microsoft Azure Delete Seasons Seasonid #

Ask an LLM

“Can I delete a season I created by mistake?”

“Can I remove a season resource by its ID?”

Tell an agent destructive · confirm first

Delete season {seasonId}.

Remove season resource {seasonId} permanently.

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/microsoft-azure:microsoft-azure-seasons-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Microsoft Azure Seasons API
  version: '1.0'
  description: 'Operations tagged Seasons across 2 of this provider''s published API definitions: azure-agfoodplatform-data-plane-service-openapi-original.yml, microsoft-azure-data-manager-for-agriculture-data-plane-service-openapi-original.yml. Each path carries the servers of the definition it was published in.'
security:
- Bearer: []
tags:
- name: Seasons
paths:
  /seasons:
    get:
      tags:
      - Seasons
      description: Returns a paginated list of season resources.
      operationId: microsoftAzureSeasonsList
      parameters:
      - in: query
        name: minStartDateTime
        description: 'Minimum season start datetime, sample format: yyyy-MM-ddTHH:mm:ssZ.'
        schema:
          type: string
          format: date-time
      - in: query
        name: maxStartDateTime
        description: 'Maximum season start datetime, sample format: yyyy-MM-ddTHH:mm:ssZ.'
        schema:
          type: string
          format: date-time
      - in: query
        name: minEndDateTime
        description: 'Minimum season end datetime, sample format: yyyy-MM-ddTHH:mm:ssZ.'
        schema:
          type: string
          format: date-time
      - in: query
        name: maxEndDateTime
        description: 'Maximum season end datetime, sample format: yyyy-MM-ddTHH:mm:ssZ.'
        schema:
          type: string
          format: date-time
      - in: query
        name: years
        description: Years of the resource.
        style: form
        explode: true
        schema:
          type: array
          items:
            format: int32
            type: integer
      - in: query
        name: ids
        description: Ids of the resource.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - in: query
        name: names
        description: Names of the resource.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - in: query
        name: propertyFilters
        description: 'Filters on key-value pairs within the Properties object.

          eg. "{testKey} eq {testValue}".'
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - in: query
        name: statuses
        description: Statuses of the resource.
        style: form
        explode: true
        schema:
          type: array
          items:
            type: string
      - in: query
        name: minCreatedDateTime
        description: Minimum creation date of resource (inclusive).
        schema:
          type: string
          format: date-time
      - in: query
        name: maxCreatedDateTime
        description: Maximum creation date of resource (inclusive).
        schema:
          type: string
          format: date-time
      - in: query
        name: minLastModifiedDateTime
        description: Minimum last modified date of resource (inclusive).
        schema:
          type: string
          format: date-time
      - in: query
        name: maxLastModifiedDateTime
        description: Maximum last modified date of resource (inclusive).
        schema:
          type: string
          format: date-time
      - in: query
        name: maxPageSize
        description: 'Maximum number of items needed (inclusive).

          Minimum = 10, Maximum = 1000, Default value = 50.'
        schema:
          type: integer
          format: int32
          default: 50
          maximum: 1000
          minimum: 10
      - in: query
        name: skipToken
        description: Skip token for getting next set of results.
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SeasonListResponse'
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-pageable:
        nextLinkName: nextLink
      x-ms-examples:
        Seasons_List:
          $ref: ./examples/Seasons_List.json
      summary: Microsoft Azure Get Seasons
  /seasons/{seasonId}:
    get:
      tags:
      - Seasons
      description: Gets a specified season resource.
      operationId: microsoftAzureSeasonsGet
      parameters:
      - in: path
        name: seasonId
        description: Id of the season.
        required: true
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Season'
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Seasons_Get:
          $ref: ./examples/Seasons_Get.json
      summary: Microsoft Azure Get Seasons Seasonid
    patch:
      tags:
      - Seasons
      description: Creates or updates a season resource.
      operationId: microsoftAzureSeasonsCreateorupdate
      parameters:
      - in: path
        name: seasonId
        description: Id of the season resource.
        required: true
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Season'
        '201':
          description: Created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Season'
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Seasons_CreateOrUpdate:
          $ref: ./examples/Seasons_CreateOrUpdate.json
      summary: Microsoft Azure Patch Seasons Seasonid
      requestBody:
        content:
          application/merge-patch+json:
            schema:
              $ref: '#/components/schemas/Season'
        description: Season resource payload to create or update.
        required: true
    delete:
      tags:
      - Seasons
      description: Deletes a specified season resource.
      operationId: microsoftAzureSeasonsDelete
      parameters:
      - in: path
        name: seasonId
        description: Id of the season.
        required: true
        schema:
          type: string
      - in: query
        name: api-version
        description: The requested API version
        required: true
        schema:
          type: string
      responses:
        '204':
          description: No Content
        default:
          description: Error
          headers:
            x-ms-error-code:
              x-ms-client-name: ErrorCode
              schema:
                type: string
          x-ms-error-response: true
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      x-ms-examples:
        Seasons_Delete:
          $ref: ./examples/Seasons_Delete.json
      summary: Microsoft Azure Delete Seasons Seasonid
components:
  schemas:
    Season:
      description: Schema of season resource.
      type: object
      properties:
        startDateTime:
          format: date-time
          description: 'Season start datetime, sample format: yyyy-MM-ddTHH:mm:ssZ.'
          type: string
        endDateTime:
          format: date-time
          description: 'Season end datetime, sample format: yyyy-MM-ddTHH:mm:ssZ.'
          type: string
        year:
          format: int32
          description: Season year.
          type: integer
        geographicIdentifier:
          description: Geographic Identifier.
          type: string
        id:
          description: Unique resource ID.
          type: string
          readOnly: true
        eTag:
          description: The ETag value to implement optimistic concurrency.
          type: string
          readOnly: true
        status:
          description: Status of the resource.
          maxLength: 100
          minLength: 0
          type: string
        createdDateTime:
          format: date-time
          description: 'Date-time when resource was created, sample format: yyyy-MM-ddTHH:mm:ssZ.'
          type: string
          readOnly: true
          example: '2020-12-31T11:10:21Z'
        modifiedDateTime:
          format: date-time
          description: 'Date-time when resource was last modified, sample format: yyyy-MM-ddTHH:mm:ssZ.'
          type: string
          readOnly: true
          example: '2020-12-31T11:10:21Z'
        source:
          description: Source of the resource.
          maxLength: 100
          minLength: 2
          type: string
        name:
          description: Name to identify resource.
          maxLength: 100
          minLength: 0
          type: string
        description:
          description: Textual description of the resource.
          maxLength: 500
          minLength: 0
          type: string
        createdBy:
          description: Created by user/tenant id.
          type: string
          readOnly: true
        modifiedBy:
          description: Modified by user/tenant id.
          type: string
          readOnly: true
        properties:
          description: 'A collection of key value pairs that belongs to the resource.

            Each pair must not have a key greater than 50 characters

            and must not have a value greater than 150 characters.

            Note: A maximum of 25 key value pairs can be provided for a resource and only string,

            numeral and datetime (yyyy-MM-ddTHH:mm:ssZ) values are supported.'
          type: object
          additionalProperties: {}
          example:
            key1: value1
            key2: 123.45
    Error:
      description: An error from the Azure AgPlatform service.
      required:
      - code
      - message
      type: object
      properties:
        code:
          description: Server-defined set of error codes.
          minLength: 1
          type: string
        message:
          description: Human-readable representation of the error.
          minLength: 1
          type: string
        target:
          description: Target of the error.
          type: string
        details:
          description: Array of details about specific errors that led to this reported error.
          type: array
          items:
            $ref: '#/components/schemas/Error'
        innererror:
          $ref: '#/components/schemas/InnerError'
    InnerError:
      description: Inner error containing list of errors.See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object for InnerError reference document.
      type: object
      properties:
        code:
          description: Specific error code than was provided by the containing error.
          type: string
        innererror:
          $ref: '#/components/schemas/InnerError'
    ErrorResponse:
      description: An error response from the Azure AgPlatform service. See https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses for ErrorResponse reference document.
      type: object
      properties:
        error:
          $ref: '#/components/schemas/Error'
        traceId:
          description: Unique trace Id.
          type: string
    SeasonListResponse:
      description: Paged response contains list of requested objects and a URL link to get the next set of results.
      required:
      - value
      type: object
      properties:
        value:
          description: List of requested objects.
          type: array
          items:
            $ref: '#/components/schemas/Season'
        skipToken:
          description: Token used in retrieving the next page. If null, there are no additional pages.
          type: string
        nextLink:
          description: Continuation link (absolute URI) to the next page of results in the list.
          type: string
  securitySchemes:
    Bearer:
      type: apiKey
      name: Authorization
      in: header
      description: Please provide a valid bearer token for authorized API calls. Note that you might need to clear your browser cache if you tried un-authenticated calls before.
x-refined-from:
- azure-agfoodplatform-data-plane-service-openapi-original.yml
- microsoft-azure-data-manager-for-agriculture-data-plane-service-openapi-original.yml
x-ms-parameterized-host:
  hostTemplate: '{endpoint}'
  useSchemePrefix: false
  parameters:
  - $ref: '#/components/parameters/Endpoint'

Microsoft Azure Seasons API

Operations 4

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification