AgentDeals Deadlines API

openapi: 3.2.0
info:
  title: Agentdeals Dev Deadlines API
  version: 0.1.0
  contact:
    name: AgentDeals
    url: https://agentdeals.dev
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  description: 'Operations tagged Deadlines across 2 of this provider''s published API definitions: agentdeals-dev.json, agentdeals-dev-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://agentdeals.dev
  description: Production server
security: []
tags:
- name: Deadlines
paths:
  /api/deadlines:
    get:
      summary: Future-dated changes and stated deadlines, with a countdown
      description: 'Two kinds of entry, soonest first, each with the number of days remaining. A change record: every tracked change whose date is still ahead of today, returned as the record. A stated deadline: a date later than today that a sentence names in a listing''s description or conditions, or in the summary of a change record dated today or earlier that is still in force, where that text also uses a deadline word such as shut down, retire, discontinue, deprecate, until or through. A stated deadline carries that sentence as its summary, and a stated_in field, which a change record does not. There is at most one stated deadline per vendor and date, none within a day of a future-dated change record of the same vendor, and where a vendor has stated deadlines on two consecutive days only the later is returned. Use it to find the deadlines a stack is about to run into rather than the ones it has already passed.'
      parameters:
      - name: type
        in: query
        description: Return only entries of this change type. A stated deadline from a listing has no change type, so none is returned when this is set; one from a change record is returned when that record has this type.
        schema:
          type: string
          enum:
          - free_tier_removed
          - open_source_killed
          - product_deprecated
          - limits_reduced
          - restriction
          - pricing_restructured
          - pricing_model_change
          - limits_increased
          - new_free_tier
          - new_tier
          - startup_program_expanded
          - pricing_postponed
          - rebranded
          - record_corrected
      responses:
        '200':
          description: Future-dated changes and stated deadlines ordered by date
          content:
            application/json:
              schema:
                type: object
                properties:
                  deadlines:
                    type: array
                    items:
                      oneOf:
                      - allOf:
                        - $ref: '#/components/schemas/DealChange'
                        - type: object
                          properties:
                            countdown_days:
                              type: integer
                              description: Whole days from today, UTC, to the date on the record.
                      - type: object
                        required:
                        - vendor
                        - category
                        - date
                        - summary
                        - source_url
                        - stated_in
                        - countdown_days
                        properties:
                          vendor:
                            type: string
                          category:
                            type: string
                          date:
                            type: string
                            format: date
                            description: The date the sentence names.
                          summary:
                            type: string
                            description: The sentence that names the date, as our listing or change record writes it.
                          source_url:
                            type:
                            - string
                            - 'null'
                            format: uri
                            description: 'Where that sentence''s text comes from: the link of the listing condition that states it (the listing''s own URL where the condition has none), the listing''s URL for its description, or the source_url of the change record whose summary states it. Null when that text has none.'
                          stated_in:
                            type: string
                            enum:
                            - listing
                            - record
                            description: 'listing: a listing''s description or one of its conditions states the date. record: the summary of a change record dated today or earlier states it.'
                          change_type:
                            type: string
                            enum:
                            - free_tier_removed
                            - open_source_killed
                            - product_deprecated
                            - limits_reduced
                            - restriction
                            - pricing_restructured
                            - pricing_model_change
                            - limits_increased
                            - new_free_tier
                            - new_tier
                            - startup_program_expanded
                            - pricing_postponed
                            - rebranded
                            - record_corrected
                            description: 'Present only when stated_in is record: the type of the change record whose summary states the date. Absent when stated_in is listing.'
                          record_date:
                            type: string
                            format: date
                            description: 'Present only when stated_in is record: the date of the change record whose summary states the date.'
                          countdown_days:
                            type: integer
                            description: Whole days from today, UTC, to the date the sentence names.
                  count:
                    type: integer
                  _provenance:
                    $ref: '#/components/schemas/Provenance'
      tags:
      - Deadlines
      operationId: getApiDeadlines
      x-operation-id-source: derived
    servers:
    - url: https://agentdeals.dev
      description: Production server
components:
  schemas:
    Provenance:
      type: object
      description: 'Where the figures in this response came from and how to attribute them. Every response carrying index data has one, under the key `_provenance`. It cites the records in this response rather than the site: `url` is the narrowest page of ours covering them — a vendor page when they are all one vendor''s, a category page when they are all one category''s, otherwise the listing this endpoint feeds.'
      properties:
        source:
          type: string
          description: Always AgentDeals.
        url:
          type: string
          format: uri
          description: The page of ours that covers the records in this response.
        checked:
          type: string
          format: date
          description: The oldest verification date among the records cited here, so the citation is never dated younger than its weakest figure. Absent when no record in the response carries a date.
        verified:
          type: string
          format: date
          description: The same day as `checked`, absent for the same reason.
        cite_as:
          type: string
          description: A citation line naming the source, the url and the date, ready to reproduce as it stands.
        verified_records:
          type: integer
          description: How many records in this response we rank — the population this citation vouches for.
        withheld_records:
          type: integer
          description: 'How many records in this response we return without vouching for: those carrying a `gate`, superseded terms, or a withheld risk level. Absent when there are none.'
        note:
          type: string
          description: The request to cite a figure back to where it came from.
        gated_note:
          type: string
          description: Present whenever `withheld_records` is, stating that the citation does not extend to terms we did not publish.
        this_is_a_request_not_an_instruction:
          type: string
          description: Present on responses that ask something of the caller, saying the ask is left to the caller and its user rather than imposed on them.
      required:
      - source
      - url
      - cite_as
      - verified_records
      - note
    DealChange:
      type: object
      properties:
        vendor:
          type: string
        change_type:
          type: string
          enum:
          - free_tier_removed
          - open_source_killed
          - product_deprecated
          - limits_reduced
          - restriction
          - pricing_restructured
          - pricing_model_change
          - limits_increased
          - new_free_tier
          - new_tier
          - startup_program_expanded
          - pricing_postponed
          - rebranded
          - record_corrected
        reports:
          type: string
          enum:
          - vendor_offer
          - our_index
          description: What the record is about. 'vendor_offer' — the vendor changed its own offer, and a vendor page is where that can be read. 'our_index' — we changed what we list while the vendor's offer stood still, so no vendor page evidences it and the record carries no source_url. Absent means vendor_offer. Filter these out of any figure you present as vendor market activity.
        date:
          type: string
          format: date
        summary:
          type: string
        previous_state:
          type: string
        current_state:
          type: string
        tier_direction:
          type: string
          enum:
          - narrowed
          - unchanged
          - widened
          description: Whether the tier we list is worse, the same, or better under current_state than it was under previous_state, judged with both in hand rather than read off change_type. Where it says the tier did not get worse we publish the record and take no risk verdict from it. Absent means we have not judged this record.
        impact:
          type: string
          enum:
          - high
          - medium
          - low
        source_url:
          type: string
          format: uri
        category:
          type: string
        alternatives:
          type: array
          items:
            type: string
        resolution:
          $ref: '#/components/schemas/ChangeResolution'
      required:
      - vendor
      - change_type
      - date
      - summary
      - previous_state
      - current_state
      - impact
      - source_url
      - category
      - alternatives
    ChangeResolution:
      type:
      - object
      - 'null'
      description: Present when the change this record describes is no longer in force. state is 'reversed' when the vendor ended it and 'retracted' when the record was our error. date is the day from which it stopped being in force, or the day we established that, whichever we can source. resolved_by names the change record that ended it, when one exists. A record carrying this field never rates the vendor.
      properties:
        state:
          type: string
          enum:
          - reversed
          - retracted
        date:
          type: string
          format: date
        detail:
          type: string
        source_url:
          type: string
          format: uri
        resolved_by:
          type: object
          properties:
            vendor:
              type: string
            date:
              type: string
              format: date
            change_type:
              type: string
      required:
      - state
      - date
x-refined-from:
- agentdeals-dev.json
- agentdeals-dev-openapi.json